filter_var_array

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

filter_var_array — Çok sayıda değişken alır ve isteğe bağlı olarak süzer

Açıklama

filter_var_array(array $dizi, array|int $seçenekler = FILTER_DEFAULT, bool $boşları_da_ekle = true): array|false|null

Bir ilişkisel array içerisindeki değerleri FILTER_VALIDATE_* doğrulama süzgeçleri, FILTER_SANITIZE_* temizleme süzgeçleri veya özel süzgeçler kullanarak süzer.

Bağımsız Değişkenler

dizi: Süzülecek veriyi içeren ilişkisel array.
seçenekler: Bir ilişkisel array seçenekler veya her elemana uygulanacak süzgeç. Süzgeç, FILTER_VALIDATE_* sabitlerinden biriyle bir doğrulama süzgeci ya da FILTER_SANITIZE_* sabitlerinden biriyle bir temizleme süzgeci olabilir. Seçenek dizisi, anahtarın veri dizi dizisindeki bir anahtara karşılık geldiği ilişkisel bir dizidir; ilgili değer ise bu eleman için uygulanacak süzgeç ya da bu elemana hangi süzgecin nasıl uygulanacağını tanımlayan bir ilişkisel dizidir. Bir süzgecin nasıl uygulanacağını tanımlayan ilişkisel dizi, ilgili değeri uygulanacak süzgeç olan 'filter' anahtarını içermek zorundadır. Süzgeç, FILTER_VALIDATE_*, FILTER_SANITIZE_*, FILTER_UNSAFE_RAW veya FILTER_CALLBACK sabitlerinden biri olabilir. Süzgeçle birlikte uygulanacak bayrakları belirten 'flags' anahtarı ve süzgece uygulanacak seçenekleri belirten 'options' anahtarı isteğe bağlı olarak içerebilir.
boşları_da_ekle: Eksik anahtarları döndürülen değere null olarak ekler.

Dönen Değerler

Başarı durumunda istenen değişkenlerin değerlerini içeren bir dizi, başarısızlık durumunda false döndürür. Süzgeç başarısız olursa bir dizi değeri false, değişken atanmamışsa null olur.

Örnekler

Örnek 1 filter_var_array() örneği

<?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));

?>

Yukarıdaki örneğin çıktısı:

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
}

Ayrıca Bakınız

filter_input_array() - Dış değişkenleri alır ve isteğe bağlı olarak süzer
filter_var() - Belirtilen süzgeçle bir değişkeni süzer
filter_input() - İsme göre belirli bir dış değişken alır ve isteğe bağlı olarak süzer
Doğrulama süzgeçleri FILTER_VALIDATE_*
Temizleme süzgeçleri FILTER_SANITIZE_*