From 562530b1521baad29e411f9f81679099a30b886f 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: Sat, 13 Jun 2026 19:45:29 +0900 Subject: [PATCH 1/2] =?UTF-8?q?doc-en=20=E3=81=A8=E5=90=8C=E6=9C=9F?= =?UTF-8?q?=E3=81=97=20PHP=208.4.0/8.5=20=E3=81=AE=20changelog=E3=83=BB?= =?UTF-8?q?=E5=AE=9A=E6=95=B0=E3=82=92=E5=8F=8D=E6=98=A0=EF=BC=8821?= =?UTF-8?q?=E3=83=95=E3=82=A1=E3=82=A4=E3=83=AB=E3=80=8112=E3=83=A2?= =?UTF-8?q?=E3=82=B8=E3=83=A5=E3=83=BC=E3=83=AB=E5=AE=8C=E8=A8=B3=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit intl・mbstring・phar・session・ldap・openssl・soap・pdo・pdo_mysql・pdo_dblib・readline・mysqli の 12 モジュールを完訳。 ## 翻訳内容 ### reference/intl/idn + reference/mbstring — PHP 8.4.0 changelog（4件） - reference/intl/idn/idn-to-ascii.xml — 空の domain・不正な variant で ValueError をスローする changelog を追加 1. php/doc-en@1be57c2d7d - reference/intl/idn/idn-to-utf8.xml — 同上（idn_to_utf8） 1. php/doc-en@1be57c2d7d - reference/mbstring/functions/mb-substr.xml — 不正な文字列での文字インデックス解釈に関する changelog を追加 1. php/doc-en@1be57c2d7d - reference/mbstring/functions/mb-strcut.xml — 不正な UTF-8/UTF-16 での一貫性改善の changelog を追加 1. php/doc-en@1be57c2d7d ### reference/phar/*/setStub — $length パラメータ・型の同期（2件） - reference/phar/Phar/setStub.xml — $length の説明・非推奨警告・ローダスタブ例を追加 1. php/doc-en@d7056bd094 - reference/phar/PharData/setStub.xml — stub パラメータの型を resource|string に、$length 説明を追加 1. php/doc-en@4c394e560d 2. php/doc-en@d7056bd094 ### reference/session + reference/ldap — PHP 8.4.0 非推奨 changelog（2件） - reference/session/functions/session-set-save-handler.xml — 2 つを超える引数での呼び出しが非推奨の changelog を追加 1. php/doc-en@ca23605a1c - reference/ldap/functions/ldap-connect.xml — 3 つ以上の引数でのコールが非推奨の changelog を追加 1. php/doc-en@ca23605a1c ### 定数ページ session/soap/ldap/openssl — PHP 8.4.0 定数・非推奨（6件） - reference/session/constants.xml — SID 定数の 8.4.0 非推奨警告を追加 1. php/doc-en@7c4e8d8219 - reference/soap/constants.xml — SOAP_FUNCTIONS_ALL の 8.4.0 非推奨 note を追加 1. php/doc-en@7c4e8d8219 - reference/ldap/constants.xml — LDAP_OPT_X_TLS_PROTOCOL_MAX/TLS1_3 を追加、MIN に TLS1_3 を追記 1. php/doc-en@7c4e8d8219 2. php/doc-en@5b3a849352 - reference/ldap/functions/ldap-get-option.xml — option 表に LDAP_OPT_X_TLS_PROTOCOL_MAX を追加 1. php/doc-en@5b3a849352 - reference/ldap/functions/ldap-set-option.xml — 同上 1. php/doc-en@5b3a849352 - reference/openssl/constants.xml — X509_PURPOSE_OCSP_HELPER/TIMESTAMP_SIGN を追加、定数ページの整形をミラー 1. php/doc-en@5208882ce3 2. php/doc-en@7c4e8d8219 3. php/doc-en@5b3a849352 ### reference/pdo* — 定数の型を int から bool に変更（3件） - reference/pdo/constants.xml — ATTR_AUTOCOMMIT/ATTR_EMULATE_PREPARES を bool 化、説明を追加 1. php/doc-en@5d8e96f9b1 - reference/pdo_dblib/pdo-dblib.xml — ATTR_STRINGIFY_UNIQUEIDENTIFIER/ATTR_DATETIME_CONVERT を bool 化 1. php/doc-en@5d8e96f9b1 - reference/pdo_mysql/constants.xml — MYSQL_ATTR_DIRECT_QUERY を bool 化 1. php/doc-en@5d8e96f9b1 ### reference/readline — PHP 8.5 changelog（3件） - reference/readline/functions/readline-add-history.xml — 8.5.0 で戻り値の型が true になった changelog を追加 1. php/doc-en@be246a268d - reference/readline/functions/readline-clear-history.xml — 同上 1. php/doc-en@be246a268d - reference/readline/functions/readline-callback-handler-install.xml — 同上 1. php/doc-en@be246a268d ### 独立ファイル - reference/mysqli/functions/mysqli-execute.xml — mysqli_execute の 8.5.0 非推奨告知を追加（原文で削除済みの旧注記を削除） 1. php/doc-en@d7a97693b4 ## 補足 readline 3 ファイルの 8.5 changelog が参照する `&return.type.true.85;` は、原文側で本同期のコミットで追加されたエンティティです。`ja/language-snippets.ent` には未追加のため、当該行は原文（英語）で表示されます（原文フォールバック層によりビルドは正常）。 --- reference/intl/idn/idn-to-ascii.xml | 17 ++++++++- reference/intl/idn/idn-to-utf8.xml | 17 ++++++++- reference/ldap/constants.xml | 35 +++++++++++++++++-- reference/ldap/functions/ldap-connect.xml | 9 ++++- reference/ldap/functions/ldap-get-option.xml | 7 +++- reference/ldap/functions/ldap-set-option.xml | 7 +++- reference/mbstring/functions/mb-strcut.xml | 8 ++++- reference/mbstring/functions/mb-substr.xml | 11 +++++- reference/mysqli/functions/mysqli-execute.xml | 15 +++----- reference/openssl/constants.xml | 30 ++++++++++++++-- reference/pdo/constants.xml | 20 ++++++++--- reference/pdo_dblib/pdo-dblib.xml | 12 +++++-- reference/pdo_mysql/constants.xml | 8 +++-- reference/phar/Phar/setStub.xml | 34 ++++++++++++------ reference/phar/PharData/setStub.xml | 16 ++++----- .../functions/readline-add-history.xml | 20 ++++++++++- .../readline-callback-handler-install.xml | 19 +++++++++- .../functions/readline-clear-history.xml | 20 ++++++++++- reference/session/constants.xml | 7 +++- .../functions/session-set-save-handler.xml | 26 +++++++++++++- reference/soap/constants.xml | 6 ++-- 21 files changed, 288 insertions(+), 56 deletions(-) diff --git a/reference/intl/idn/idn-to-ascii.xml b/reference/intl/idn/idn-to-ascii.xml index ee0f560a63..95e7ca9e93 100644 --- a/reference/intl/idn/idn-to-ascii.xml +++ b/reference/intl/idn/idn-to-ascii.xml @@ -1,6 +1,6 @@ - + idn_to_ascii @@ -91,6 +91,21 @@ + + 8.4.0 + + domain パラメータが空の場合、 + ValueError をスローするようになりました。 + + + + 8.4.0 + + variant パラメータが + INTL_IDNA_VARIANT_UTS46 でない場合、 + ValueError をスローするようになりました。 + + 7.4.0 diff --git a/reference/intl/idn/idn-to-utf8.xml b/reference/intl/idn/idn-to-utf8.xml index 9c91bd093c..d4a9286bd7 100644 --- a/reference/intl/idn/idn-to-utf8.xml +++ b/reference/intl/idn/idn-to-utf8.xml @@ -1,6 +1,6 @@ - + idn_to_utf8 @@ -91,6 +91,21 @@ + + 8.4.0 + + domain パラメータが空の場合、 + ValueError をスローするようになりました。 + + + + 8.4.0 + + variant パラメータが + INTL_IDNA_VARIANT_UTS46 でない場合、 + ValueError をスローするようになりました。 + + 7.4.0 diff --git a/reference/ldap/constants.xml b/reference/ldap/constants.xml index fe4719908f..4e74829c9f 100644 --- a/reference/ldap/constants.xml +++ b/reference/ldap/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -381,7 +381,26 @@ LDAP_OPT_X_TLS_PROTOCOL_SSL3, LDAP_OPT_X_TLS_PROTOCOL_TLS1_0, LDAP_OPT_X_TLS_PROTOCOL_TLS1_1, - LDAP_OPT_X_TLS_PROTOCOL_TLS1_2 のうちのいずれかです。 + LDAP_OPT_X_TLS_PROTOCOL_TLS1_2, + LDAP_OPT_X_TLS_PROTOCOL_TLS1_3 のうちのいずれかです。 + + + + + + LDAP_OPT_X_TLS_PROTOCOL_MAX + (int) + + + + プロトコルの最大バージョン。 + LDAP_OPT_X_TLS_PROTOCOL_SSL2, + LDAP_OPT_X_TLS_PROTOCOL_SSL3, + LDAP_OPT_X_TLS_PROTOCOL_TLS1_0, + LDAP_OPT_X_TLS_PROTOCOL_TLS1_1, + LDAP_OPT_X_TLS_PROTOCOL_TLS1_2, + LDAP_OPT_X_TLS_PROTOCOL_TLS1_3 のうちのいずれかです。 + PHP 8.4.0 以降で利用可能です。 @@ -1166,6 +1185,18 @@ + + + LDAP_OPT_X_TLS_PROTOCOL_TLS1_3 + (int) + + + + TLS 1.3 プロトコル。 + PHP 8.4.0 以降で利用可能です。 + + + diff --git a/reference/ldap/functions/ldap-connect.xml b/reference/ldap/functions/ldap-connect.xml index 3c1eae33c5..2fe1efb052 100644 --- a/reference/ldap/functions/ldap-connect.xml +++ b/reference/ldap/functions/ldap-connect.xml @@ -1,6 +1,6 @@ - + @@ -110,6 +110,13 @@ + + 8.4.0 + + ldap_connect を、 + 3 つ以上の引数でコールすることは、推奨されなくなりました。 + + 8.3.0 diff --git a/reference/ldap/functions/ldap-get-option.xml b/reference/ldap/functions/ldap-get-option.xml index 2fcca9fc55..c3fa8cb7d8 100644 --- a/reference/ldap/functions/ldap-get-option.xml +++ b/reference/ldap/functions/ldap-get-option.xml @@ -1,6 +1,6 @@ - + @@ -203,6 +203,11 @@ int 7.1 + + LDAP_OPT_X_TLS_PROTOCOL_MAX + int + 8.4 + LDAP_OPT_X_TLS_RANDOM_FILE string diff --git a/reference/ldap/functions/ldap-set-option.xml b/reference/ldap/functions/ldap-set-option.xml index 893b8daaf9..2217053800 100644 --- a/reference/ldap/functions/ldap-set-option.xml +++ b/reference/ldap/functions/ldap-set-option.xml @@ -1,6 +1,6 @@ - + @@ -183,6 +183,11 @@ int PHP 7.1.0 + + LDAP_OPT_X_TLS_PROTOCOL_MAX + int + PHP 8.4.0 + LDAP_OPT_X_TLS_RANDOM_FILE string diff --git a/reference/mbstring/functions/mb-strcut.xml b/reference/mbstring/functions/mb-strcut.xml index a31f250fd2..2bbe744488 100644 --- a/reference/mbstring/functions/mb-strcut.xml +++ b/reference/mbstring/functions/mb-strcut.xml @@ -1,6 +1,6 @@ - + @@ -108,6 +108,12 @@ + + 8.4.0 + + 不正な UTF-8 および UTF-16 文字列に対する挙動が、より一貫したものになりました。 + + &mbstring.changelog.encoding-nullable; diff --git a/reference/mbstring/functions/mb-substr.xml b/reference/mbstring/functions/mb-substr.xml index 1aba5f20ed..b37e48eb07 100644 --- a/reference/mbstring/functions/mb-substr.xml +++ b/reference/mbstring/functions/mb-substr.xml @@ -1,6 +1,6 @@ - + @@ -93,6 +93,15 @@ + + 8.4.0 + + 不正な文字列（エンコーディングエラーを含むもの）に対しては、 + 他のほとんどの mbstring 関数と同じように文字インデックスが解釈されるようになりました。 + つまり、mb_strpos が返す文字インデックスを + 直接渡せるようになりました。 + + &mbstring.changelog.encoding-nullable; diff --git a/reference/mysqli/functions/mysqli-execute.xml b/reference/mysqli/functions/mysqli-execute.xml index 7568d91134..e3c470700f 100644 --- a/reference/mysqli/functions/mysqli-execute.xml +++ b/reference/mysqli/functions/mysqli-execute.xml @@ -1,6 +1,6 @@ - + @@ -8,6 +8,10 @@ mysqli_stmt_execute &Alias; + + &warn.deprecated.function-8-5-0; + + &reftitle.description; @@ -15,15 +19,6 @@ - - &reftitle.notes; - - - mysqli_execute は非推奨で、廃止予定です。 - - - - &reftitle.seealso; diff --git a/reference/openssl/constants.xml b/reference/openssl/constants.xml index 81abd143c3..25f6d0b9ee 100644 --- a/reference/openssl/constants.xml +++ b/reference/openssl/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -85,6 +85,30 @@ + + + X509_PURPOSE_OCSP_HELPER + (int) + + + + OCSP レスポンダのヘルパーとして利用できるか証明書を検証します。 + PHP 8.4.0 以降で利用可能です。 + + + + + + X509_PURPOSE_TIMESTAMP_SIGN + (int) + + + + 信頼されたタイムスタンプの署名者として利用できるか証明書を検証します。 + PHP 8.4.0 以降で利用可能です。 + + + @@ -165,8 +189,8 @@ - OPENSSL_KEYTYPE_DH - (int) + OPENSSL_KEYTYPE_DH + (int) diff --git a/reference/pdo/constants.xml b/reference/pdo/constants.xml index d7a11b0c45..a35345336e 100644 --- a/reference/pdo/constants.xml +++ b/reference/pdo/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -230,13 +230,17 @@ PDO::ATTR_AUTOCOMMIT - (int) + (bool) この値が &false; の場合、PDO は接続がトランザクションを開始できるように オートコミットを無効にしようとします。 + + PHP 8.4.0 以降、この定数は bool として型付けされています。 + それ以前は、int として型付けされていました。 + @@ -495,11 +499,19 @@ PDO::ATTR_EMULATE_PREPARES - (int) + (bool) - + プリペアドステートメントのエミュレーションを有効にするか無効にするかを指定します。 + ドライバの中には、ネイティブのプリペアドステートメントをサポートしていないものや、 + 限定的にしかサポートしていないものがあります。&true; が設定された場合、 + PDO は常にプリペアドステートメントをエミュレートします。&false; が設定された場合、 + ドライバのネイティブなプリペアドステートメントを使用します。 + + + PHP 8.4.0 以降、この定数は bool として型付けされています。 + それ以前は、int として型付けされていました。 diff --git a/reference/pdo_dblib/pdo-dblib.xml b/reference/pdo_dblib/pdo-dblib.xml index 513210cf2e..44bf5fd6a1 100644 --- a/reference/pdo_dblib/pdo-dblib.xml +++ b/reference/pdo_dblib/pdo-dblib.xml @@ -1,6 +1,6 @@ - + Pdo\Dblib クラス @@ -54,7 +54,7 @@ public const - int + bool Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER @@ -78,7 +78,7 @@ public const - int + bool Pdo\Dblib::ATTR_DATETIME_CONVERT @@ -116,6 +116,8 @@ Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER + PHP 8.4.0 以降、この定数は bool として型付けされています。 + それ以前は、int として型付けされていました。 @@ -152,6 +154,10 @@ フォーマットあるいはロケールのフォーマットを使って文字列に変換します。 デフォルトでは、この属性は &false; です。 + + PHP 8.4.0 以降、この定数は bool として型付けされています。 + それ以前は、int として型付けされていました。 + diff --git a/reference/pdo_mysql/constants.xml b/reference/pdo_mysql/constants.xml index 47e2a8b6ad..579db8b0e7 100644 --- a/reference/pdo_mysql/constants.xml +++ b/reference/pdo_mysql/constants.xml @@ -1,6 +1,6 @@ - +
&reftitle.constants; @@ -87,12 +87,16 @@ PDO::MYSQL_ATTR_DIRECT_QUERY - (int) + (bool) PDO::ATTR_EMULATE_PREPARES &Alias; + + PHP 8.4.0 以降、この定数は bool として型付けされています。 + それ以前は、int として型付けされていました。 + diff --git a/reference/phar/Phar/setStub.xml b/reference/phar/Phar/setStub.xml index aeffca52a3..af40ad280b 100644 --- a/reference/phar/Phar/setStub.xml +++ b/reference/phar/Phar/setStub.xml @@ -1,6 +1,6 @@ - + @@ -16,7 +16,6 @@ &phar.write; - このメソッドを使用して、新しい Phar アーカイブに PHP 起動ローダスタブを追加します。あるいは、既存の @@ -25,14 +24,20 @@ Phar アーカイブのローダスタブは、 このようにアーカイブを直接インクルードした際に使用されます。 - - - + - ]]> - + ]]> + + あるいは、単にこのように実行した際にも使用されます。 + + + + phar ストリームラッパーを使用して次のようにファイルをインクルードした際には、 ローダにはアクセスしません。 @@ -63,9 +68,16 @@ include 'phar://myphar.phar/somefile.php'; length - - - + + stub の長さ（バイト単位）。 + + + + 第一引数に &resource; を指定して length 引数を渡すことは、 + PHP 8.3.0 以降では非推奨です。 + かわりに $phar->setStub(stream_get_contents($resource)) を使ってください。 + + @@ -127,12 +139,14 @@ include 'phar://myphar.phar/somefile.php'; setStub(''); include 'phar://brandnewphar.phar/a.php'; var_dump($p->getStub()); + $p['b.php'] = 'setStub(''); include 'phar://brandnewphar.phar/b.php'; diff --git a/reference/phar/PharData/setStub.xml b/reference/phar/PharData/setStub.xml index ac925ccfa1..cbfb9314bf 100644 --- a/reference/phar/PharData/setStub.xml +++ b/reference/phar/PharData/setStub.xml @@ -1,6 +1,6 @@ - + @@ -11,7 +11,7 @@ &reftitle.description; public truePharData::setStub - stringstub + resourcestringstub intlength-1 @@ -29,19 +29,19 @@ stub - - 文字列あるいはオープンしたストリームハンドル。 + + 形式上は、文字列あるいはオープンしたストリームハンドル。 この phar アーカイブの実行スタブとして使用します。 このパラメータは無視されます。 - + length - - - + + stub のバイト数。このパラメータは無視されます。 + diff --git a/reference/readline/functions/readline-add-history.xml b/reference/readline/functions/readline-add-history.xml index 87ffbbafe5..1aacfee0cb 100644 --- a/reference/readline/functions/readline-add-history.xml +++ b/reference/readline/functions/readline-add-history.xml @@ -1,6 +1,6 @@ - + @@ -39,6 +39,24 @@ &return.true.always; + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &return.type.true.85; + + + + + - + readline_callback_handler_install @@ -62,6 +62,23 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &return.type.true.85; + + + + + &reftitle.examples; diff --git a/reference/readline/functions/readline-clear-history.xml b/reference/readline/functions/readline-clear-history.xml index fb93730ecb..ccad609c20 100644 --- a/reference/readline/functions/readline-clear-history.xml +++ b/reference/readline/functions/readline-clear-history.xml @@ -1,6 +1,6 @@ - + @@ -30,6 +30,24 @@ &return.true.always; + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + &return.type.true.85; + + + + + - + &reftitle.constants; @@ -17,6 +17,11 @@ セッション ID がセッションクッキーに適切にセットされている場合には空文字列が入る。 これは session_id が返す ID と同一になる。 + + + この定数は PHP 8.4.0 で非推奨となりました。 + + diff --git a/reference/session/functions/session-set-save-handler.xml b/reference/session/functions/session-set-save-handler.xml index 76207ec7ab..d25993b609 100644 --- a/reference/session/functions/session-set-save-handler.xml +++ b/reference/session/functions/session-set-save-handler.xml @@ -1,6 +1,6 @@ - + @@ -280,6 +280,30 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + session_set_save_handler を + 2 つを超える引数で呼び出すことは、非推奨となりました。 + 代わりに 2 引数のシグネチャを使用してください。 + + + + + + + &reftitle.examples; diff --git a/reference/soap/constants.xml b/reference/soap/constants.xml index 34872bcb7a..f12899745e 100644 --- a/reference/soap/constants.xml +++ b/reference/soap/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -64,7 +64,9 @@ (int) 999 - + + PHP 8.4.0 で非推奨となりました。 + From 080c6deb54ebe029c255603bd09fe0707a5195f4 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: Sat, 13 Jun 2026 20:07:31 +0900 Subject: [PATCH 2/2] =?UTF-8?q?language-snippets.ent=20=E3=82=92=E5=90=8C?= =?UTF-8?q?=E6=9C=9F=E3=81=97=20return.type.true.85=20=E3=82=92=E8=BF=BD?= =?UTF-8?q?=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit PHP 8.5 で readline 関数の戻り値型が true 化した changelog 用のエンティティ。原文 php/doc-en@be246a268d で追加され、本 PR の readline 3ファイルが参照する。 --- language-snippets.ent | 9 ++++++++- 1 file changed, 8 insertions(+), 1 deletion(-) diff --git a/language-snippets.ent b/language-snippets.ent index fcddd4bc12..8b726df577 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,6 +1,6 @@ - + @@ -812,6 +812,13 @@ DLL ファイルを PHP のフォルダから Windows のシステムディレ '> + + 8.5.0 + + 戻り値の型が、&true; になりました。これより前のバージョンでは、bool でした。 + +'> +