Skip to content

Commit 0eeec48

Browse files
KentarouTakedaKentarouTakeda
authored
doc-en と同期し PHP 8.4.0/8.5 の changelog・定数を反映（22ファイル、12モジュール完訳） (php#399)
* doc-en と同期し PHP 8.4.0/8.5 の changelog・定数を反映（21ファイル、12モジュール完訳） 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` には未追加のため、当該行は原文（英語）で表示されます（原文フォールバック層によりビルドは正常）。 * language-snippets.ent を同期し return.type.true.85 を追加 PHP 8.5 で readline 関数の戻り値型が true 化した changelog 用のエンティティ。原文 php/doc-en@be246a268d で追加され、本 PR の readline 3ファイルが参照する。
1 parent cb30b19 commit 0eeec48

22 files changed

Lines changed: 296 additions & 57 deletions

‎language-snippets.ent‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 8a910daad2efdfd29acf6766be8bca7c32c3dd2a Maintainer: takagi Status: working -->
3+
<!-- EN-Revision: be246a268d0d5ab0b215c429cb031e70c98327ef Maintainer: takagi Status: working -->
44
<!-- Credits: hirokawa,haruki,shimooka,mumumu,jdkfx -->
55

66
<!ENTITY installation.enabled.disable 'この拡張モジュールはデフォルトで有効になっています。無効にしたい場合は、次のオプションを指定してコンパイルします。'>
@@ -812,6 +812,13 @@ DLL ファイルを PHP のフォルダから Windows のシステムディレ
812812
</entry>
813813
</row>'>
814814

815+
<!ENTITY return.type.true.85 '<row xmlns="http://docbook.org/ns/docbook">
816+
<entry>8.5.0</entry>
817+
<entry>
818+
戻り値の型が、&true; になりました。これより前のバージョンでは、<type>bool</type> でした。
819+
</entry>
820+
</row>'>
821+
815822
<!ENTITY return.falseforfailure '失敗した場合に &false; を返します'>
816823
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; の場合は、失敗したときに &false; を返します。'>
817824

‎reference/intl/idn/idn-to-ascii.xml‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: e908bfda98eb9fe16fb2c1b5773f312e5c684ee3 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 1be57c2d7d7306b6167a4305059fe1abe8911699 Maintainer: mumumu Status: ready -->
44
<refentry xml:id="function.idn-to-ascii" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>idn_to_ascii</refname>
@@ -91,6 +91,21 @@
9191
</row>
9292
</thead>
9393
<tbody>
94+
<row>
95+
<entry>8.4.0</entry>
96+
<entry>
97+
<parameter>domain</parameter> パラメータが空の場合、
98+
<exceptionname>ValueError</exceptionname> をスローするようになりました。
99+
</entry>
100+
</row>
101+
<row>
102+
<entry>8.4.0</entry>
103+
<entry>
104+
<parameter>variant</parameter> パラメータが
105+
<constant>INTL_IDNA_VARIANT_UTS46</constant> でない場合、
106+
<exceptionname>ValueError</exceptionname> をスローするようになりました。
107+
</entry>
108+
</row>
94109
<row>
95110
<entry>7.4.0</entry>
96111
<entry>

‎reference/intl/idn/idn-to-utf8.xml‎

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d6aee4a5004f7d532f24c06ea2ab2ac0b91b8664 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 1be57c2d7d7306b6167a4305059fe1abe8911699 Maintainer: mumumu Status: ready -->
44
<refentry xml:id="function.idn-to-utf8" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
66
<refname>idn_to_utf8</refname>
@@ -91,6 +91,21 @@
9191
</row>
9292
</thead>
9393
<tbody>
94+
<row>
95+
<entry>8.4.0</entry>
96+
<entry>
97+
<parameter>domain</parameter> パラメータが空の場合、
98+
<exceptionname>ValueError</exceptionname> をスローするようになりました。
99+
</entry>
100+
</row>
101+
<row>
102+
<entry>8.4.0</entry>
103+
<entry>
104+
<parameter>variant</parameter> パラメータが
105+
<constant>INTL_IDNA_VARIANT_UTS46</constant> でない場合、
106+
<exceptionname>ValueError</exceptionname> をスローするようになりました。
107+
</entry>
108+
</row>
94109
<row>
95110
<entry>7.4.0</entry>
96111
<entry>

‎reference/ldap/constants.xml‎

Lines changed: 33 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 26c2246aacfdbf8a40cc2ceccc71c6d878571120 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 5b3a84935252a553528cb81b3dacb88647b57c7b Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<appendix xml:id="ldap.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
&reftitle.constants;
@@ -381,7 +381,26 @@
381381
<constant>LDAP_OPT_X_TLS_PROTOCOL_SSL3</constant>,
382382
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_0</constant>,
383383
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_1</constant>,
384-
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_2</constant> のうちのいずれかです。
384+
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_2</constant>,
385+
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_3</constant> のうちのいずれかです。
386+
</simpara>
387+
</listitem>
388+
</varlistentry>
389+
<varlistentry xml:id="constant.ldap-opt-x-tls-protocol-max">
390+
<term>
391+
<constant>LDAP_OPT_X_TLS_PROTOCOL_MAX</constant>
392+
(<type>int</type>)
393+
</term>
394+
<listitem>
395+
<simpara>
396+
プロトコルの最大バージョン。
397+
<constant>LDAP_OPT_X_TLS_PROTOCOL_SSL2</constant>,
398+
<constant>LDAP_OPT_X_TLS_PROTOCOL_SSL3</constant>,
399+
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_0</constant>,
400+
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_1</constant>,
401+
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_2</constant>,
402+
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_3</constant> のうちのいずれかです。
403+
PHP 8.4.0 以降で利用可能です。
385404
</simpara>
386405
</listitem>
387406
</varlistentry>
@@ -1166,6 +1185,18 @@
11661185
</simpara>
11671186
</listitem>
11681187
</varlistentry>
1188+
<varlistentry xml:id="constant.ldap-opt-x-tls-protocol-tls1-3">
1189+
<term>
1190+
<constant>LDAP_OPT_X_TLS_PROTOCOL_TLS1_3</constant>
1191+
(<type>int</type>)
1192+
</term>
1193+
<listitem>
1194+
<simpara>
1195+
TLS 1.3 プロトコル。
1196+
PHP 8.4.0 以降で利用可能です。
1197+
</simpara>
1198+
</listitem>
1199+
</varlistentry>
11691200

11701201
</variablelist>
11711202
</appendix>

‎reference/ldap/functions/ldap-connect.xml‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 57c38af2b053068ad0f1dfdead8128b957ccf4f0 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: ca23605a1c0e46b9ec85975c6387528c32a7087f Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<refentry xml:id="function.ldap-connect" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -110,6 +110,13 @@
110110
</row>
111111
</thead>
112112
<tbody>
113+
<row>
114+
<entry>8.4.0</entry>
115+
<entry>
116+
<function>ldap_connect</function> を、
117+
3 つ以上の引数でコールすることは、推奨されなくなりました。
118+
</entry>
119+
</row>
113120
<row>
114121
<entry>8.3.0</entry>
115122
<entry>

‎reference/ldap/functions/ldap-get-option.xml‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 5b3a84935252a553528cb81b3dacb88647b57c7b Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<refentry xml:id="function.ldap-get-option" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -203,6 +203,11 @@
203203
<entry><type>int</type></entry>
204204
<entry>7.1</entry>
205205
</row>
206+
<row>
207+
<entry><constant>LDAP_OPT_X_TLS_PROTOCOL_MAX</constant></entry>
208+
<entry><type>int</type></entry>
209+
<entry>8.4</entry>
210+
</row>
206211
<row>
207212
<entry><constant>LDAP_OPT_X_TLS_RANDOM_FILE</constant></entry>
208213
<entry><type>string</type></entry>

‎reference/ldap/functions/ldap-set-option.xml‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 85d9a34e16732043af52954a069a020b8c30ec50 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 5b3a84935252a553528cb81b3dacb88647b57c7b Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<refentry xml:id="function.ldap-set-option" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -183,6 +183,11 @@
183183
<entry><type>int</type></entry>
184184
<entry>PHP 7.1.0</entry>
185185
</row>
186+
<row>
187+
<entry><constant>LDAP_OPT_X_TLS_PROTOCOL_MAX</constant></entry>
188+
<entry><type>int</type></entry>
189+
<entry>PHP 8.4.0</entry>
190+
</row>
186191
<row>
187192
<entry><constant>LDAP_OPT_X_TLS_RANDOM_FILE</constant></entry>
188193
<entry><type>string</type></entry>

‎reference/mbstring/functions/mb-strcut.xml‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 1be57c2d7d7306b6167a4305059fe1abe8911699 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<refentry xml:id="function.mb-strcut" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -108,6 +108,12 @@
108108
</row>
109109
</thead>
110110
<tbody>
111+
<row>
112+
<entry>8.4.0</entry>
113+
<entry>
114+
不正な <literal>UTF-8</literal> および <literal>UTF-16</literal> 文字列に対する挙動が、より一貫したものになりました。
115+
</entry>
116+
</row>
111117
&mbstring.changelog.encoding-nullable;
112118
</tbody>
113119
</tgroup>

‎reference/mbstring/functions/mb-substr.xml‎

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: 92f1b8b177eb5730382abf9f27bae868f1bb636f Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 1be57c2d7d7306b6167a4305059fe1abe8911699 Maintainer: hirokawa Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="function.mb-substr" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -93,6 +93,15 @@
9393
</row>
9494
</thead>
9595
<tbody>
96+
<row>
97+
<entry>8.4.0</entry>
98+
<entry>
99+
不正な文字列（エンコーディングエラーを含むもの）に対しては、
100+
他のほとんどの mbstring 関数と同じように文字インデックスが解釈されるようになりました。
101+
つまり、<function>mb_strpos</function> が返す文字インデックスを
102+
直接渡せるようになりました。
103+
</entry>
104+
</row>
96105
&mbstring.changelog.encoding-nullable;
97106
</tbody>
98107
</tgroup>

‎reference/mysqli/functions/mysqli-execute.xml‎

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,24 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: bc0556b65588379cb86511d5a0ff8ab4684e1d33 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: d7a97693b4683a8c116ac4ba2e25731f5dcb8890 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="function.mysqli-execute" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
77
<refname>mysqli_execute</refname>
88
<refpurpose><function>mysqli_stmt_execute</function> &Alias;</refpurpose>
99
</refnamediv>
1010

11+
<refsynopsisdiv>
12+
&warn.deprecated.function-8-5-0;
13+
</refsynopsisdiv>
14+
1115
<refsect1 role="description">
1216
&reftitle.description;
1317
<para>
1418
&info.function.alias; <function>mysqli_stmt_execute</function>
1519
</para>
1620
</refsect1>
1721

18-
<refsect1 role="notes">
19-
&reftitle.notes;
20-
<note>
21-
<para>
22-
<function>mysqli_execute</function> は非推奨で、廃止予定です。
23-
</para>
24-
</note>
25-
</refsect1>
26-
2722
<refsect1 role="seealso">
2823
&reftitle.seealso;
2924
<para>

0 commit comments

Comments
 (0)