Filtros de saneamiento

Estas constantes son definidas por esta extensión, y solo están disponibles si esta extensión ha sido compilada con PHP, o bien cargada en tiempo de ejecución.

FILTER_UNSAFE_RAW (int)

Este filtro no hace nada.

Sin embargo, puede eliminar o codificar caracteres especiales si se usa junto con los flags de saneamiento de filtro FILTER_FLAG_STRIP_* y FILTER_FLAG_ENCODE_*.

FILTER_DEFAULT (int)

Alias de FILTER_UNSAFE_RAW.

FILTER_SANITIZE_STRING (int)

Este filtro elimina etiquetas y codifica en HTML comillas dobles y simples.

Opcionalmente puede eliminar o codificar caracteres especificados si se usa junto con los flags de saneamiento de filtro FILTER_FLAG_STRIP_* y FILTER_FLAG_ENCODE_*.

El comportamiento de codificación de comillas puede desactivarse usando el flag de filtro FILTER_FLAG_NO_ENCODE_QUOTES.

Advertencia

Obsoleto a partir de PHP 8.1.0, use htmlspecialchars() en su lugar.

Advertencia

La forma en que este filtro elimina etiquetas no es equivalente a strip_tags().

FILTER_SANITIZE_STRIPPED (int)

Alias de FILTER_SANITIZE_STRING.

Advertencia

Obsoleto a partir de PHP 8.1.0, use htmlspecialchars() en su lugar.

FILTER_SANITIZE_ENCODED (int)

Este filtro codifica una cadena en URL.

Opcionalmente puede eliminar o codificar caracteres especificados si se usa junto con los flags de saneamiento de filtro FILTER_FLAG_STRIP_* y FILTER_FLAG_ENCODE_*.

FILTER_SANITIZE_SPECIAL_CHARS (int)

Este filtro codifica en HTML ', ", <, >, & y caracteres con un valor ASCII menor que 32. A diferencia del filtro FILTER_SANITIZE_FULL_SPECIAL_CHARS, el filtro FILTER_SANITIZE_SPECIAL_CHARS ignora el flag FILTER_FLAG_NO_ENCODE_QUOTES.

Opcionalmente puede eliminar caracteres especificados si se usa junto con los flags de saneamiento de filtro FILTER_FLAG_STRIP_*, y puede codificar caracteres con valor ASCII mayor que 127 usando FILTER_FLAG_ENCODE_HIGH.

FILTER_SANITIZE_FULL_SPECIAL_CHARS (int)

Este filtro es equivalente a llamar a htmlspecialchars() con ENT_QUOTES configurado.

El comportamiento de codificación de comillas puede desactivarse usando el flag de filtro FILTER_FLAG_NO_ENCODE_QUOTES.

Advertencia

Al igual que htmlspecialchars(), este filtro es consciente de la configuración INI default_charset. Si se detecta una secuencia de bytes que forma un carácter no válido en el juego de caracteres actual, entonces toda la cadena es rechazada resultando en que se devuelva una cadena vacía.

FILTER_SANITIZE_EMAIL (int)

Sanea la cadena eliminando todos los caracteres excepto letras latinas ([a-zA-Z]), dígitos ([0-9]), y los caracteres especiales !#$%&'*+-=?^_`{|}~@.[].

FILTER_SANITIZE_URL (int)

Sanea la cadena eliminando todos los caracteres excepto letras latinas ([a-zA-Z]), dígitos ([0-9]), y los caracteres especiales $-_.+!*'(),{}|\\^~[]`<>#%";/?:@&=.

FILTER_SANITIZE_NUMBER_INT (int)

Sanea la cadena eliminando todos los caracteres excepto dígitos ([0-9]), signo más (+), y signo menos (-).

FILTER_SANITIZE_NUMBER_FLOAT (int)

Sanea la cadena eliminando todos los caracteres excepto dígitos ([0-9]), signo más (+), y signo menos (-).

Flags opcionales

FILTER_FLAG_ALLOW_FRACTION (int)

Acepta el carácter punto (.), que normalmente representa el separador entre las partes entera y fraccionaria.

FILTER_FLAG_ALLOW_THOUSAND (int)

Acepta el carácter coma (,), que normalmente representa el separador de miles.

FILTER_FLAG_ALLOW_SCIENTIFIC (int)

Acepta números en notación científica permitiendo los caracteres e y E.

Advertencia

Si no se usa el flag FILTER_FLAG_ALLOW_FRACTION, entonces el separador decimal es eliminado, alterando el valor recibido.

<?php
$number = '12.34';

var_dump(filter_var($number, FILTER_SANITIZE_NUMBER_FLOAT));
var_dump(filter_var($number, FILTER_SANITIZE_NUMBER_FLOAT, FILTER_FLAG_ALLOW_FRACTION));
?>

El ejemplo anterior mostrará:

string(4) "1234"
string(5) "12.34"

FILTER_SANITIZE_ADD_SLASHES (int)

Aplica addslashes() a la entrada. Disponible a partir de PHP 7.3.0.

FILTER_SANITIZE_MAGIC_QUOTES (int)

Alias de FILTER_SANITIZE_ADD_SLASHES.

Advertencia

OBSOLETO a partir de PHP 7.3.0 y ELIMINADO a partir de PHP 8.0.0.