Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

filter_input_array()

Filtra vários campos originais do SAPI com um filtro comum ou regras por campo.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

filter_input_array(int $type, array|int $options = FILTER_DEFAULT, bool $add_empty = true): array|false|null

Filtra vários campos originais do SAPI com um filtro comum ou regras por campo. Se a origem existir, add_empty acrescenta com null as chaves pedidas em falta. Em CLI sem origem GET o resultado inteiro é null mesmo após alterar $_GET. Com uma origem presente e FILTER_NULL_ON_FAILURE, uma chave em falta continua null com add_empty=true. A chamada individual a filter_input dá false para essa chave.

Assinatura

filter_input_array(int $type, array|int $options = FILTER_DEFAULT, bool $add_empty = true): array|false|null

Saída do exemplo

[{"qty":6,"memo":null},false]

Exemplos

<?php
if (PHP_SAPI==="cgi-fcgi") {
$rules=["qty"=>FILTER_VALIDATE_INT,"memo"=>["filter"=>FILTER_VALIDATE_INT,"flags"=>FILTER_NULL_ON_FAILURE]];
    echo json_encode([filter_input_array(INPUT_GET,$rules,true),filter_input(INPUT_GET,"memo",FILTER_VALIDATE_INT,FILTER_NULL_ON_FAILURE)]);
    exit;
}
$env=["REDIRECT_STATUS"=>"1","SCRIPT_FILENAME"=>__FILE__,"REQUEST_METHOD"=>"GET","QUERY_STRING"=>"qty=6"];
$proc=proc_open([PHP_BINDIR."/php-cgi"],[1=>["pipe","w"]],$pipes,null,$env);
$response=stream_get_contents($pipes[1]); fclose($pipes[1]); proc_close($proc);
[$headers,$body]=preg_split("/\\r?\\n\\r?\\n/",$response,2);
echo $body;

Resultado

[{"qty":6,"memo":null},false]

Fontes