Skip to content

Commit 4a17fef

Browse files
KentarouTakedaKentarouTakeda
authored
language/ と appendices/ を原文に追従（27 ファイル） (#477)
## 翻訳内容 原文の 21 コミットに追従します。同一の原文コミットが複数ファイルにまたがるものは、記述が食い違わないようまとめて対象にしています。 ### language/（11 件） - language/types/string.xml — php/doc-en@0d964bcaac, php/doc-en@eb4bde8a48 - language/oop5/properties.xml — php/doc-en@62e61e543c, php/doc-en@4e77868e15 - language/operators/comparison.xml — php/doc-en@62e61e543c - language/functions.xml — php/doc-en@c19f29d4fc - language/variables.xml — php/doc-en@0e72b54621 - language/exceptions.xml — php/doc-en@62562234f1 - language/predefined/exception/clone.xml — php/doc-en@62562234f1 - language/predefined/traversable.xml — php/doc-en@14013fe63d - language/predefined/iterator/rewind.xml — php/doc-en@f0a5e4f7d3 - language/control-structures/foreach.xml — php/doc-en@0d9947f2b1 - language/generators.xml — php/doc-en@a8c1fc582e ### appendices/（9 件） - appendices/userlandnaming.xml — php/doc-en@077012fff2 - appendices/reserved.xml — php/doc-en@4f7e802196 - appendices/reserved.constants.core.xml — php/doc-en@5a91c9a81e - appendices/tokens.xml — php/doc-en@5a91c9a81e - appendices/configure/misc.xml — php/doc-en@6670935325 - appendices/migration72/incompatible.xml — php/doc-en@5e26d11dc3 - appendices/migration82/other-changes.xml — php/doc-en@e4666d5274 - appendices/migration84/incompatible.xml — php/doc-en@b2acdf5697, php/doc-en@5c52e84d0c - appendices/migration84/other-changes.xml — php/doc-en@66bf3dcc38 ### reference/（7 件） 原文の同一コミットが appendices/ と同時に変更しているため、記述が食い違わないよう同じ PR に含めています。 - reference/array/functions/array-unique.xml — php/doc-en@47cbf365f5, php/doc-en@5e26d11dc3 - reference/var/functions/unserialize.xml — php/doc-en@b2acdf5697 - reference/info/ini.xml — php/doc-en@6670935325 - reference/intl/book.xml — php/doc-en@66bf3dcc38 - reference/mbstring/book.xml — php/doc-en@5c52e84d0c - reference/mbstring/functions/mb-strstr.xml — php/doc-en@5c52e84d0c - reference/mbstring/functions/mb-substr.xml — php/doc-en@5c52e84d0c ### その他 - reference/intl/book.xml は EN-Revision の範囲に php/doc-en@a03f9eda2d を含みます。半角スペースの追加のみで、該当箇所の訳文には対応する要素がないため反映していません。
1 parent 040d22c commit 4a17fef

27 files changed

Lines changed: 371 additions & 154 deletions

File tree

‎appendices/configure/misc.xml‎

Lines changed: 23 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: 4c676dacf58ff5d779eed96739ab4660204cbe7f Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 667093532547bcfe6224765f038c151c61f30f48 Maintainer: takagi Status: ready -->
44
<sect3 xml:id="configure.options.misc" xmlns="http://docbook.org/ns/docbook">
55
<title>一般的なオプション</title>
66
<variablelist>
@@ -49,6 +49,28 @@
4949
</listitem>
5050
</varlistentry>
5151

52+
<varlistentry xml:id="configure.enable-zend-max-execution-timers">
53+
<term>
54+
<option role="configure">--enable-zend-max-execution-timers</option>
55+
</term>
56+
<listitem>
57+
<simpara>
58+
<link linkend="ini.max-execution-time">max_execution_time</link>
59+
の計測に、プロセス全体に作用する <literal>setitimer()</literal>
60+
ではなく、POSIX のスレッドごとのタイマーを使用します。
61+
これらのタイマーが計測するのは経過時間
62+
(<literal>CLOCK_BOOTTIME</literal>、FreeBSD では
63+
<literal>CLOCK_MONOTONIC</literal>) であり、デフォルトの
64+
<literal>setitimer(ITIMER_PROF)</literal> が計測する CPU 時間とは
65+
異なります。そのため、スリープや I/O 待ちに費やした時間も
66+
制限時間に加算されます。
67+
<literal>timer_create()</literal> のサポートが必要です。
68+
Linux で使用でき、FreeBSD では PHP 8.4.0 以降で使用できます。
69+
PHP 8.1.0 以降で利用可能です。
70+
PHP 8.3.0 以降、ZTS ビルドではデフォルトで有効になっています。
71+
</simpara>
72+
</listitem>
73+
</varlistentry>
5274
<varlistentry xml:id="configure.enable-sigchild">
5375
<term>
5476
<option role="configure">--enable-sigchild</option>

‎appendices/migration72/incompatible.xml‎

Lines changed: 10 additions & 7 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: 8859c8b96cd9e80652813f7bcf561432a5e9f934 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 5e26d11dc3f606b25c95467df22f9469636781f9 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: mumumu -->
55

66
<sect1 xml:id="migration72.incompatible">
@@ -265,13 +265,16 @@ int(2)
265265
<title><function>array_unique</function> 関数を
266266
<constant>SORT_STRING</constant> と使う場合</title>
267267

268-
<para>
268+
<simpara>
269269
<function>array_unique</function> 関数を <constant>SORT_STRING</constant>
270-
と使う場合、以前は配列をコピーし、重複した要素を削除
271-
(配列を後にパックせずに) していましたが、このバージョンからは
272-
新しい配列作られ、ユニークな要素を追加するようになりました。
273-
これにより、以前のバージョンとは異なった数値のインデックスが生成されます。
274-
</para>
270+
と使う場合、返される配列は、ユニークな要素を新しい配列に追加して構築されます。
271+
以前は、入力の配列をコピーして重複した要素を削除したものでした。
272+
どちらも同じ要素を同じキーで保持します。
273+
ただし、入力の配列の中で整数のキーが最大だった要素が重複として取り除かれた場合、
274+
返される配列に要素を追加したときに生成されるインデックスは、
275+
入力の配列 (訳注: およびこれより前のバージョンの戻り値) に追加したときとは
276+
異なります。
277+
</simpara>
275278
</sect2>
276279

277280
<sect2 xml:id="migration72.incompatible.bcmod-and-floats">

‎appendices/migration82/other-changes.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: b1116af46680f7baf89c46610430a3b63ce9a1f0 Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: e4666d527453044f07c94da5ab51fd5cd4c1a615 Maintainer: mumumu Status: ready -->
44
<sect1 xml:id="migration82.other-changes" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<title>その他の変更</title>
66

@@ -128,6 +128,11 @@
128128
<para>
129129
<classname>DatePeriod</classname> のプロパティが、適切に宣言されるようになりました。
130130
</para>
131+
132+
<simpara>
133+
<link linkend="ini.date.timezone">date.timezone</link> INI 設定が指定されていない場合、
134+
デフォルトのタイムゾーンは UTC にフォールバックします。
135+
</simpara>
131136
</sect3>
132137

133138
<sect3 xml:id="migration82.other-changes.extensions.intl">

‎appendices/migration84/incompatible.xml‎

Lines changed: 9 additions & 9 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: 64dc79d6c9710dddf196aa28e3c5f63b562e7aef Maintainer: KentarouTakeda Status: ready -->
3+
<!-- EN-Revision: 5c52e84d0ce157d8c22f9c582719a14228c5402a Maintainer: KentarouTakeda Status: ready -->
44
<!-- Credits: KentarouTakeda -->
55
<sect1 xml:id="migration84.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<title>下位互換性のない変更点</title>
@@ -407,7 +407,7 @@
407407
<simpara>
408408
<function>unserialize</function> の
409409
<literal>"allowed_classes"</literal> オプションは、
410-
クラス名の <type>array</type> でない場合、
410+
クラス名の <type>array</type> でも <type>bool</type> でもない場合、
411411
<exceptionname>TypeError</exceptionname> および
412412
<exceptionname>ValueError</exceptionname> をスローするようになりました。
413413
</simpara>
@@ -514,19 +514,19 @@
514514
<title>MBString</title>
515515

516516
<simpara>
517-
無効な文字列(エンコーディングエラーを含む)に対して、
518-
<function>mb_substr</function> は他の多くの mbstring 関数と同様に、
519-
文字インデックスを解釈するようになりました。
517+
PHP 8.3.2 以降、無効な文字列(エンコーディングエラーを含む)に対して、
518+
<function>mb_substr</function> と <function>mb_strstr</function> は
519+
他の多くの mbstring 関数と同様に、文字インデックスを解釈するようになりました。
520520
これにより、<function>mb_strpos</function> が返す文字インデックスを
521521
<function>mb_substr</function> に渡すことができます。
522522
</simpara>
523523

524524
<simpara>
525-
SJIS-Mac(MacJapanese) 文字列の場合、<function>mb_substr</function>
526-
に渡される文字インデックスは、文字列が Unicode に変換されたときに生成される
525+
<literal>SJIS-mac</literal> (MacJapanese) 文字列の場合、
526+
これらの文字インデックスは、文字列が Unicode に変換されたときに生成される
527527
Unicode コードポイントのインデックスを参照します。
528-
これは、 SJIS-Mac の約40文字が複数の Unicode コードポイントの
529-
シーケンスに変換されることによる重要な処理です。
528+
これらは、複数のコードポイントのシーケンスに変換される
529+
<literal>SJIS-mac</literal> 文字の文字インデックスとは異なります。
530530
</simpara>
531531
</sect2>
532532

‎appendices/migration84/other-changes.xml‎

Lines changed: 8 additions & 4 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: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: KentarouTakeda Status: ready -->
3+
<!-- EN-Revision: 66bf3dcc3870f91bda607fe90717a8291d195236 Maintainer: KentarouTakeda Status: ready -->
44
<!-- Credits: KentarouTakeda -->
55
<sect1 xml:id="migration84.other-changes">
66
<title>その他の変更</title>
@@ -550,9 +550,13 @@
550550
<title>Intl</title>
551551

552552
<simpara>
553-
Intl クラスの動作が統一され、
554-
初期化されていないオブジェクトを使用しようとした場合やクローンに失敗した場合に、
555-
<exceptionname>Error</exceptionname> 例外をスローするようになりました。
553+
Intl オブジェクトをクローンできない場合、
554+
すなわちオブジェクトが初期化されていないか、
555+
内部の ICU のクローン操作が失敗したときには、
556+
一貫して <exceptionname>Error</exceptionname> がスローされるようになりました。
557+
以前は、これらのクラスのほとんどは代わりに
558+
<exceptionname>Exception</exceptionname> をスローし、
559+
<classname>Spoofchecker</classname> は致命的なエラーを発生させていました。
556560
</simpara>
557561
</sect3>
558562

‎appendices/reserved.constants.core.xml‎

Lines changed: 10 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: 04250271154f102f7aa1d629665a30fdb670b927 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 5a91c9a81ee5c2560a15f1fca84bc5a6148cca9a Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<sect2 xml:id="reserved.constants.core" xmlns="http://docbook.org/ns/docbook">
66
<title>コアの定義済みの定数</title>
@@ -591,13 +591,21 @@
591591
<constant>E_ALL</constant>
592592
(<type>int</type>)
593593
</term>
594+
<listitem>
595+
<simpara>
596+
<link linkend="errorfunc.constants">エラーを報告する定数</link>。
597+
</simpara>
598+
</listitem>
599+
</varlistentry>
600+
<varlistentry>
594601
<term>
595602
<constant>E_STRICT</constant>
596603
(<type>int</type>)
597604
</term>
598605
<listitem>
599606
<simpara>
600-
<link linkend="errorfunc.constants">エラーを報告する定数</link>
607+
<link linkend="errorfunc.constants">エラーを報告する定数</link>。
608+
この定数は使われておらず、PHP 8.4.0 で非推奨となりました。
601609
</simpara>
602610
</listitem>
603611
</varlistentry>

‎appendices/reserved.xml‎

Lines changed: 6 additions & 12 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: ff9181ea03ac348b2c7ff4ad07896f277cddcb1d Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 4f7e802196f318a9b0305366c248254edeffd6c4 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55

66
<appendix xml:id="reserved" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -21,7 +21,7 @@
2121
これらは言語を構成するものです。
2222
以下のキーワードはいずれも定数、クラス名、
2323
関数名として使用することはできません。
24-
しかし、クラスやインターフェイス、そしてトレイトの内部では、
24+
しかし、クラスやインターフェイス、トレイト、そして列挙型の内部では、
2525
プロパティ、定数、メソッドの名前として使うことができます。
2626
但し、<literal>class</literal> だけは例外で、これを定数名として使うことはできません。
2727
</simpara>
@@ -321,12 +321,6 @@
321321
</entry>
322322
<entry>
323323
</entry>
324-
<entry>
325-
</entry>
326-
<entry>
327-
</entry>
328-
<entry>
329-
</entry>
330324
</row>
331325
</tbody>
332326
</tgroup>
@@ -510,7 +504,7 @@
510504
<sect1 xml:id="reserved.other-reserved-words">
511505
<title>その他の予約語の一覧</title>
512506
<simpara>
513-
これらの名前は、クラスやインターフェイスそしてトレイトの名前として使えません。
507+
これらの名前は、クラスやインターフェイス、トレイト、そして列挙型の名前として使えません。
514508
PHP 8.0 より前のバージョンでは、名前空間の中であっても使えませんでした。
515509
</simpara>
516510
<para>
@@ -578,11 +572,11 @@
578572
</tgroup>
579573
</table>
580574
</para>
581-
<para>
575+
<simpara>
582576
これらの名前は、弱い予約語として確保されています。
583-
クラスやインターフェイスそしてトレイトの名前として使えますが、
577+
クラスやインターフェイス、トレイト、そして列挙型の名前として使えますが、
584578
使わないことを強く推奨します。将来のバージョンの PHP で使われる可能性があるためです。
585-
</para>
579+
</simpara>
586580
<para>
587581
<table>
588582
<title>弱い予約語</title>

‎appendices/tokens.xml‎

Lines changed: 2 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: 5f720ab2b9c8122d1a127684748712fc57a24d06 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 5a91c9a81ee5c2560a15f1fca84bc5a6148cca9a Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: takagi,mumumu -->
55
<appendix xml:id="tokens" xmlns="http://docbook.org/ns/docbook">
66
<title>パーサートークンの一覧</title>
@@ -1068,7 +1068,7 @@ defined('T_FN') || define('T_FN', 10001);
10681068
</entry>
10691069
<entry>__PROPERTY__</entry>
10701070
<entry>
1071-
<link linkend="language.constants.magic">マジック定数</link>
1071+
<link linkend="language.constants.magic">マジック定数</link> (PHP 8.4.0 以降で利用可能)
10721072
</entry>
10731073
</row>
10741074
<row xml:id="constant.t-protected">

0 commit comments

Comments
 (0)