Funciones de Filtro

Introducción

Esta extensión sirve para validar y filtrar datos provenientes de alguna fuento insegura, tal como entrada del usuario.

Los siguientes filtros existen en este momento; asegúrese de leer la sección Constantes de Filtros para más información sobre el comportamiento de cada constante:

**Filtros existentes**
ID	Nombre	Opciones	Banderas	Descripción
`FILTER_VALIDATE_INT`	"int"	`min_range` , `max_range`	`FILTER_FLAG_ALLOW_OCTAL`, `FILTER_FLAG_ALLOW_HEX`	Valida el valor como entero, opcionalmente entre el rango especificado.
`FILTER_VALIDATE_BOOLEAN`	"boolean"		`FILTER_NULL_ON_FAILURE`	Devuelve `TRUE` para "1", "true", "on" y "yes". Devuelve `FALSE` de lo contrario. Si `FILTER_NULL_ON_FAILURE` está definido, se devuelve `FALSE` solo para "0", "false", "off", "no", y "", y `NULL` es devuelto para todos los valores no-booleanos.
`FILTER_VALIDATE_FLOAT`	"float"	`decimal`	`FILTER_FLAG_ALLOW_THOUSAND`	Valida el valor como un flotante.
`FILTER_VALIDATE_REGEXP`	"validate_regexp"	`regexp`		Valida el valor contra una expresión regular compatible con Perl `regexp` .
`FILTER_VALIDATE_URL`	"validate_url"		`FILTER_FLAG_PATH_REQUIRED`, `FILTER_FLAG_QUERY_REQUIRED`	Valida el valor como una URL, opcionalmente con los componentes requeridos.
`FILTER_VALIDATE_EMAIL`	"validate_email"			Valida el valor como correo electrónico.
`FILTER_VALIDATE_IP`	"validate_ip"		`FILTER_FLAG_IPV4`, `FILTER_FLAG_IPV6`, `FILTER_FLAG_NO_PRIV_RANGE`, `FILTER_FLAG_NO_RES_RANGE`	Valida el valor como una dirección IP, opcionalmente solo IPv4 o IPv6, o que no pertenezca a los rangos privados o reservados.
`FILTER_SANITIZE_STRING`	"string"		`FILTER_FLAG_NO_ENCODE_QUOTES`, `FILTER_FLAG_STRIP_LOW`, `FILTER_FLAG_STRIP_HIGH`, `FILTER_FLAG_ENCODE_LOW`, `FILTER_FLAG_ENCODE_HIGH`, `FILTER_FLAG_ENCODE_AMP`	Remueve etiquetas, opcionalmente removiendo o codificando caracteres especiales.
`FILTER_SANITIZE_STRIPPED`	"stripped"			Alias para el filtro "string".
`FILTER_SANITIZE_ENCODED`	"encoded"		`FILTER_FLAG_STRIP_LOW`, `FILTER_FLAG_STRIP_HIGH`, `FILTER_FLAG_ENCODE_LOW`, `FILTER_FLAG_ENCODE_HIGH`	Codificar estilo URL una cadena, opcionalmente remover o codificar caracteres especiales.
`FILTER_SANITIZE_SPECIAL_CHARS`	"special_chars"		`FILTER_FLAG_STRIP_LOW`, `FILTER_FLAG_STRIP_HIGH`, `FILTER_FLAG_ENCODE_HIGH`	Escapar como HTML '"<>& y caracteres con valores ASCII menores a 32, opcionalemnte remover o codificar otros caracteres especiales.
`FILTER_UNSAFE_RAW`	"unsafe_raw"		`FILTER_FLAG_STRIP_LOW`, `FILTER_FLAG_STRIP_HIGH`, `FILTER_FLAG_ENCODE_LOW`, `FILTER_FLAG_ENCODE_HIGH`, `FILTER_FLAG_ENCODE_AMP`	No hacer nada, opcionalmente remover o codificar caracteres especiales.
`FILTER_SANITIZE_EMAIL`	"email"			Remover todos los caracteres excepto las letras, dígitos y !#$%&'+-/=?^_`{\|}~@.[]*.
`FILTER_SANITIZE_URL`	"url"			Remover todos los caracteres excepto letras, dígitos y $-_.+!'(),{}\|\\^~[]`<>#%";/?:@&=*.
`FILTER_SANITIZE_NUMBER_INT`	"number_int"			Remover todos los caracteres excepto dígitos y +-.
`FILTER_SANITIZE_NUMBER_FLOAT`	"number_float"		`FILTER_FLAG_ALLOW_FRACTION`, `FILTER_FLAG_ALLOW_THOUSAND`, `FILTER_FLAG_ALLOW_SCIENTIFIC`	Remover todos los caracteres excepto dígitos, +- y opcionalmente .,eE.
`FILTER_SANITIZE_MAGIC_QUOTES`	"magic_quotes"			Aplicar addslashes().
`FILTER_CALLBACK`	"callback"	función callback o método		Llamar una función definida por el usuario para filtrar los datos.

Requisitos

No se necesitan bibliotecas externas para construir esta extensión

Instalación

Una corta nota de inslatación: simplemente escriba

$ pecl install filter

en su consola.

Configuración en tiempo de ejecución

El comportamiento de estas funciones está afectado por los valores definidos en php.ini.

**Opciones de Configuración de Filtros**
Nombre	Predeterminado	Modificable	Registro de cambios
filter.default	"unsafe_raw"	PHP_INI_PERDIR	PHP_INI_ALL en filter <= 0.9.4. Disponible desde PHP 5.2.0.
filter.default_flags	NULL	PHP_INI_PERDIR	PHP_INI_ALL en filter <= 0.9.4. Disponible desde PHP 5.2.0.

For further details and definitions of the PHP_INI_* constants, see the Directivas de php.ini.

A continuación se presenta una corta explicación de las directivas de configuración.

filter.default string

Filtrar todos los datos $_GET, $_POST, $_COOKIE y $_REQUEST con este filtro. Los datos originales pueden ser accesados mediante filter_input().

Acepta el nombre del filtro que desa usar por omisión. Vea la lista de filtros existentes para conocer los nombres.

filter.default_flags integer

Banderas predeterminadas

Tipos de recursos

Esta extensión no tiene ningún tipo de recurso definido.

Constantes predefinidas

Estas constantes están definidas por esta extensión y estarán disponibles solamente cuando la extensión ha sido o bien compilada dentro de PHP o grabada dinámicamente en tiempo de ejecución.

INPUT_POST (integer): Variables POST.
INPUT_GET (integer): Variables GET.
INPUT_COOKIE (integer): Variables COOKIE.
INPUT_ENV (integer): Variables ENV.
INPUT_SERVER (integer): Variables SERVER.
INPUT_SESSION (integer): Variables SESSION. (aun no implementado)
INPUT_REQUEST (integer): Variables REQUEST. (aun no implementado)
FILTER_FLAG_NONE (integer): Ninguna bandera.
FILTER_REQUIRE_SCALAR (integer): Bandera usada para requerir un valor escalar como entrada
FILTER_REQUIRE_ARRAY (integer): Requerir una matriz como entrada.
FILTER_FORCE_ARRAY (integer): Siempre devolver una matriz.
FILTER_NULL_ON_FAILURE (integer): Usar NULL en lugar de FALSE en caso de fallos.
FILTER_VALIDATE_INT (integer): ID del filtro "int".
FILTER_VALIDATE_BOOLEAN (integer): ID del filtro "boolean".
FILTER_VALIDATE_FLOAT (integer): ID del filtro "float".
FILTER_VALIDATE_REGEXP (integer): ID del filtro "validate_regexp".
FILTER_VALIDATE_URL (integer): ID del filtro "validate_url".
FILTER_VALIDATE_EMAIL (integer): ID del filtro "validate_email".
FILTER_VALIDATE_IP (integer): ID del filtro "validate_ip".
FILTER_DEFAULT (integer): ID del filtro predeterminado ("string").
FILTER_UNSAFE_RAW (integer): ID del filtro "unsafe_raw".
FILTER_SANITIZE_STRING (integer): ID del filtro "string".
FILTER_SANITIZE_STRIPPED (integer): ID del filtro "stripped".
FILTER_SANITIZE_ENCODED (integer): ID del filtro "encoded".
FILTER_SANITIZE_SPECIAL_CHARS (integer): ID del filtro "special_chars".
FILTER_SANITIZE_EMAIL (integer): ID del filtro "email".
FILTER_SANITIZE_URL (integer): ID del filtro "url".
FILTER_SANITIZE_NUMBER_INT (integer): ID del filtro "number_int".
FILTER_SANITIZE_NUMBER_FLOAT (integer): ID del filtro "number_float".
FILTER_SANITIZE_MAGIC_QUOTES (integer): ID del filtro "magic_quotes".
FILTER_CALLBACK (integer): ID del filtro "callback".
FILTER_FLAG_ALLOW_OCTAL (integer): Permitir notación octal (0[0-7]+) en el filtro "int".
FILTER_FLAG_ALLOW_HEX (integer): Permitir notación hexadecimal (0x[0-9a-fA-F]+) en el filtro "int".
FILTER_FLAG_STRIP_LOW (integer): Remover caracteres con valores ASCII menores a 32.
FILTER_FLAG_STRIP_HIGH (integer): Remover caracteres con valores ASCII más altos de 127.
FILTER_FLAG_ENCODE_LOW (integer): Codificar caracteres con valores ASCII menores que 32.
FILTER_FLAG_ENCODE_HIGH (integer): Codificar caracteres con valores ASCII mayores que 127.
FILTER_FLAG_ENCODE_AMP (integer): Codificar &.
FILTER_FLAG_NO_ENCODE_QUOTES (integer): No codificar ' y ".
FILTER_FLAG_EMPTY_STRING_NULL (integer): (Sin uso por ahora.)
FILTER_FLAG_ALLOW_FRACTION (integer): Permitir la parte de fracción en el filtro "number_float".
FILTER_FLAG_ALLOW_THOUSAND (integer): Permitir el separador de miles (,) en el filtro "number_float".
FILTER_FLAG_ALLOW_SCIENTIFIC (integer): Permitir la notación científica (e, E) en el filtro "number_float".
FILTER_FLAG_SCHEME_REQUIRED (integer): Requerir un esquema en el filtro "validate_url".
FILTER_FLAG_HOST_REQUIRED (integer): Requerir un host en el filtro "validate_url".
FILTER_FLAG_PATH_REQUIRED (integer): Requerir una ruta en el filtro "validate_url".
FILTER_FLAG_QUERY_REQUIRED (integer): Requerir una cadena de consulta en el filtro "validate_url".
FILTER_FLAG_IPV4 (integer): Permitir únicamente direcciones IPv4 en el filtro "validate_ip".
FILTER_FLAG_IPV6 (integer): Permitir únicamente direcciones IPv6 en el filtro "validate_ip".
FILTER_FLAG_NO_RES_RANGE (integer): No permitir direcciones reservadas en el filtro "validate_ip".
FILTER_FLAG_NO_PRIV_RANGE (integer): No permitir direcciones privadas en el filtro "validate_ip".

filter_has_var — Verifica si la variable del tipo especificado existe
filter_id — Devuelve el ID del filtro con el nombre dado
filter_input_array — Obtiene múltiples variables desde afuera de PHP y opcionalmente las filtra
filter_input — Obtiene una variable desde afuera de PHP y opcionalmente la filtra
filter_list — Devuelve una lista de todos los filtros soportados
filter_var_array — Obtiene múltiples variables y opcionalmente las filtra
filter_var — Filtra una variable con un filtro específico