Skip to content

Commit e71ce5a

Browse files
KentarouTakedaKentarouTakeda
authored
既訳 19 件を英語版の最新に同期 (#362)
## 翻訳内容 ### 従来の乱数関数のグローバル状態に関する警告追加（5件） - reference/array/functions/array-rand.xml — グローバル状態の警告を追加 1. php/doc-en@d6dc2be3c5 - reference/array/functions/shuffle.xml — グローバル状態の警告を追加 1. php/doc-en@d6dc2be3c5 - reference/random/functions/mt-rand.xml — グローバル状態の警告を追加 1. php/doc-en@d6dc2be3c5 - reference/random/functions/rand.xml — グローバル状態の警告を追加 1. php/doc-en@d6dc2be3c5 - reference/strings/functions/str-shuffle.xml — グローバル状態の警告を追加 1. php/doc-en@d6dc2be3c5 ### reference/intl スタブ同期（4件） - reference/intl/intltimezone/createenumeration.xml — メソッドシグネチャの型を更新 1. php/doc-en@f7f861700c - reference/intl/resourcebundle/get.xml — 戻り値の型を更新 1. php/doc-en@f7f861700c - reference/intl/transliterator/geterrorcode.xml — 戻り値の型を更新 1. php/doc-en@f7f861700c - reference/intl/transliterator/geterrormessage.xml — 戻り値の型を更新 1. php/doc-en@f7f861700c ### 独立ファイル - language/oop5/magic.xml — __sleep/__wakeup を __serialize/__unserialize の後に移動、soft-deprecation 警告を追加 1. php/doc-en@8f51247cb4 - language/enumerations.xml — Suit 列挙型に strict inequality check の例を追加 1. php/doc-en@5744be5a4d - appendices/ini.core.xml — disable_functions/disable_classes に回避可能である旨の警告を追加 1. php/doc-en@ef757b033b - appendices/migration81/constants.xml — IMAGETYPE_AVIF 定数を Standard セクションとして追加、セクション順をアルファベット化 1. php/doc-en@f9267d3c90 2. php/doc-en@b3e7b16928 - security/sessions.xml — セッションセキュリティの説明文を改善 1. php/doc-en@c2face03ee - reference/stream/functions/stream-select.xml — microseconds パラメータの挙動説明を修正 1. php/doc-en@a758e79c3b - reference/datetime/datetimeinterface.xml — DATE_ATOM の RFC 番号の typo 修正（3399→3339） 1. php/doc-en@a69d8c2c89 - reference/spl/splfileinfo/getfilename.xml — PHP 5.3 以降正しくなかった出力例を修正 1. php/doc-en@4532dcab5c - reference/pcre/functions/preg-replace.xml — PHP 7.0 で削除済みの `e` 修飾子の説明を削除 1. php/doc-en@79c53e3fa2 - reference/intl/numberformatter/set-attribute.xml — ROUNDING_MODE + ROUND_DOWN のコード例を追加 1. php/doc-en@89b92b42cc
1 parent 6b16123 commit e71ce5a

File tree

19 files changed

+213
-146
lines changed

19 files changed

+213
-146
lines changed

‎appendices/ini.core.xml‎

Lines changed: 13 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: a1ab750f296de54d79fe3749d5c9164b0593d803 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: ef757b033ba1df823b1ac5176ada439effe4cab4 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55

66
<section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -222,6 +222,12 @@
222222
このディレクティブは &php.ini; で設定しなければなりません。
223223
&httpd.conf; では設定できません。
224224
</simpara>
225+
<warning>
226+
<simpara>
227+
このディレクティブは迂回可能であり、共有ホスティング環境における
228+
十分なセキュリティ対策とはみなすべきではありません。
229+
</simpara>
230+
</warning>
225231
</listitem>
226232
</varlistentry>
227233

@@ -244,6 +250,12 @@
244250
このディレクティブは &php.ini; で設定しなければなりません。
245251
&httpd.conf; では設定できません。
246252
</simpara>
253+
<warning>
254+
<simpara>
255+
このディレクティブは迂回可能であり、共有ホスティング環境における
256+
十分なセキュリティ対策とはみなすべきではありません。
257+
</simpara>
258+
</warning>
247259
</listitem>
248260
</varlistentry>
249261

‎appendices/migration81/constants.xml‎

Lines changed: 11 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: e251b5cfdb995dfac897b7f9ed9aa8194f8dc50f Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: b3e7b16928a4aee2711ea7e27a0a1036d669c74e Maintainer: mumumu Status: ready -->
44
<sect1 xml:id="migration81.constants" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<title>新しいグローバル定数</title>
66

@@ -148,6 +148,16 @@
148148
</itemizedlist>
149149
</sect2>
150150

151+
<sect2 xml:id="migration81.constants.standard">
152+
<title>標準ライブラリ</title>
153+
154+
<itemizedlist>
155+
<listitem>
156+
<simpara><constant>IMAGETYPE_AVIF</constant></simpara>
157+
</listitem>
158+
</itemizedlist>
159+
</sect2>
160+
151161
<sect2 xml:id="migration81.constants.tokenizer">
152162
<title>Tokenizer</title>
153163

‎language/enumerations.xml‎

Lines changed: 3 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: 2e5f2910f3a2a95dcbdaf580ba57a0b60b072c2a Maintainer: mumumu Status: ready -->
3+
<!-- EN-Revision: 5744be5a4d239c18d4610581bd32b69a7d82947e Maintainer: mumumu Status: ready -->
44
<chapter xml:id="language.enumerations" xmlns="http://docbook.org/ns/docbook">
55
<title>列挙型(Enum)</title>
66
<sect1 xml:id="language.enumerations.overview">
@@ -121,6 +121,8 @@ $b = Suit::Spades;
121121
$a === $b; // true
122122
123123
$a instanceof Suit; // true
124+
125+
$a !== 'Spades'; // true
124126
?>
125127
]]>
126128
</programlisting>

‎language/oop5/magic.xml‎

Lines changed: 111 additions & 101 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: 5e15a6c3e4d5819102361ae78e73c90a06238c8a Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: 8f51247cb4631b29686f867bd904dfe5b2678074 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55

66
<sect1 xml:id="language.oop5.magic" xmlns="http://docbook.org/ns/docbook">
@@ -29,10 +29,10 @@
2929
<link linkend="object.set">__set()</link>,
3030
<link linkend="object.isset">__isset()</link>,
3131
<link linkend="object.unset">__unset()</link>,
32-
<link linkend="object.sleep">__sleep()</link>,
33-
<link linkend="object.wakeup">__wakeup()</link>,
3432
<link linkend="object.serialize">__serialize()</link>,
3533
<link linkend="object.unserialize">__unserialize()</link>,
34+
<link linkend="object.sleep">__sleep()</link>,
35+
<link linkend="object.wakeup">__wakeup()</link>,
3636
<link linkend="object.tostring">__toString()</link>,
3737
<link linkend="object.invoke">__invoke()</link>,
3838
<link linkend="object.set-state">__set_state()</link>,
@@ -71,104 +71,6 @@
7171
</para>
7272
</warning>
7373

74-
<sect2 xml:id="language.oop5.magic.sleep">
75-
<title>
76-
<link linkend="object.sleep">__sleep()</link> と
77-
<link linkend="object.wakeup">__wakeup()</link>
78-
</title>
79-
80-
<methodsynopsis xml:id="object.sleep">
81-
<modifier>public</modifier> <type>array</type><methodname>__sleep</methodname>
82-
<void/>
83-
</methodsynopsis>
84-
<methodsynopsis xml:id="object.wakeup">
85-
<modifier>public</modifier> <type>void</type><methodname>__wakeup</methodname>
86-
<void/>
87-
</methodsynopsis>
88-
89-
<para>
90-
<function>serialize</function> は、クラスに特殊な名前
91-
<link linkend="object.sleep">__sleep()</link> の関数があるかどうかを調べます。
92-
もしあれば、シリアル化の前にその関数を実行します。
93-
この関数で、オブジェクトをクリアすることができます。
94-
またこの関数は、シリアル化するオブジェクトについて、
95-
すべての変数の名前を配列で返すことが前提となっています。
96-
このメソッドが何も返さなかった場合は、&null;
97-
がシリアル化され、<constant>E_NOTICE</constant> が発生します。
98-
</para>
99-
<note>
100-
<para>
101-
<link linkend="object.sleep">__sleep()</link> で、親クラスの private
102-
プロパティの名前を返すことはできません。
103-
そうしようとすると <constant>E_NOTICE</constant> レベルのエラーとなります。
104-
この場合は、<link linkend="object.serialize">__serialize()</link> を代わりに使って下さい。
105-
</para>
106-
</note>
107-
<note>
108-
<para>
109-
PHP 8.0.0 以降では、
110-
<link linkend="object.sleep">__sleep()</link> から配列でない値を返すと、
111-
E_WARNING が発生するようになりました。これより前のバージョンでは、
112-
E_NOTICE が発生していました。
113-
</para>
114-
</note>
115-
<para>
116-
典型的な <link linkend="object.sleep">__sleep()</link> の使用法は、
117-
途中のデータをコミットしたり、
118-
似たようなタスクのクリアを行うといったものです。
119-
また、オブジェクトが非常に大きく、かつ、完全に保存する必要がない場合、
120-
この関数が有用です。
121-
</para>
122-
<para>
123-
逆に、<function>unserialize</function> は、
124-
特殊な名前 <link linkend="object.wakeup">__wakeup()</link> を有する
125-
関数の存在を調べます。
126-
もし存在する場合、この関数は、オブジェクトが有する可能性が
127-
あるあらゆるリソースを再構築することができます。
128-
</para>
129-
<para>
130-
<link linkend="object.wakeup">__wakeup()</link> の使用目的は、
131-
シリアル化の際に失われたデータベース接続を再度確立したり、
132-
その他の再初期化を行うことです。
133-
</para>
134-
<example>
135-
<title>sleep と wakeup</title>
136-
<programlisting role="php">
137-
<![CDATA[
138-
<?php
139-
class Connection
140-
{
141-
protected $link;
142-
private $dsn, $username, $password;
143-
144-
public function __construct($dsn, $username, $password)
145-
{
146-
$this->dsn = $dsn;
147-
$this->username = $username;
148-
$this->password = $password;
149-
$this->connect();
150-
}
151-
152-
private function connect()
153-
{
154-
$this->link = new PDO($this->dsn, $this->username, $this->password);
155-
}
156-
157-
public function __sleep()
158-
{
159-
return array('dsn', 'username', 'password');
160-
}
161-
162-
public function __wakeup()
163-
{
164-
$this->connect();
165-
}
166-
}?>
167-
]]>
168-
</programlisting>
169-
</example>
170-
</sect2>
171-
17274
<sect2 xml:id="language.oop5.magic.serialize">
17375
<title>
17476
<link linkend="object.serialize">__serialize()</link> と
@@ -273,6 +175,114 @@ class Connection
273175
</example>
274176
</sect2>
275177

178+
<sect2 xml:id="language.oop5.magic.sleep">
179+
<title>
180+
<link linkend="object.sleep">__sleep()</link> と
181+
<link linkend="object.wakeup">__wakeup()</link>
182+
</title>
183+
184+
<warning>
185+
<simpara>
186+
このシリアル化の仕組みは、PHP 8.5.0 以降 soft-deprecated 扱いになりました。
187+
後方互換性のために維持されていますが、新規コードおよび既存コードは、代わりに
188+
<link linkend="object.serialize">__serialize()</link> と
189+
<link linkend="object.unserialize">__unserialize()</link>
190+
マジックメソッドを使うように移行すべきです。
191+
</simpara>
192+
</warning>
193+
194+
<methodsynopsis xml:id="object.sleep">
195+
<modifier>public</modifier> <type>array</type><methodname>__sleep</methodname>
196+
<void/>
197+
</methodsynopsis>
198+
<methodsynopsis xml:id="object.wakeup">
199+
<modifier>public</modifier> <type>void</type><methodname>__wakeup</methodname>
200+
<void/>
201+
</methodsynopsis>
202+
203+
<para>
204+
<function>serialize</function> は、クラスに特殊な名前
205+
<link linkend="object.sleep">__sleep()</link> の関数があるかどうかを調べます。
206+
もしあれば、シリアル化の前にその関数を実行します。
207+
この関数で、オブジェクトをクリアすることができます。
208+
またこの関数は、シリアル化するオブジェクトについて、
209+
すべての変数の名前を配列で返すことが前提となっています。
210+
このメソッドが何も返さなかった場合は、&null;
211+
がシリアル化され、<constant>E_NOTICE</constant> が発生します。
212+
</para>
213+
<note>
214+
<para>
215+
<link linkend="object.sleep">__sleep()</link> で、親クラスの private
216+
プロパティの名前を返すことはできません。
217+
そうしようとすると <constant>E_NOTICE</constant> レベルのエラーとなります。
218+
この場合は、<link linkend="object.serialize">__serialize()</link> を代わりに使って下さい。
219+
</para>
220+
</note>
221+
<note>
222+
<para>
223+
PHP 8.0.0 以降では、
224+
<link linkend="object.sleep">__sleep()</link> から配列でない値を返すと、
225+
E_WARNING が発生するようになりました。これより前のバージョンでは、
226+
E_NOTICE が発生していました。
227+
</para>
228+
</note>
229+
<para>
230+
典型的な <link linkend="object.sleep">__sleep()</link> の使用法は、
231+
途中のデータをコミットしたり、
232+
似たようなタスクのクリアを行うといったものです。
233+
また、オブジェクトが非常に大きく、かつ、完全に保存する必要がない場合、
234+
この関数が有用です。
235+
</para>
236+
<para>
237+
逆に、<function>unserialize</function> は、
238+
特殊な名前 <link linkend="object.wakeup">__wakeup()</link> を有する
239+
関数の存在を調べます。
240+
もし存在する場合、この関数は、オブジェクトが有する可能性が
241+
あるあらゆるリソースを再構築することができます。
242+
</para>
243+
<para>
244+
<link linkend="object.wakeup">__wakeup()</link> の使用目的は、
245+
シリアル化の際に失われたデータベース接続を再度確立したり、
246+
その他の再初期化を行うことです。
247+
</para>
248+
<example>
249+
<title>sleep と wakeup</title>
250+
<programlisting role="php">
251+
<![CDATA[
252+
<?php
253+
class Connection
254+
{
255+
protected $link;
256+
private $dsn, $username, $password;
257+
258+
public function __construct($dsn, $username, $password)
259+
{
260+
$this->dsn = $dsn;
261+
$this->username = $username;
262+
$this->password = $password;
263+
$this->connect();
264+
}
265+
266+
private function connect()
267+
{
268+
$this->link = new PDO($this->dsn, $this->username, $this->password);
269+
}
270+
271+
public function __sleep()
272+
{
273+
return array('dsn', 'username', 'password');
274+
}
275+
276+
public function __wakeup()
277+
{
278+
$this->connect();
279+
}
280+
}?>
281+
]]>
282+
</programlisting>
283+
</example>
284+
</sect2>
285+
276286
<sect2 xml:id="language.oop5.magic.tostring">
277287
<title><link linkend="object.tostring">__toString()</link></title>
278288
<methodsynopsis xml:id="object.tostring">

‎reference/array/functions/array-rand.xml‎

Lines changed: 2 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: 4a1dedc24b1e085f298ab1d5dadefe306373691b Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: hirokawa Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -19,6 +19,7 @@
1919
取り出したエントリのキーを返します。
2020
</para>
2121
&caution.cryptographically-insecure;
22+
&caution.mt19937-global-state;
2223
</refsect1>
2324
<refsect1 role="parameters">
2425
&reftitle.parameters;

‎reference/array/functions/shuffle.xml‎

Lines changed: 2 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: f781803449007bb0e3a96c693e0eee067f7eb466 Maintainer: hirokawa Status: ready -->
3+
<!-- EN-Revision: d6dc2be3c5c70e4a1c3d13f788643ea232747c19 Maintainer: hirokawa Status: ready -->
44
<!-- CREDITS: shimooka,mumumu -->
55
<refentry xml:id="function.shuffle" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -17,6 +17,7 @@
1717
この関数は、配列をシャッフル (要素の順番をランダムに) します。
1818
</para>
1919
&caution.cryptographically-insecure;
20+
&caution.mt19937-global-state;
2021
</refsect1>
2122
<refsect1 role="parameters">
2223
&reftitle.parameters;

‎reference/datetime/datetimeinterface.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: 6bbb5b9685d27ac9df744702e06525047a163d4b Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: a69d8c2c891e70c03c33cbe251a208dd7d185af9 Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<reference xml:id="class.datetimeinterface" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
66

@@ -158,7 +158,7 @@
158158
<term><constant>DATE_ATOM</constant></term>
159159
<listitem>
160160
<simpara>
161-
Atom (例: 2005-08-15T15:52:01+00:00)。ISO-8601、RFC 3399、および XML Schema と互換性があります
161+
Atom (例: 2005-08-15T15:52:01+00:00)。ISO-8601、RFC 3339、および XML Schema と互換性があります
162162
</simpara>
163163
</listitem>
164164
</varlistentry>

‎reference/intl/intltimezone/createenumeration.xml‎

Lines changed: 3 additions & 3 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: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: f7f861700c504afc40c14603d0fa0b36629a87ff Maintainer: takagi Status: ready -->
44
<!-- Credits: mumumu -->
55
<refentry xml:id="intltimezone.createenumeration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
66
<refnamediv>
@@ -14,12 +14,12 @@
1414
<para>&style.oop; (method):</para>
1515
<methodsynopsis role="IntlTimeZone">
1616
<modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>IntlIterator</type><type>false</type></type><methodname>IntlTimeZone::createEnumeration</methodname>
17-
<methodparam choice="opt"><type class="union"><type>IntlTimeZone</type><type>string</type><type>int</type><type>float</type><type>null</type></type><parameter>countryOrRawOffset</parameter><initializer>&null;</initializer></methodparam>
17+
<methodparam choice="opt"><type class="union"><type>string</type><type>int</type><type>null</type></type><parameter>countryOrRawOffset</parameter><initializer>&null;</initializer></methodparam>
1818
</methodsynopsis>
1919
<para>&style.procedural;:</para>
2020
<methodsynopsis>
2121
<type class="union"><type>IntlIterator</type><type>false</type></type><methodname>intltz_create_enumeration</methodname>
22-
<methodparam choice="opt"><type class="union"><type>IntlTimeZone</type><type>string</type><type>int</type><type>float</type><type>null</type></type><parameter>countryOrRawOffset</parameter><initializer>&null;</initializer></methodparam>
22+
<methodparam choice="opt"><type class="union"><type>string</type><type>int</type><type>null</type></type><parameter>countryOrRawOffset</parameter><initializer>&null;</initializer></methodparam>
2323
</methodsynopsis>
2424
<para>
2525

0 commit comments

Comments
 (0)