PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input — Nimmt eine Variable von Außen entgegen und filtert sie optional
type
Eine der 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() verwendet werden.
var_name
Der Name einer Variablen, die innerhalb der Superglobalen des
betreffenden type gefiltert werden soll.
filter
Der anzuwendende Filter.
Dies kann entweder ein Validierungsfilter sein, indem eine der
FILTER_VALIDATE_*-Konstanten
verwendet wird, ein Bereinigungsfilter, indem eine der
FILTER_SANITIZE_*-Konstanten
verwendet wird, der Fiter FILTER_UNSAFE_RAW oder ein
benutzerdefinierter Filter durch Verwendung von
FILTER_CALLBACK.
Hinweis:
Die Voreinstellung ist
FILTER_DEFAULT, was ein Alias vonFILTER_UNSAFE_RAWist. Dies bedeutet, dass standardmäßig keine Filterung stattfindet.
options
Entweder ein assoziatives array von Optionen oder eine
Bitmaske der Filterflag-Konstanten
FILTER_FLAG_*.
Wenn filter Optionen akzeptiert, können die Flags
durch Verwendung des Array-Schlüssels "flags"
angegeben werden.
Wert der angeforderten Variable bei Erfolg,
false, wenn der Filter fehlschlägt,
oder null, wenn die Variable var_name nicht gesetzt ist.
Wird das Flag FILTER_NULL_ON_FAILURE verwendet,
wird false zurückgegeben, wenn die Variable nicht gesetzt ist,
und null, wenn der Filter fehlschlägt.
Beispiel #1 filter_input()-Beispiel
<?php
$search_html = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
$search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
echo "Sie haben nach $search_html gesucht.\n";
echo "<a href='?search=$search_url'>Erneut suchen.</a>";
?>Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Sie haben nach Ich & Sohn gesucht. <a href='?search=Ich%20%26%20Sohn'>Erneut suchen.</a>
FILTER_VALIDATE_*
FILTER_SANITIZE_*
