variablenHandler

Die Klasse variablenHandler wurde in der Version 1.10 aus dem Release des Adventure PHP Framework (APF) entfernt. Bitte nutzen Sie statt dessen die Klasse RequestHandler!
Die Klasse variablenHandler wird verwendet, um Variablen aus dem REQUEST lokal zu registrieren. Hierbei können Standard-Werte zugewiesen werden um den Ablauf eines Programms sicherer und deterministischer zu gestalten. Dies ist insbesondere bei Checkbox-Feldern oder anderen Ablaufsteuerungsvariablen sinnvoll. Der variablenHandler greift dabei auf das Superglobalarray $_REQUEST zu und extrahiert die dort enthaltenen Offsets in ein lokal verwendetes Array. Üblicherweise wird dabei die Variable $_LOCALS verwendet um zu kennzeichnen, dass der Inhalt mit dem variablenHandler erstellt wurde und nicht dem globalen Array entspricht. Das folgende Beispiel zeigt, wie die Werte für "Action" und "Subaction" in das Array $_LOCALS extrahiert und "Action" mit einem Standard-Wert von "none" vorbelegt wird, falls es nicht im Request enthalten war:
PHP-Code
$_LOCALS = variablenHandler::registerLocal(array( 'Action' => 'none', 'Subaction' => 'none' ) );
Mit der Verwendung des Variablen-Handlers ist immer sichergestellt, dass die lokal registrierten Variablen verfügbar sind. Eine Prüfung wie
PHP-Code
if(isset($_REQUEST['Action'])){ // ... // }
entfällt dadurch vollständig. Zur Verwendung der Komponente muss die Klasse per
PHP-Code
import('tools::variablen','variablenHandler');
vor der Verwendung eingebunden werden.