From 04f74ae1f8d4dfbfed938388736b9aee047c201a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=AD=A6=E7=94=B0=20=E6=86=B2=E5=A4=AA=E9=83=8E?= Date: Wed, 18 Nov 2026 23:35:33 +0900 Subject: [PATCH] =?UTF-8?q?filter=20=E3=82=92=E5=8E=9F=E6=96=87=E3=81=AE?= =?UTF-8?q?=E5=A4=89=E6=9B=B4=E3=81=AB=E8=BF=BD=E5=BE=93=20(5=E3=83=95?= =?UTF-8?q?=E3=82=A1=E3=82=A4=E3=83=AB)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- reference/filter/functions/filter-has-var.xml | 37 ++++++++- .../filter/functions/filter-input-array.xml | 64 +++++++++++++++- reference/filter/functions/filter-input.xml | 45 ++++++++++- .../filter/functions/filter-var-array.xml | 45 ++++++++++- reference/filter/functions/filter-var.xml | 75 ++++++++++++++++++- 5 files changed, 261 insertions(+), 5 deletions(-) diff --git a/reference/filter/functions/filter-has-var.xml b/reference/filter/functions/filter-has-var.xml index a1d1206b95..45bb340e4d 100644 --- a/reference/filter/functions/filter-has-var.xml +++ b/reference/filter/functions/filter-has-var.xml @@ -1,6 +1,6 @@ - + @@ -46,6 +46,41 @@ + + &reftitle.errors; + + input_type が + INPUT_* + 定数のいずれでもない場合、ValueError をスローします。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + input_type が + INPUT_* + 定数のいずれでもない場合、 + ValueError をスローするようになりました。 + これより前のバージョンでは、&false; を返していました。 + + + + + + + - + filter_input_array @@ -74,6 +74,68 @@ + + &reftitle.errors; + + type が + INPUT_* + 定数のいずれでもない場合、ValueError をスローします。 + + + type で指定された入力配列に値が入っている場合、 + options が &array; で、&string; 以外のキーがあれば + TypeError を、 + 空のキーがあれば + ValueError をスローします。 + + + PHP 8.5.0 以降、入力配列に存在するエントリに対して + FILTER_THROW_ON_FAILURE フラグを使うと、 + フィルタが失敗した場合は + Filter\FilterFailedException を、 + このフラグを FILTER_NULL_ON_FAILURE と一緒に使った場合は + ValueError をスローします。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + type が + INPUT_* + 定数のいずれでもない場合、 + ValueError をスローするようになりました。 + これより前のバージョンでは、入力配列に値が入っていないものとして扱われていました。 + + + + 8.0.0 + + type で指定された入力配列に値が入っている場合、 + options に &string; 以外のキーがあれば + TypeError を、 + 空のキーがあれば + ValueError をスローするようになりました。 + これより前のバージョンでは、E_WARNING が発生し、 + &false; を返していました。 + + + + + + + &reftitle.examples; diff --git a/reference/filter/functions/filter-input.xml b/reference/filter/functions/filter-input.xml index cf1daafdf0..9c8d9bdb15 100644 --- a/reference/filter/functions/filter-input.xml +++ b/reference/filter/functions/filter-input.xml @@ -1,6 +1,6 @@ - + filter_input @@ -65,6 +65,49 @@ + + &reftitle.errors; + + type が + INPUT_* + 定数のいずれでもない場合、ValueError をスローします。 + + + PHP 8.5.0 以降、FILTER_THROW_ON_FAILURE フラグを使うと、 + フィルタが失敗した場合と + var_name 変数が設定されていない場合は + Filter\FilterFailedException を、 + このフラグを FILTER_NULL_ON_FAILURE と一緒に使った場合は + ValueError をスローします。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + type が + INPUT_* + 定数のいずれでもない場合、 + ValueError をスローするようになりました。 + これより前のバージョンでは、変数が設定されていないものとして扱われていました。 + + + + + + + &reftitle.examples; diff --git a/reference/filter/functions/filter-var-array.xml b/reference/filter/functions/filter-var-array.xml index a22c618322..52a09a6d61 100644 --- a/reference/filter/functions/filter-var-array.xml +++ b/reference/filter/functions/filter-var-array.xml @@ -1,6 +1,6 @@ - + filter_var_array @@ -101,6 +101,49 @@ + + &reftitle.errors; + + options が &array; で、&string; 以外のキーを含む場合は + TypeError を、空のキーを含む場合は + ValueError をスローします。 + + + PHP 8.5.0 以降、array に存在するエントリに対して + FILTER_THROW_ON_FAILURE フラグを使うと、 + フィルタが失敗した場合は + Filter\FilterFailedException を、 + このフラグを FILTER_NULL_ON_FAILURE と一緒に使った場合は + ValueError をスローします。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + options に &string; 以外のキーが含まれる場合は + TypeError を、空のキーが含まれる場合は + ValueError をスローするようになりました。 + これより前のバージョンでは、E_WARNING が発生し、 + &false; を返していました。 + + + + + + + &reftitle.examples; diff --git a/reference/filter/functions/filter-var.xml b/reference/filter/functions/filter-var.xml index b26714be17..958ecf332f 100644 --- a/reference/filter/functions/filter-var.xml +++ b/reference/filter/functions/filter-var.xml @@ -1,6 +1,6 @@ - + filter_var @@ -95,6 +95,17 @@ + + &reftitle.errors; + + PHP 8.5.0 以降、FILTER_THROW_ON_FAILURE フラグを使うと、 + フィルタが失敗した場合は + Filter\FilterFailedException を、 + このフラグを FILTER_NULL_ON_FAILURE と一緒に使った場合は + ValueError をスローします。 + + + &reftitle.examples; @@ -193,6 +204,68 @@ var_dump(filter_var($str, FILTER_VALIDATE_BOOLEAN, ['flags' => FILTER_NULL_ON_FA + + + + + 検証結果を正しく確認する例 + + +]]> + + &example.outputs; + + + + + + + boolean の検証結果を確認する例 + + +]]> + + &example.outputs; + +