(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input_array — Nimmt mehrere Variablen von Außen entgegen und filtert sie optional
$type
, array|int $options
= FILTER_DEFAULT
, bool $add_empty
= true
): array|false|nullDiese Funktion ist nützlich, um mehrere Werte abzufragen ohne wiederholend filter_input() aufrufen zu müssen.
type
INPUT_*
-Konstanten.
Der Inhalt der zu filternden Superglobalen ist der ursprüngliche "rohe" Inhalt, der von der SAPI bereitgestellt wird, d. h. bevor die Superglobale verändert wurde. Um eine geänderte Superglobale zu filtern, sollte stattdessen filter_var_array() verwendet werden.
options
FILTER_VALIDATE_*
-Konstanten
verwendet, oder ein Bereinigungsfilter, der eine der
FILTER_SANITIZE_*
-Konstanten
verwendet.
Das Options-Array ist ein assoziatives Array, bei dem der Schlüssel einem
Schlüssel im Daten-Array
entspricht und der
zugehörige Wert entweder der Filter ist, der auf diesen Eintrag
angewendet werden soll, oder ein assoziatives Array, das beschreibt, wie
und welcher Filter auf diesen Eintrag angewendet werden soll.
Das assoziative Array, das beschreibt, wie ein Filter anzuwenden ist,
muss den Schlüssel 'filter'
enthalten, dessen
zugehöriger Wert der anzuwendende Filter ist, der eine der Konstanten
FILTER_VALIDATE_*
,
FILTER_SANITIZE_*
,
FILTER_UNSAFE_RAW
oder
FILTER_CALLBACK
sein kann.
Es kann optional den Schlüssel 'flags'
enthalten, der
alle für den Filter geltenden Flags angibt, und den Schlüssel
'options'
, der alle für den Filter geltenden Optionen
angibt.
add_empty
Nicht vorhandene Schlüssel als null
zum Rückgabewert hinzufügen.
Gibt bei Erfolg ein Array mit den Werten der angeforderten Variablen aus.
Im Fehlerfall wird false
zurückgegeben, es sei denn, der Fehler besteht
darin, dass das durch type
bezeichnete Eingabe-Array
nicht gefüllt ist. In diesem Fall wird null
zurückgegeben, wenn das Flag
FILTER_NULL_ON_FAILURE
verwendet wird.
Wenn add_empty
true
ist, werden fehlende Einträge
aus dem Eingabe-Array in das zurückgegebene Array eingefügt.
In diesem Fall werden fehlende Einträge auf null
gesetzt, es sei denn, das
Flag FILTER_NULL_ON_FAILURE
wird verwendet, in diesem
Fall ist es false
.
Ein Eintrag des zurückgegebenen Array wird auf false
gesetzt, wenn der
Filter fehlschlägt, es sei denn, das Flag
FILTER_NULL_ON_FAILURE
wird verwendet; in diesem Fall
wird er auf null
gesetzt.
Hinweis:
Es gibt keinen
REQUEST_TIME
-Key im ArrayINPUT_SERVER
, weil dieser erst später in $_SERVER eingefügt wird.
FILTER_VALIDATE_*
FILTER_SANITIZE_*