# filter_input

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

filter_input — Nimmt eine Variable von Außen entgegen und filtert sie optional

### Beschreibung

filter_input(
int `$type`,
string `$var_name`,
int `$filter` = `FILTER_DEFAULT`,
array|int `$options` = 0
): mixed

### 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() 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 von `FILTER_UNSAFE_RAW` ist. 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.

### Rückgabewerte

Bei Erfolg wird die gefilterte Variable zurückgegeben. Wenn die Variable nicht gesetzt ist, wird `false` zurückgegeben. Im Fehlerfall wird `false` zurückgegeben, es sei denn, das Flag `FILTER_NULL_ON_FAILURE` wird verwendet; in diesem Fall wird `null` zurückgegeben.

### Beispiele

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 &#38 Sohn gesucht.
    <a href='?search=Ich%20%26%20Sohn'>Erneut suchen.</a>

### Siehe auch

- filter_input_array() - Nimmt mehrere Variablen von Außen entgegen und filtert sie optional
- filter_var() - Filtert eine Variable mit einem angegebenen Filter
- filter_var_array() - Nimmt mehrere Variablen entgegen und filtert sie optional
- Validierungsfilter `FILTER_VALIDATE_*`
- Bereinigungsfilter `FILTER_SANITIZE_*`

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open