PHP Conference Nagoya 2025

    filter_var_array

    (PHP 5 >= 5.2.0, PHP 7, PHP 8)

    filter_var_array — Obtêm e opcionalmente filtra múltiplas variáveis

    Descrição

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

    Filtra um array associativo de valores usando filtros de validação FILTER_VALIDATE_*, filtros de sanitização FILTER_SANITIZE_*, ou filtros customizados.

    Parâmetros

    array
    Um array associativo contendo os dados a filtrar.
    options
    Pode ser um array associativo de opções, ou o filtro a aplicar a cada entrada, que pode ser um filtro de validação usando uma das constantes FILTER_VALIDATE_*, ou um filtro de sanitização, usando uma das constantes FILTER_SANITIZE_*. O array de opções é um array associativo onde a chave corresponde a uma chave no array de dados e o valor associado é o filtro a ser aplicado a esta entrada ou um array associativo descrevendo como e qual filtro deve ser aplicado a esta entrada. O array associativo que descreve como um filtro deve ser aplicado deve conter a chave 'filter' cujo valor associado é o filtro a ser aplicado, que pode ser uma das constantes FILTER_VALIDATE_*, FILTER_SANITIZE_*, FILTER_UNSAFE_RAW ou FILTER_CALLBACK. Opcionalmente, ele pode conter a chave 'flags' que especifica os sinalizadores que se aplicam ao filtro, e a chave 'options' que especifica quaisquer opções que se aplicam ao filtro.
    add_empty

    Adiciona chaves ausentes como null ao valor de retorno.

    Valor Retornado

    Um array contendo valores das variáveis requisitadas em caso de sucesso, ou false em caso de falha. Um valor de array será false se o filtro falhar, ou null se a variável não estiver definida.

    Exemplos

    Exemplo #1 Um exemplo de filter_var_array()

    <?php

    $data     = [
    'product_id' => 'libgd<script>',
    'component' => '10',
    'versions' => '2.0.33',
    'testscalar' => ['2', '23', '10', '12'],
    'testarray' => '2',
    ];

    $filters = [
    'product_id' => FILTER_SANITIZE_ENCODED,
    'component' => [
    'filter' => FILTER_VALIDATE_INT,
    'flags' => FILTER_FORCE_ARRAY,
    'options' => [
    'min_range' => 1,
    'max_range' => 10,
    ],
    ],
    'versions' => [
    'filter' => FILTER_SANITIZE_ENCODED
    ],
    'testscalar' => [
    'filter' => FILTER_VALIDATE_INT,
    'flags' => FILTER_REQUIRE_SCALAR,
    ],
    'testarray' => [
    'filter' => FILTER_VALIDATE_INT,
    'flags' => FILTER_FORCE_ARRAY,
    ],
    'doesnotexist' => FILTER_VALIDATE_INT,
    ];

    var_dump(filter_var_array($data, $filters));

    ?>

    O exemplo acima produzirá:

    array(6) {
  ["product_id"]=>
  string(17) "libgd%3Cscript%3E"
  ["component"]=>
  array(1) {
    [0]=>
    int(10)
  }
  ["versions"]=>
  string(6) "2.0.33"
  ["testscalar"]=>
  bool(false)
  ["testarray"]=>
  array(1) {
    [0]=>
    int(2)
  }
  ["doesnotexist"]=>
  NULL
}

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 3 notes

    up
    4
    Anonymous
    1 year ago
    To apply the same filter to many params/keys, use array_fill_keys().

    <?php
    $data     = array(
    'product_id' => 'libgd<script>',
    'component' => ' 10 ',
    'versions' => '2.0.33',
    'testscalar' => array('2', '23', '10', '12'),
    'testarray' => '2',
    );
    $keys = array(
    'product_id',
    'component',
    'versions',
    'doesnotexist',
    'testscalar',
    'testarray'
    );
    $options = array(
    'filter' => FILTER_CALLBACK,
    'options' => function ($value) {
    return     trim(strip_tags($value));
    },
    );
    $args = array_fill_keys($keys, $options);
    /* Result
    $args = array(
    'product_id' => array(
    'filter' => FILTER_CALLBACK,
    'options' => function ($value) {
    return trim(strip_tags($value));
    },
    ),
    'component' => array(
    'filter' => FILTER_CALLBACK,
    'options' => function ($value) {
    return trim(strip_tags($value));
    },
    ),
    'versions' => array(
    'filter' => FILTER_CALLBACK,
    'options' => function ($value) {
    return trim(strip_tags($value));
    },
    ),
    'doesnotexist' => array(
    'filter' => FILTER_CALLBACK,
    'options' => function ($value) {
    return trim(strip_tags($value));
    },
    ),
    'testscalar' => array(
    'filter' => FILTER_CALLBACK,
    'options' => function ($value) {
    return trim(strip_tags($value));
    },
    ),
    'testarray' => array(
    'filter' => FILTER_CALLBACK,
    'options' => function ($value) {
    return trim(strip_tags($value));
    },
    ),
    );
    */

    $myinputs = filter_var_array($data, $args);
    var_dump($myinputs);

    Output:

    array(    6) {
    'product_id' =>
    string(5) "libgd"
    'component'     =>
    string(2) "10"
    'versions'     =>
    string(6) "2.0.33"
    'doesnotexist'     =>
    NULL
    'testscalar' =>
    array(    4) {
    [    0] =>
    string(1) "2"
    [1] =>
    string(2) "23"
    [2] =>
    string(2) "10"
    [3] =>
    string(2) "12"
    }
    'testarray' =>
    string(1) "2"
    }
    up
    8
    eguvenc at gmail dot com
    15 years ago
    <?php
    //an example of simply sanitize an array..

    $data = array(
    '<b>bold</b>',
    '<script>javascript</script>',
    'P*}i@893746%%%p*.i.*}}|.dw<?php echo "echo works!!";?>');

    $myinputs = filter_var_array($data,FILTER_SANITIZE_STRING);

    var_dump($myinputs);

    //OUTPUT:
    //formarray(3) { [0]=> string(4) "bold" [1]=> string(10) "javascript" [2]=> string(26) "P*}i@893746%%%p*.i.*}}|.dw" }
    ?>
    up
    -1
    Vee W.
    5 years ago
    $emails = [
    'a' => 'email1@domain.com',
    'b' => '<email2>@domain.com',
    ];

    $result = filter_var_array($emails, FILTER_SANITIZE_EMAIL);
    print_r($result);

    // the result will be...
    // array('a' => 'email1@domain.com', 'b' => 'email2@domain.com')
    ＋adicione uma nota
    To Top