Joomla! Programmierung/Framework/JURI/setQuery

JURI/setQuery Setzt den query Teil der URI im JURI Objekt.

Syntax

setQuery( $query )

• @return void
• @since

Parameter	Datentyp	Beschreibung	Standardwert
$query	string oder array	Der Query der zur URI hinzugefügt werden soll. Bereits vorhandene Einträge werden überschrieben. Wird ein String übergeben können sowohl "&" als auch "&" als Trennzeichen für den Query genutzt werden.

Beispiel 1

In diesem Beispiel wird ein URI Objekt erstellt und der Query mit dem übergebenen String ersetzt.

$uri = 'http://fredbloggs:itsasecret@www.example.com:8080/path/to/Joomla/index.php?task=view&id=32#anchorthis';
$u =& JURI::getInstance( $uri );
echo 'Vorher : '.$u->toString();
 
$u->setQuery( 'task=save&id=17' );
echo 'Nachher: '.$u->toString();

Ausgabe

Vorher : http://fredbloggs:itsasecret@www.example.com:8080/path/to/Joomla/index.php?task=view&id=32#anchorthis
Nachher: http://fredbloggs:itsasecret@www.example.com:8080/path/to/Joomla/index.php?task=save&id=17#anchorthis

Beispiel 2

In diesem Beispiel wird ein URI Objekt erstellt und der Query mit dem übergebenen Array bestehend aus Queryelementen ersetzt.

$uri = 'http://fredbloggs:itsasecret@www.example.com:8080/path/to/Joomla/index.php?task=view&id=32#anchorthis';
$u =& JURI::getInstance( $uri );
echo 'Vorher : '.$u->toString();
 
$query = array( 'task' => 'log',
                'id'   => 128,
                'act'  => 'redirect'
              );
$u->setQuery( $query );
echo 'Nachher: '.$u->toString();

Ausgabe

Vorher : http://fredbloggs:itsasecret@www.example.com:8080/path/to/Joomla/index.php?task=view&id=32#anchorthat
Nachher: http://fredbloggs:itsasecret@www.example.com:8080/path/to/Joomla/index.php?task=log&id=128&act=redirect#anchorthat

Siehe auch

• JURI->setQuery() auf api.joomla.org
• JURI->getQuery()
• JURI->buildQuery()

Quellcode

 libraries

•  joomla
  •  environment
    •  uri.php

public function setQuery($query)
{
   if (is_array($query))
   {
      $this->_vars = $query;
   }
   else
   {
      if (strpos($query, '&') !== false)
      {
         $query = str_replace('&', '&', $query);
      }
      parse_str($query, $this->_vars);
   }
 
   // Empty the query
   $this->_query = null;
}