filter_var_array

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

    filter_var_array — Obtiene múltiple variables y opcionalmente las filtra

    Descripción

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

    Valida un array asociativo de valores usando los filtros de validación FILTER_VALIDATE_*, filtros de saneación FILTER_SANITIZE_*, o filtros definidos por el usuario

    Parámetros

    array
    Un array asociativo que contiene los datos a filtrar.
    options
    Ya sea un array asociativo de opciones, o el filtro que se aplicará a cada entrada, que puede ser un filtro de validación mediante el uso de una de las constantes FILTER_VALIDATE_* o un filtro de saneamiento mediante el uso de una de las constantes FILTER_SANITIZE_*. La array de opciones es un array asociativo donde la clave corresponde a una clave en la matriz de datos array y el valor asociado es el filtro a aplicar a esta entrada, o un array asociativo que describe cómo y qué filtro se debe aplicar a esta entrada. El array asociativo que describe cómo se debe aplicar un filtro debe contener la clave 'filter' cuyo valor asociado es el filtro a aplicar, que puede ser uno de las constantes FILTER_VALIDATE_*, FILTER_SANITIZE_*, FILTER_UNSAFE_RAW, o FILTER_CALLBACK. Opcionalmente, puede contener la clave 'flags', que especifica los indicadores que se aplican al filtro, y la clave 'options', que especifica las opciones que se aplican al filtro.
    add_empty

    Añade claves faltantes como null al valor devuelto.

    Valores devueltos

    En caso de éxito un array que contiene los valores de las variables que se han pedido o false en caso de fallo. El valor del array será false si el filtro falla o null si la variable no está definida.

    Ejemplos

    Ejemplo #1 Ejemplo 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));

    ?>

    El resultado del ejemplo sería:

    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
}

    Ver también

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    4
    Anonymous
    2 years 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')
    ＋add a note
    To Top