(:redirect 'http://docs.studip.de/develop/Entwickler/Request':)

Benutzung der Klasse Request

(:toc:)

Allgemeines

Blah blub …

Methoden der Klasse Request

• getInstance()
  Liefert die Singleton-Instanz der Request-Klasse. Über dieses Objekt kann man direkt mit Array-Notation auf die aktuellen Request-Parameter zufreifen:

$request = Request::getInstance();

$user = $request['user'];
$mode = $request['mode'];

foreach ($request as $key => $value) {
    [...]
}

• url()
• protocol()
• server()
• path()
  Diese Methoden dienen zum vereinfachten Zugriff auf Teile der URL des aktuellen HTTP-Requests. Die Methode url() liefert die komplette URL dar aktuellen Seite, die anderen Methoden nur einzelne Teile davon.
• set($param, $value)
  Setzt einen Request-Parameter auf einen definierten Wert. Eigentlich sollte man das möglichst nicht tun, es gibt aber Stellen in Stud.IP, die mitten in der Skriptausführung eine geänderte Request-Umgebung simulieren wollen. Solche Fälle kann man mit dieser Funktion abhandeln.
• get($param, $default = NULL)
• quoted($param, $default = NULL)
• option($param, $default = NULL)
• int($param, $default = NULL)
• float($param, $default = NULL)
  Diese Methoden dienen zum typsicheren Zugriff auf Request-Parameter, die skalare Werte enthalten. Falls es keinen Parameter mit dem angegeben Namen gibt, wird der Wert NULL zurückgeliefert bzw. der übergebene Vorgabewert, wenn dieser beim Aufruf angegeben wurde.
• getArray($param)
• quotedArray($param)
• optionArray($param)
• intArray($param)
• floatArray($param)
  Diese Methoden dienen zum typsicheren Zugriff auf Request-Parameter, die ein Array als Wert enthalten. Falls es keinen Parameter mit dem angegeben Namen gibt, wird jeweils ein leeres Array zurückgeliefert.
• submitted($param)
  Testet, ob ein Formular-Button mit dem übergebenen Namen angeklickt wurde.
• addslashes($value)
• removeMagicQuotes($value)
  Hilfsfunktionen zum Umgang mit magic_quotes_gpc. Normalerweise sollte es nicht notwendig sein, diese Funktionen selbst aufzurufen.

[to be continued]