filter_input

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

filter_input — İsme göre belirli bir dış değişken alır ve isteğe bağlı olarak süzer

Açıklama

filter_input(
    int $tür,
    string $değişken_ismi,
    int $süzgeç = FILTER_DEFAULT,
    array|int $seçenekler = 0
): mixed

Bağımsız Değişkenler

tür
INPUT_* sabitlerinden biri.
Uyarı

Süzülen süper küresel değişkenin içeriği, süper küresel değişkene yapılan kullanıcı değişikliklerinden önce SAPI tarafından sağlanan özgün "ham" içeriktir. Değiştirilmiş bir süper küresel değişkeni süzmek için yerine filter_var() kullanılmalıdır.

değişken_ismi
İlgili tür süper küresel değişkeni içerisinde süzülecek değişkenin ismi.
süzgeç
Uygulanacak süzgeç. FILTER_VALIDATE_* sabitlerinden biri kullanılarak bir doğrulama süzgeci, FILTER_SANITIZE_* sabitlerinden biri ya da FILTER_UNSAFE_RAW kullanılarak bir temizleme süzgeci veya FILTER_CALLBACK kullanılarak özel bir süzgeç olabilir.

Bilginize: Öntanımlı değer, FILTER_UNSAFE_RAW sabitinin takma adı olan FILTER_DEFAULT'tur. Bu, öntanımlı olarak hiçbir süzgecin uygulanmaması ile sonuçlanır.

seçenekler
Bir ilişkisel array seçenekler veya FILTER_FLAG_* süzgeç bayrak sabitlerinden oluşan bir bit maskesi. Eğer süzgeç seçenekleri kabul ediyorsa, bayraklar dizinin "flags" alanı kullanılarak sağlanabilir.

Dönen Değerler

Başarı durumunda istenen değişkenin değerini, süzgeç başarısız olursa false, değişken_ismi değişkeni atanmamışsa null döndürür. FILTER_NULL_ON_FAILURE bayrağı kullanılırsa, değişken atanmamışsa false, süzgeç başarısız olursa null döndürür.

Örnekler

Örnek 1 filter_input() örneği

<?php
$search_html = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
$search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
echo "$search_html ifadesini aradınız.\n";
echo "<a href='?search=$search_url'>Tekrar ara.</a>";
?>

Yukarıdaki örnek şuna benzer bir çıktı üretir:

Ben &#38; oğlum ifadesini aradınız.
<a href='?search=Ben%20%26%20o%C4%9Flum'>Tekrar ara.</a>

Ayrıca Bakınız