Web aym.pekori.to

input_get

(no version information, might be only in CVS)

input_get -- PHP の外部から変数を受け取り、オプションでそれをフィルタリングする

説明

mixed input_get ( int type, string variable_name [, int filter [, mixed flags [, string charset]]] )

警告

この関数は、 実験的 なものです。この関数の動作・ 名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 この関数は自己責任で使用してください。

パラメータ

type

INPUT_GETINPUT_POSTINPUT_COOKIEINPUT_SERVERINPUT_ENVINPUT_SESSION (未実装) および 99 (現在は REQUEST を扱います) のいずれか。

variable_name

取得する変数の名前。

filter

適用するフィルタ。デフォルトは FILTER_DEFAULT です。

flags

オプションあるいはフラグの論理和の連想配列。 オプションを指定可能なフィルタの場合、この配列の "flags" フィールドにフラグを指定します。

charset

フィルタリングに使用する文字セット。 現在は、このパラメータを使用するフィルタはありません。

返り値

要求された変数の値、あるいは変数が見つからなかった場合に FALSE を返します。

例 1. input_get() の例

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

上の例の出力は、たとえば 以下のようになります。

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

参考

filter_data()