filter_var

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

    filter_var — Filtert eine Variable mit einem angegebenen Filter

    Beschreibung

    filter_var(mixed$value, int$filter = FILTER_DEFAULT, array|int$options = 0): mixed

    Parameter-Liste

    value

    Der Wert, der gefiltert werden soll. Es ist zu beachten, dass skalare Werte vor dem Filtern intern nach String konvertiert werden.

    filter

    Die ID des anzuwendenden Filters. Die Handbuchseite Filtertypen zeigt die verfügbaren Filter auf.

    Falls dieser Parameter ausgelassen wird, so wird FILTER_DEFAULT verwendet, was zu FILTER_UNSAFE_RAW äquivalent ist. Dies wird dazu führen, dass keine Filterung stattfindet.

    options

    Ein assoziatives Array mit Optionen oder eine bitweise Disjunktion von Flags. Wenn der Filter Optionen akzeptiert, können Flags im "flags" Feld des Arrays angegeben werden. Für "callback" Filter sollte der callback-Typ angegeben werden. Der Callback muss den zu filternden Wert als einziges Argument akzeptieren und den gefilterten/bereinigten Wert zurückgeben.

    <?php
    // für Filter, die Optionen zulassen, verwenden Sie dieses Format
    $options = array(
    'options' => array(
    'default' => 3, // Rückgabewert, falls der Filter fehlschlägt

    Rückgabewerte

    Gibt die gefilterten Daten zurück oder false wenn fehlgeschlagen.

    Beispiele

    Beispiel #1 filter_var()-Beispiel

    <?php
    var_dump    (filter_var('bob@example.com', FILTER_VALIDATE_EMAIL));
    var_dump(filter_var('http://example.com', FILTER_VALIDATE_URL, FILTER_FLAG_PATH_REQUIRED));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    string(15) "bob@example.com" bool(false)

    Beispiel #2 Beispiel für das Filtern eines Arrays

    <?php
    $emails     = [
    "bob@example.com",
    "test@example.local",
    "invalidemail"
    ];

    var_dump(filter_var($emails, FILTER_VALIDATE_EMAIL, FILTER_REQUIRE_ARRAY));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    array(3) { [0]=> string(15) "bob@example.com" [1]=> string(18) "test@example.local" [2]=> bool(false) }

    Siehe auch

    To Top