From 243ce650d7a08ff040239232c768faf8502a6253 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: Thu, 18 Jun 2026 23:09:54 +0900 Subject: [PATCH 1/4] =?UTF-8?q?PHP=208.5=20=E3=81=AE=E6=96=B0=E5=AE=9A?= =?UTF-8?q?=E6=95=B0=E3=83=BB=E6=96=B0=E4=BE=8B=E5=A4=96=E3=82=AF=E3=83=A9?= =?UTF-8?q?=E3=82=B9=E3=82=92=E7=BF=BB=E8=A8=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原文に追加された PHP 8.5 の新機能を翻訳。 - reference/filter — FILTER_THROW_ON_FAILURE と例外クラス2件 (Filter\FilterException, Filter\FilterFailedException)、float の科学的記法 (php/doc-en@3d4ee5f, php/doc-en@1c5ff30) - reference/curl — CURLINFO_* 5件・CURLFOLLOW_* 3件・CURLOPT_INFILESIZE_LARGE (php/doc-en@ee972f5, php/doc-en@e7e81a1) - reference/openssl — OPENSSL_PKCS1_PSS_PADDING と PKCS7 定数4件 (php/doc-en@6eadfc4) --- reference/curl/constants.xml | 49 ++++++++++++- reference/curl/constants_curl_getinfo.xml | 64 ++++++++++++++++- reference/curl/constants_curl_setopt.xml | 16 ++++- reference/filter/book.xml | 5 +- reference/filter/constants.xml | 26 ++++++- reference/filter/filter.filterexception.xml | 68 ++++++++++++++++++ .../filter/filter.filterfailedexception.xml | 69 +++++++++++++++++++ reference/openssl/constants.xml | 54 ++++++++++++++- 8 files changed, 343 insertions(+), 8 deletions(-) create mode 100644 reference/filter/filter.filterexception.xml create mode 100644 reference/filter/filter.filterfailedexception.xml diff --git a/reference/curl/constants.xml b/reference/curl/constants.xml index 961ef40f92..a353754c05 100644 --- a/reference/curl/constants.xml +++ b/reference/curl/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; &extension.constants; @@ -213,6 +213,53 @@ + + + CURLFOLLOW_ALL + (int) + + + + CURLOPT_FOLLOWLOCATION に指定する値で、 + リダイレクトの追跡を有効にしつつ、 + CURLOPT_CUSTOMREQUEST で設定したカスタムのリクエストメソッドを、 + リダイレクト後も含めた全てのリクエストで使い続けます。 + PHP 8.5.0 以降 および cURL 8.13.0 以降で利用可能です。 + + + + + + CURLFOLLOW_OBEYCODE + (int) + + + + CURLOPT_FOLLOWLOCATION に指定する値で、 + HTTP のレスポンスコードに従いつつリダイレクトの追跡を有効にします。 + CURLOPT_CUSTOMREQUEST で設定したカスタムのリクエストメソッドは保持されますが、 + それが必要なリダイレクトのステータスコード(301, 302, 303 など)の場合は + GET に変更されます。 + PHP 8.5.0 以降 および cURL 8.13.0 以降で利用可能です。 + + + + + + CURLFOLLOW_FIRSTONLY + (int) + + + + CURLOPT_FOLLOWLOCATION に指定する値で、 + リダイレクトの追跡を有効にしますが、 + CURLOPT_CUSTOMREQUEST で設定したカスタムのリクエストメソッドを使うのは + 最初のリクエストだけです。 + それ以降のリクエストは、リダイレクトのレスポンスコードが指示するメソッドに従います。 + PHP 8.5.0 以降 および cURL 8.13.0 以降で利用可能です。 + + + CURLFTPAUTH_DEFAULT diff --git a/reference/curl/constants_curl_getinfo.xml b/reference/curl/constants_curl_getinfo.xml index 2fb9518a80..8896a33528 100644 --- a/reference/curl/constants_curl_getinfo.xml +++ b/reference/curl/constants_curl_getinfo.xml @@ -1,6 +1,6 @@ - + <function>curl_getinfo</function> @@ -72,6 +72,18 @@ + + + CURLINFO_CONN_ID + (int) + + + + 転送で直近に使用した接続の ID。接続 ID は、同じ接続キャッシュを使用する全接続の中で一意であり、接続の再利用を見分けるのに役立ちます。 + PHP 8.5.0 以降 および cURL 8.2.0 以降で利用可能です。 + + + CURLINFO_CONNECT_TIME @@ -262,6 +274,18 @@ + + + CURLINFO_HTTPAUTH_USED + (int) + + + + 前回のリクエストで実際に使用した HTTP 認証方法を示すビットマスク。 + PHP 8.5.0 以降 および cURL 8.12.0 以降で利用可能です。 + + + CURLINFO_HTTP_CODE @@ -461,6 +485,18 @@ + + + CURLINFO_PROXYAUTH_USED + (int) + + + + 前回のリクエストで実際に使用したプロキシ認証方法を示すビットマスク。 + PHP 8.5.0 以降 および cURL 8.12.0 以降で利用可能です。 + + + CURLINFO_PROXY_ERROR @@ -489,6 +525,19 @@ + + + CURLINFO_QUEUE_TIME_T + (int) + + + + CURLMOPT_MAX_TOTAL_CONNECTIONS や類似のオプションで設定された制限により、 + 転送が開始される前に待機キューで保留されていた時間(マイクロ秒単位)。 + PHP 8.5.0 以降 および cURL 8.6.0 以降で利用可能です。 + + + CURLINFO_REDIRECT_COUNT @@ -810,6 +859,19 @@ + + + CURLINFO_USED_PROXY + (int) + + + + 前回の転送でプロキシを使用したかどうか。プロキシを使用した場合は 1 を、 + 使用しなかった場合は 0 を返します。 + PHP 8.5.0 以降 および cURL 8.7.0 以降で利用可能です。 + + + CURLINFO_POSTTRANSFER_TIME_T diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index 40f43b7966..9eb3c31f07 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -1,6 +1,6 @@ - + <function>curl_setopt</function> @@ -1367,6 +1367,20 @@ + + + CURLOPT_INFILESIZE_LARGE + (int) + + + + リモートサイトにファイルをアップロードする際のファイルの予想サイズ (バイト単位) を指定します。 + これは CURLOPT_INFILESIZE の 64 ビット版で、 + 2 GB を超えるサイズを指定できます。 + PHP 8.5.0 以降で利用可能です。 + + + CURLOPT_INTERFACE diff --git a/reference/filter/book.xml b/reference/filter/book.xml index e38093953d..99dc7e0797 100644 --- a/reference/filter/book.xml +++ b/reference/filter/book.xml @@ -1,6 +1,6 @@ - + データのフィルタリング @@ -59,6 +59,9 @@ &reference.filter.examples; &reference.filter.reference; + &reference.filter.filter.filterexception; + &reference.filter.filter.filterfailedexception; + - + @@ -159,6 +159,26 @@ + + + FILTER_THROW_ON_FAILURE + (int) + + + + 検証フィルタが失敗した際に、&false; を返す代わりに + Filter\FilterFailedException をスローします。 + + + 任意の検証フィルタ + FILTER_VALIDATE_* + と一緒に使えます。 + + + PHP 8.5.0 以降で利用可能です。 + + + @@ -267,7 +287,7 @@ "1", 2進数、8進数、16進数記法の 1, - 1.0, + 科学的記法を含む 1.0, "true", true, "on", "yes" @@ -276,7 +296,7 @@ "0", 2進数、8進数、16進数記法の 0, - 0.0, + 科学的記法を含む 0.0, "false", false, "off", "no", diff --git a/reference/filter/filter.filterexception.xml b/reference/filter/filter.filterexception.xml new file mode 100644 index 0000000000..52f5740a60 --- /dev/null +++ b/reference/filter/filter.filterexception.xml @@ -0,0 +1,68 @@ + + + + + Filter\FilterException クラス + Filter\FilterException + + +
+ &reftitle.intro; + + Filter 拡張モジュールがスローする例外の基底クラスです。 + +
+ +
+ &reftitle.classsynopsis; + + + Filter + + + + FilterException + + + + extends + Exception + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + + +
+ + + \ No newline at end of file diff --git a/reference/filter/filter.filterfailedexception.xml b/reference/filter/filter.filterfailedexception.xml new file mode 100644 index 0000000000..13333faf1b --- /dev/null +++ b/reference/filter/filter.filterfailedexception.xml @@ -0,0 +1,69 @@ + + + + + Filter\FilterFailedException クラス + Filter\FilterFailedException + + +
+ &reftitle.intro; + + 検証フィルタが失敗し、かつ + FILTER_THROW_ON_FAILURE フラグが設定されている場合にスローされます。 + +
+ +
+ &reftitle.classsynopsis; + + + Filter + + + + FilterFailedException + + + + extends + Filter\FilterException + + + &InheritedProperties; + + + + + &InheritedMethods; + + + + + + + + +
+ + + \ No newline at end of file diff --git a/reference/openssl/constants.xml b/reference/openssl/constants.xml index 25f6d0b9ee..0b94cc1bb2 100644 --- a/reference/openssl/constants.xml +++ b/reference/openssl/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -159,6 +159,18 @@ + + + OPENSSL_PKCS1_PSS_PADDING + (int) + + + + RSA-PSS パディング。 + PHP 8.5.0 以降で利用可能です。 + + + @@ -396,6 +408,46 @@ application/pkcs7-mime を設定します。 + + + PKCS7_NOSMIMECAP + (int) + + + PHP 8.5.0 以降で利用可能です。 + S/MIME の機能 (SMIMECapabilities) を署名に含めません。 + + + + + PKCS7_CRLFEOL + (int) + + + PHP 8.5.0 以降で利用可能です。 + 出力の行末として CRLF を使用します。 + + + + + PKCS7_NOCRL + (int) + + + PHP 8.5.0 以降で利用可能です。 + PKCS7 構造に CRL を含めません。 + + + + + PKCS7_NO_DUAL_CONTENT + (int) + + + PHP 8.5.0 以降で利用可能です。 + 重複したコンテンツを含めないことで、署名済みコンテンツの重複を回避します。 + + From aa5735c37373be7afdce341cd2f7dd4641153fad 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: Thu, 18 Jun 2026 23:10:00 +0900 Subject: [PATCH 2/4] =?UTF-8?q?ReturnTypeWillChange=20=E3=81=AB=E5=B0=86?= =?UTF-8?q?=E6=9D=A5=E3=81=AE=20strict=20=E3=81=AA=E6=88=BB=E3=82=8A?= =?UTF-8?q?=E5=80=A4=E5=9E=8B=E3=81=AB=E9=96=A2=E3=81=99=E3=82=8B=E8=AD=A6?= =?UTF-8?q?=E5=91=8A=E3=82=92=E7=BF=BB=E8=A8=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原文 php/doc-en@0019a7e に追加された、暫定的な戻り値型フェーズに関する警告を翻訳。 --- .../attributes/returntypewillchange.xml | 21 ++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/language/predefined/attributes/returntypewillchange.xml b/language/predefined/attributes/returntypewillchange.xml index ad1ef77419..e8bb40a92f 100644 --- a/language/predefined/attributes/returntypewillchange.xml +++ b/language/predefined/attributes/returntypewillchange.xml @@ -1,6 +1,6 @@ - + ReturnTypeWillChange アトリビュート ReturnTypeWillChange @@ -9,17 +9,32 @@
&reftitle.intro; - + ほとんどの final でない内部メソッドは、 それをオーバライドする際、 互換性がある戻り値の型を宣言することが必須になっています。 そうしない場合、継承が有効かを検証する際に、 推奨されない警告が発生します。 + これは、暫定的な戻り値の型のフェーズを導入するものです。 + つまり、戻り値の型に互換性がない場合、将来のバージョンでそれが強制されるまでは、 + エンジンは致命的なエラーではなく、推奨されない警告を発生させます。 PHP のバージョン間の互換性を保ちたいがために、 戻り値の型を宣言できない場合、 アトリビュート #[\ReturnTypeWillChange] を追加することで警告を抑止できます。 - + + + + + ReturnTypeWillChange アトリビュートが推奨されない警告を抑止するのは、 + 暫定的な戻り値の型のフェーズの間だけです。 + ユーザー定義のクラスで定義されたメソッドをオーバーライドする場合には、何の効果もありません。 + 内部メソッドが strict な型を採用すると、 + オーバーライドするメソッドのシグネチャの不一致は致命的なエラーを引き起こすようになり、 + このアトリビュートは何の効果も持たなくなります。 + + +
From a7151e87c35fcef8033d438afb18a8351f677a7a 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: Thu, 18 Jun 2026 23:10:13 +0900 Subject: [PATCH 3/4] =?UTF-8?q?=E3=82=B5=E3=83=B3=E3=83=97=E3=83=AB?= =?UTF-8?q?=E5=87=BA=E5=8A=9B=E3=81=A8=E3=82=B3=E3=83=BC=E3=83=89=E3=81=AE?= =?UTF-8?q?=E4=B8=8D=E6=95=B4=E5=90=88=E3=81=AE=E4=BF=AE=E6=AD=A3=E3=82=92?= =?UTF-8?q?=E5=8E=9F=E6=96=87=E3=81=AB=E5=90=8C=E6=9C=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原文 php/doc-en#5600 でのサンプル出力 (screen) とコードの不整合修正に追従 (php/doc-en@df78bd1)。 language/oop5 (1), reference/spl (1), reference/datetime (1), reference/uri (1), reference/dom (1), reference/memcached (1), reference/yaf (1), reference/wincache (1) yaf は DocBook 5.2 マークアップ追従 (php/doc-en@4d17b7b) も含む。 --- language/oop5/inheritance.xml | 6 +++--- reference/datetime/functions/mktime.xml | 8 ++++---- reference/dom/domelement/construct.xml | 2 +- reference/memcached/memcached/fetch.xml | 4 ++-- reference/spl/splobjectstorage/rewind.xml | 10 +++++++--- reference/uri/uri/whatwg/url/getquery.xml | 4 ++-- .../wincache/functions/wincache-ucache-delete.xml | 4 ++-- reference/yaf/yaf-config-ini.xml | 4 ++-- 8 files changed, 23 insertions(+), 19 deletions(-) diff --git a/language/oop5/inheritance.xml b/language/oop5/inheritance.xml index dbf2e6033c..ef7920f540 100644 --- a/language/oop5/inheritance.xml +++ b/language/oop5/inheritance.xml @@ -1,6 +1,6 @@ - + オブジェクトの継承 @@ -111,9 +111,9 @@ class Bar extends Foo $foo = new Foo(); $bar = new Bar(); $foo->printItem('baz'); // 出力: 'Foo: baz' -$foo->printPHP(); // 出力: 'PHP is great' +$foo->printPHP(); // 出力: 'PHP is great.' $bar->printItem('baz'); // 出力: 'Bar: baz' -$bar->printPHP(); // 出力: 'PHP is great' +$bar->printPHP(); // 出力: 'PHP is great.' ?> ]]> diff --git a/reference/datetime/functions/mktime.xml b/reference/datetime/functions/mktime.xml index 6661fb320b..eb7588210f 100644 --- a/reference/datetime/functions/mktime.xml +++ b/reference/datetime/functions/mktime.xml @@ -1,6 +1,6 @@ - + @@ -255,11 +255,11 @@ print date('c', $nextyear) . "\n"; 月の末日 - + 指定した月の最後の日は次の月の -1 番目の日ではなく、"0" 番目の日 - として表すことが可能です。以下の例はともに文字列"The last day in + として表すことが可能です。以下の例はともに文字列"Last day in Feb 2000 is: 29" を出力します。 - + - + DOMElement::__construct diff --git a/reference/memcached/memcached/fetch.xml b/reference/memcached/memcached/fetch.xml index 38f586e48f..ee6d969940 100644 --- a/reference/memcached/memcached/fetch.xml +++ b/reference/memcached/memcached/fetch.xml @@ -1,6 +1,6 @@ - + Memcached::fetch @@ -61,7 +61,7 @@ while ($result = $m->fetch()) { array(3) { ["key"]=> string(3) "int" - "value"]=> + ["value"]=> int(99) ["cas"]=> float(2363) diff --git a/reference/spl/splobjectstorage/rewind.xml b/reference/spl/splobjectstorage/rewind.xml index d885d036e2..9b12fe7c67 100644 --- a/reference/spl/splobjectstorage/rewind.xml +++ b/reference/spl/splobjectstorage/rewind.xml @@ -1,6 +1,6 @@ - + SplObjectStorage::rewind @@ -62,8 +62,12 @@ while($s->valid()) { &example.outputs.similar; diff --git a/reference/uri/uri/whatwg/url/getquery.xml b/reference/uri/uri/whatwg/url/getquery.xml index fe50289483..719cb5579b 100644 --- a/reference/uri/uri/whatwg/url/getquery.xml +++ b/reference/uri/uri/whatwg/url/getquery.xml @@ -1,6 +1,6 @@ - + Uri\WhatWg\Url::getQuery @@ -46,7 +46,7 @@ echo $url->getQuery(); &example.outputs; diff --git a/reference/wincache/functions/wincache-ucache-delete.xml b/reference/wincache/functions/wincache-ucache-delete.xml index 60322d9dde..fb597dfbe3 100644 --- a/reference/wincache/functions/wincache-ucache-delete.xml +++ b/reference/wincache/functions/wincache-ucache-delete.xml @@ -1,6 +1,6 @@ - + wincache_ucache_delete @@ -85,7 +85,7 @@ var_dump(wincache_ucache_delete($array2)); string(5) "green" - [1]=> string(4) "Blue" + [1]=> string(4) "blue" [2]=> string(6) "yellow" [3]=> string(4) "cyan" } ]]> diff --git a/reference/yaf/yaf-config-ini.xml b/reference/yaf/yaf-config-ini.xml index e4e4eb9914..ef238cdcaf 100644 --- a/reference/yaf/yaf-config-ini.xml +++ b/reference/yaf/yaf-config-ini.xml @@ -1,6 +1,6 @@ - + @@ -149,7 +149,7 @@ var_dump($config->get("database.params.username")); From 5614fb2f2e7dd9ba4ac7fedf59332b0f6c5c89a3 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: Thu, 18 Jun 2026 23:10:19 +0900 Subject: [PATCH 4/4] =?UTF-8?q?radius=5Fget=5Fvendor=5Fattr()=20=E3=81=AE?= =?UTF-8?q?=E6=88=BB=E3=82=8A=E5=80=A4=E5=9E=8B=E3=83=92=E3=83=B3=E3=83=88?= =?UTF-8?q?=E3=81=AE=E4=BF=AE=E6=AD=A3=E3=82=92=E5=8E=9F=E6=96=87=E3=81=AB?= =?UTF-8?q?=E5=90=8C=E6=9C=9F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 原文 php/doc-en@4047ef2 での戻り値型ヒント修正 (array → array|false) に追従。 --- reference/radius/functions/radius-get-vendor-attr.xml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/reference/radius/functions/radius-get-vendor-attr.xml b/reference/radius/functions/radius-get-vendor-attr.xml index 192d18360f..1821afe5e0 100644 --- a/reference/radius/functions/radius-get-vendor-attr.xml +++ b/reference/radius/functions/radius-get-vendor-attr.xml @@ -1,7 +1,7 @@ - - + + radius_get_vendor_attr ベンダ固有の属性を取得する @@ -10,7 +10,7 @@ &reftitle.description; - arrayradius_get_vendor_attr + arrayfalseradius_get_vendor_attr stringdata