filter_input_array

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

filter_input_arrayNimmt mehrere Variablen von Außen entgegen und filtert sie optional

Beschreibung

filter_input_array(int $type, array|int $options = FILTER_DEFAULT, bool $add_empty = true): array|false|null

Diese Funktion ist nützlich, um mehrere Werte abzufragen ohne wiederholend filter_input() aufrufen zu müssen.

Parameter-Liste

type
Eine der INPUT_*-Konstanten.
Warnung

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
Entweder ein assoziatives array von Optionen oder der Filter, der auf jeden Eintrag angewendet werden soll. Dies kann entweder ein Validierungsfilter sein, der eine der 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.

Rückgabewerte

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.

Anmerkungen

Hinweis:

Es gibt keinen REQUEST_TIME-Key im Array INPUT_SERVER, weil dieser erst später in $_SERVER eingefügt wird.

Siehe auch