filter_input

(PHP 5 >= 5.2.0, PECL filter:0.11.0)

filter_input — Nimmt Variable von Außen entgegen und filtert sie optional

Beschreibung

mixed filter_input ( int $type , string $variable_name [, int $filter [, mixed $options ]] )

Parameter-Liste

type: Einer von INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER, INPUT_ENV, INPUT_SESSION (not implemented yet) and INPUT_REQUEST (not implemented yet).
variable_name: Name der Variablen.
filter: Anzuwendender Filter. Standard ist FILTER_DEFAULT.
options: Assoziatives Array mit Optionen oder bitweise Disjunktion von Flags. Wenn der Filter Optionen akzeptiert, können Flags auch im "flags" Feld des Arrays angegeben werden.

Rückgabewerte

Bei Erfolg wird der Wert zurückgegeben, FALSE im Fehlerfall oder NULL, wenn die Variable variable_name nicht gesetzt ist. Wenn das Flag FILTER_NULL_ON_FAILURE benutzt wurde, wird FALSE zurückgegeben, wenn die Variable nicht gesetzt ist und NULL, wenn das Filtern fehlgeschlagen ist.

Beispiele

Beispiel #1 filter_input() Beispiel


<?php
$search_html = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
$search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
echo "You have searched for $search_html.\n";
echo "<a href='?search=$search_url'>Search again.</a>";
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

You have searched for Me &#38; son.
<a href='?search=Me%20%26%20son'>Search again.</a>

Siehe auch

filter_list

filter_input_array

Last updated: Fri, 04 Jul 2008

add a note User Contributed Notes
filter_input

Marques Johansson
02-Jan-2008 11:30


Despite the documentation for 'type', you can specify multiple types by doing:



$test = filter_input(INPUT_GET | INPUT_POST, 'test');



This was tested in 5.2.3.



When both are set it appears to return the value defined first by variables_order (php.ini).



This trick does not seem to work in filter_input_array though.  Neither function supports INPUT_REQUEST at the moment.

vid at phpcult dot com
10-Dec-2007 12:49


If you want to use the callback filter with filter_input, you need to do something like: 



$args = array ('options' => 'mycallbackfunction'); 



$foobar = filter_input(INPUT_POST,'postedvariable',FILTER_CALLBACK,$args);

anthony dot parsons at manx dot net
23-Aug-2007 02:10


FastCGI seems to cause strange side-effects with unexpected null values when using INPUT_SERVER and INPUT_ENV with this function. You can use this code to see if it affects your server:

<?php

var_dump($_SERVER);

foreach ( array_keys($_SERVER) as $b ) {

    var_dump($b, filter_input(INPUT_SERVER, $b));

}

echo '<hr>';

var_dump($_ENV);

foreach ( array_keys($_ENV) as $b ) {

    var_dump($b, filter_input(INPUT_ENV, $b));

}

?>

If you want to be on the safe side, using the superglobal $_SERVER and $_ENV variables will always work. You can still use the filter_* functions for Get/Post/Cookie without a problem, which is the important part!

add a note

filter_list

filter_input_array

Last updated: Fri, 04 Jul 2008