Função filter_input() do PHP
Definição e uso
A função filter_input() obtém entrada de fora do script e a filtra.
Esta função é usada para validar variáveis provenientes de fontes não seguras, como entrada do usuário.
Esta função pode obter entrada de várias fontes:
- INPUT_GET
- INPUT_POST
- INPUT_COOKIE
- INPUT_ENV
- INPUT_SERVER
- INPUT_SESSION (Ainda não implementado)
- INPUT_REQUEST (Ainda não implementado)
Se tiver sucesso, retornará os dados filtrados, se falhar, retornará false, se variável Se os parâmetros não forem configurados, retornará NULL.
Sintaxe
filter_input(input_type, variável, filtro, Opções)
| Parâmetros | Descrição |
|---|---|
| input_type | Obrigatório. Especifique o tipo de entrada. Veja a lista acima para os tipos possíveis. |
| variável | Especifique a variável a ser filtrada. |
| filtro |
Opcional. Especifique o ID do filtro a ser usado. O padrão é FILTER_SANITIZE_STRING. Veja o manual completo de funções de filtro PHP para obter os filtros possíveis. O ID do filtro pode ser o nome do ID (por exemplo, FILTER_VALIDATE_EMAIL) ou o número do ID (por exemplo, 274). |
| Opções | Especifique um array que contém sinalizadores/opes. Verifique cada sinalizador e opção possível do filtro. |
Exemplo
Neste exemplo, usamos a função filter_input() para filtrar uma variável POST. A variável POST aceita é um endereço de e-mail válido.
<?php
if (!filter_input(INPUT_POST, 'email', FILTER_VALIDATE_EMAIL))
{
echo "E-Mail não é válido";
}
else
{
echo "E-Mail é válido";
}
?>
Saída semelhante a:
E-Mail é válido
