Manuel PHP
Précédent |  | Suivant

# filter_var_array

(no version information, might be only in CVS)

filter_var_array -- Récupère plusieurs variables et les filtrent

## Description

mixed filter_var_array ( array data [, mixed definition] )

Cette fonction est utile pour récupérer plusieurs valeurs sans appeler répétitivement la fonction filter_var().

## Liste de paramètres

`data`

  Un tableau avec les clés contenant les données à filtrer.

`definition`

  Un tableau définissant les arguments. Une clé valide est une chaîne de caractères contenant le nom de la variable et une valeur valide est soit le type d'un filtre, soit un tableau spécifiant le filtre, les drappeaux et les options. Si la valeur est un tableau, les clés valides sont `filter` qui spécifie le type du filtre, `flags` qui spécifie tous les drappeaux à appliquer au filtre, et `options` qui spécifie toutes les options à appliquer au filtre. Voir l'exemple ci-dessous pour une meilleure compréhension.

  Ce paramètre peut également être un entier contenant une constante de filtre. Ensuite, toutes les valeurs du tableau d'entrée seront filtrées par ce filtre.

## Valeurs de retour

Un tableau contenant les valeurs des variables demandées en cas de succès, ou `FALSE` si une erreur survient. Un tableau de valeurs peut valoir `FALSE` si le filtre échoue, ou `NULL` si la variable n'est pas définie.

## Exemples

Exemple 1. A filter_var_array() example

`<?php
error_reporting(E_ALL | E_STRICT);
$data = array(
'product_id' => 'libgd<script>',
'component' => '10',
'versions' => '2.0.33',
'testscalar' => array('2', '23', '10', '12'),
'testarray' => '2',
);
$args = array(
'product_id' => FILTER_SANITIZE_ENCODED,
'component' => array('filter' => FILTER_VALIDATE_INT,
'flags' => FILTER_FORCE_ARRAY,
'options' => array('min_range' => 1, 'max_range' => 10)
),
'versions' => FILTER_SANITIZE_ENCODED,
'doesnotexist' => FILTER_VALIDATE_INT,
'testscalar' => array(
'filter' => FILTER_VALIDATE_INT,
'flags' => FILTER_REQUIRE_SCALAR,
),
'testarray' => array(
'filter' => FILTER_VALIDATE_INT,
'flags' => FILTER_FORCE_ARRAY,
)
);
$myinputs = filter_var_array($data, $args);
var_dump($myinputs);
echo "\n";
?>`

L'exemple ci-dessus va afficher :

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

## Voir aussi

filter_input_array()
filter_var()
filter_input()

Précédent | Sommaire | Suivant
filter_list | Niveau supérieur | filter_var