Función filter_input() de PHP

Definición y uso

La función filter_input() obtiene entrada desde fuera del script y la filtra.

Esta función se utiliza para verificar variables provenientes de fuentes no seguras, como la entrada del usuario.

Esta función puede obtener entradas de diversas fuentes:

  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_ENV
  • INPUT_SERVER
  • INPUT_SESSION (No implementado aún)
  • INPUT_REQUEST (No implementado aún)

Si tiene éxito, devuelve los datos filtrados, si falla, devuelve false, si variable Si no se establecen los parámetros, se devuelve NULL.

Sintaxis

filter_input(input_type, variable, filter, opciones)
Parámetros Descripción
input_type Obligatorio. Especificar el tipo de entrada. Ver la lista de posibles tipos en la parte superior.
variable Especificar la variable a filtrar.
filter

Opcional. Especificar el ID del filtro a usar. El predeterminado es FILTER_SANITIZE_STRING.

Ver el manual de referencia completo de las funciones de filtro de PHP para obtener los posibles filtros.

El ID del filtro puede ser el nombre del ID (por ejemplo, FILTER_VALIDATE_EMAIL) o el número del ID (por ejemplo, 274).

opciones Especificar un array que contiene el símbolo / opción. Verificar cada filtro posible y sus posibles símbolos y opciones.

Ejemplo

En este ejemplo, utilizamos la función filter_input() para filtrar una variable POST. La variable POST aceptada es una dirección de correo electrónico válida.

<?php
if (!filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL))
 {
 echo "El correo electrónico no es válido";
 }
else
 {
 echo "El correo electrónico es válido";
 }
?>

Salida similar a:

El correo electrónico es válido