Joomla! Programmierung/Framework/JRequest/setVar

Beschreibung

JRequest/setVar speichert einen Wert in eine entsprechende "Request" Variable.

Syntax

static setVar( $name, [$value], [$hash], [$overwrite] )

• @return string Der zuvor enthaltene Wert.
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$name	string	Der Name der Variable, die gespeichert werden soll.
$value	string	Der Wert, den die Variable erhalten soll.
$hash	string	Array, in das gespeichert werden soll.	method
$override	boolean	Wenn true und ein Schlüssel existiert schon, wird der Wert überschrieben, anderenfalls nicht.	true

Beispiele

Variable Filtern

JRequest::set('key1', 'value1', 'post');
 
$post = JRequest::get('post');
 
echo '<pre>'.print_r($post, true).'</pre>';

Die Ausgabe lautet:

Array
(
    [key1] => value1
)

Quellcode

 libraries

•  joomla
  •  environment
    •  request.php

public static function setVar($name, $value = null, $hash = 'method', $overwrite = true)
{
   // If overwrite is true, makes sure the variable hasn't been set yet
   if (!$overwrite && array_key_exists($name, $_REQUEST))
   {
      return $_REQUEST[$name];
   }
 
   // Clean global request var
   $GLOBALS['_JREQUEST'][$name] = array();
 
   // Get the request hash value
   $hash = strtoupper($hash);
   if ($hash === 'METHOD')
   {
      $hash = strtoupper($_SERVER['REQUEST_METHOD']);
   }
 
   $previous = array_key_exists($name, $_REQUEST) ? $_REQUEST[$name] : null;
 
   switch ($hash)
   {
      case 'GET':
         $_GET[$name] = $value;
         $_REQUEST[$name] = $value;
         break;
      case 'POST':
         $_POST[$name] = $value;
         $_REQUEST[$name] = $value;
         break;
      case 'COOKIE':
         $_COOKIE[$name] = $value;
         $_REQUEST[$name] = $value;
         break;
      case 'FILES':
         $_FILES[$name] = $value;
         break;
      case 'ENV':
         $_ENV['name'] = $value;
         break;
      case 'SERVER':
         $_SERVER['name'] = $value;
         break;
   }
 
   // Mark this variable as 'SET'
   $GLOBALS['_JREQUEST'][$name]['SET.' . $hash] = true;
   $GLOBALS['_JREQUEST'][$name]['SET.REQUEST'] = true;
 
   return $previous;
}

Siehe auch

• JRequest->setVar() auf api.joomla.org