filter_input

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

filter_input — Gets a specific external variable by name and optionally filters it

Opis

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

Parametry

type: One of INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER, INPUT_ENV, INPUT_SESSION (not implemented yet) and INPUT_REQUEST (not implemented yet).
variable_name: Name of a variable to get.
filter: Filter to apply. Defaults to FILTER_DEFAULT.
options: Associative array of options or bitwise disjunction of flags. If filter accepts options, flags can be provided in "flags" field of array.

Zwracane wartości

Value of the requested variable on success, FALSE if the filter fails, or NULL if the variable_name variable is not set. If the flag FILTER_NULL_ON_FAILURE is used, it returns FALSE if the variable is not set and NULL if the filter fails.

Przykłady

Example #1 A filter_input() example


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

Powyższy przykład wyświetli coś podobnego do:

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

Patrz także

filter_list

filter_input_array

Last updated: Fri, 27 Jun 2008

add a note User Contributed Notes
filter_input

Marques Johansson
02-Jan-2008 08: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 09: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 11: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, 27 Jun 2008