Funkcja PHP filter_input()

Definicja i użycie

Funkcja filter_input() pobiera dane wejściowe z zewnętrznego skryptu i przefiltrowuje je.

Ta funkcja jest używana do weryfikacji zmiennych pochodzących z niebezpiecznych źródeł, takich jak wejścia użytkownika.

Ta funkcja może uzyskać dane wejściowe z różnych źródeł:

  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_ENV
  • INPUT_SERVER
  • INPUT_SESSION (Nie zaimplementowane)
  • INPUT_REQUEST (Nie zaimplementowane)

Jeśli sukces, zwraca przetworzone dane, jeśli nie powiodło się, zwraca false, jeśli zmienna Jeśli parametr nie jest ustawiony, zwraca NULL.

Gramatyka

filter_input(input_type, zmienna, filter, opcje)
Parametry Opis
input_type Wymagane. Określ typ wejścia. Zobacz powyższą listę możliwych typów.
zmienna Określ zmienną do filtrowania.
filter

Opcjonalnie. Określ ID filtra do użycia. Domyślnie jest FILTER_SANITIZE_STRING.

Zobacz pełny podręcznik funkcji filtrujących PHP, aby uzyskać możliwe filtry.

ID filtra może być nazwą ID (np. FILTER_VALIDATE_EMAIL) lub numerem ID (np. 274).

opcje Określ tablicę zawierającą znaki/opcje. Sprawdź wszystkie możliwe znaki i opcje dla każdego filtra.

Przykład

W tym przykładzie używamy funkcji filter_input() do filtrowania zmiennej POST. Przyjęta zmienna POST to poprawny adres e-mail.

<?php
if (!filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL))
 {
 echo "E-Mail nie jest poprawny";
 }
else
 {
 echo "E-Mail jest poprawny";
 }
?>

Wyprowadzenie podobne do:

E-Mail jest poprawny