PHP マニュアル
前のページ |  | 次のページ

# filter_input

(no version information, might be only in CVS)

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

## 説明

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

## パラメータ

`type`

  `INPUT_GET`、`INPUT_POST`、 `INPUT_COOKIE`、`INPUT_SERVER`、 `INPUT_ENV`、`INPUT_SESSION` (まだ実装されていません) および `INPUT_REQUEST` (まだ実装されていません) のいずれか。

`variable_name`

  取得する変数の名前。

`filter`

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

`options`

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

## 返り値

成功した場合は要求された変数の値、フィルタリングに失敗した場合に `FALSE`、 あるいは変数 `variable_name` が設定されていない場合に `NULL` を返します。フラグ `FILTER_NULL_ON_FAILURE` が指定されている場合は、変数が設定されていなければ `FALSE`、 フィルタリングに失敗したら `NULL` を返します。

## 例

例 1. filter_input() の例

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

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

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

## 参考

filter_var()
filter_input_array()
filter_var_array()

前のページ | ホーム | 次のページ
filter_input_array | 上に戻る | filter_list