Differences

This shows you the differences between two versions of the page.

--- de:entwickler:uebergabevariablen_pruefen [2011/06/04 17:13] – fasse
+++ de:entwickler:uebergabevariablen_pruefen [2012/05/12 01:09] (current) – [Funktion admFuncVariableIsValid] thomas-rcv
@@ Line 10: / Line 10: @@
 ''Datei:'' **adm_program/system/function.php**\\
 ''Version:'' **2.3**
-==== Beschreibung ====
+=== Beschreibung ===
 Die Funktion prüft aus einem Array eine Variable auf plausible Werte. Die Prüfung kann über weitere Parameter verfeinert werden.
 <code php>value admFuncVariableIsValid($array, $variableName, $type, $defaultValue = null,
-                             $requireValue = false, $validValues = null)</code>
+                             $requireValue = false, $validValues = null, $directOutput = false)</code>
-==== Parameter ====
+=== Parameter ===
   * **array** das Array (z.B. $_GET oder $_POST), welches die zu prüfende Variable enthält
   * **variableName** Name der Variable aus dem //array// welche geprüft werden soll
-  * **type** Typ der Variable ''numeric'', ''string'', ''boolean''. Je nach Typ werden unterschiedliche Prüfungen auf den Wert der Variable gemacht und ggf. ein Hinweis ausgegeben, wenn die Variable nicht dem Typ entspricht
+  * **type** Typ der Variable ''numeric'', ''string'', ''boolean'' und ''file''. Je nach Typ werden unterschiedliche Prüfungen auf den Wert der Variable gemacht und ggf. ein Hinweis ausgegeben, wenn die Variable nicht dem Typ entspricht
   * **defaultValue** Wurde kein Wert für die Variable dem Script übergeben, wird die Variable mit diesem Wert initialisiert
   * **requireValue** Ist dies auf //true// gesetzt, so wird ein Hinweis ausgegeben, wenn der Variablen kein Wert übergeben wurde
   * **validValues** ein Array mit gültigen Werten für die Variable. Ist der übergebene Wert nicht in diesem Array enthalten wird ein Hinweis ausgegeben
-==== Rückgabe ====
+  * **directOutput** Ist dieser Wert auf //true// gesetzt, so wird eine Fehlermeldung nicht als HTML-Seite zurückgegeben, sondern der Fehlertext direkt unformatiert per **echo** ausgegeben
+=== Rückgabe ===
 Zurückgegeben wird der Wert der Variable. Bei Texten wird hier noch zusätzlich die Funktion strip_tags durchgeführt, die HTML-Tags entfernt.
-==== Beispiele ====
+=== Beispiele ===
 <code php>// Zahl, welche ggf. mit 0 initialisiert wird
 $get_dat_id = admFuncVariableIsValid($_GET, 'dat_id', 'numeric', 0);
 // Text, der ggf. mit DAT_DATES initialisiert wird
-$get_headline = admFuncVariableIsValid($_GET, 'headline', 'string', $g_l10n->get('DAT_DATES'));
+$get_headline = admFuncVariableIsValid($_GET, 'headline', 'string', $gL10n->get('DAT_DATES'));
 // Text, der ggf. mit 'actual' initialisiert wird und nur die Werte 'actual' und 'old' enthalten darf
 $get_mode = admFuncVariableIsValid($_GET, 'mode', 'string', 'actual', false, array('actual', 'old'));</code>