PHP8.4 doc-en#4037とdoc-en#4244を翻訳 (#224)

* PHP 8.4: Document reflection changes を翻訳 php/doc-en#4037 * [PHP 8.4] Add class constant types for Reflection を翻訳 https://github.com/php/doc-en/pull/4244/files * インデント微調整 --------- Co-authored-by: 武田憲太郎 <[email protected]>
php · Dec 23, 2024 · b8ed28c · b8ed28c
1 parent 550b759
commit b8ed28c
Show file tree

Hide file tree

Showing 9 changed files with 291 additions and 33 deletions.
diff --git a/reference/reflection/reflectionattribute.xml b/reference/reflection/reflectionattribute.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 51fc0eaf8ecc894bb567fb7de2de789bec74e257 Maintainer: mumumu Status: ready -->
 <reference xml:id="class.reflectionattribute" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>ReflectionAttribute クラス</title>
@@ -41,6 +41,13 @@
      <varname linkend="reflectionattribute.constants.is-instanceof">ReflectionAttribute::IS_INSTANCEOF</varname>
     </fieldsynopsis>
 
+    <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>public</modifier>
+     <type>string</type>
+     <varname linkend="reflectionattribute.props.name">name</varname>
+    </fieldsynopsis>
+
     <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
     <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.reflectionattribute')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='ReflectionAttribute'])">
      <xi:fallback/>
@@ -53,6 +60,20 @@
 
   </section>
 
+  <section xml:id="reflectionattribute.props">
+   &reftitle.properties;
+   <variablelist>
+    <varlistentry xml:id="reflectionattribute.props.name">
+     <term><varname>name</varname></term>
+     <listitem>
+      <simpara>
+       アトリビュート名。
+      </simpara>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </section>
+
   <!-- {{{ ReflectionAttribute constants -->
   <section xml:id="reflectionattribute.constants">
    &reftitle.constants;
@@ -61,7 +82,10 @@
     <variablelist>
 
      <varlistentry xml:id="reflectionattribute.constants.is-instanceof">
-      <term><constant>ReflectionAttribute::IS_INSTANCEOF</constant></term>
+      <term>
+       <constant>ReflectionAttribute::IS_INSTANCEOF</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         <parameter>instanceof</parameter> のチェックを使い、
@@ -82,6 +106,34 @@
   </section>
   <!-- }}} -->
 
+  <section role="changelog">
+   &reftitle.changelog;
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        すべてのクラス定数が型付けされました。
+       </entry>
+      </row>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        <property>ReflectionAttribute::$name</property> プロパティが追加されました。
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </section>
+
  </partintro>
 
  &reference.reflection.entities.reflectionattribute;

diff --git a/reference/reflection/reflectionclass.xml b/reference/reflection/reflectionclass.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c0fa5077c8862405942d8aac7360c5169558b59b Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 51fc0eaf8ecc894bb567fb7de2de789bec74e257 Maintainer: takagi Status: ready -->
 <reference xml:id="class.reflectionclass" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>ReflectionClass クラス</title>
@@ -116,7 +116,10 @@
     <variablelist>
 
      <varlistentry xml:id="reflectionclass.constants.is-implicit-abstract">
-      <term><constant>ReflectionClass::IS_IMPLICIT_ABSTRACT</constant></term>
+      <term>
+       <constant>ReflectionClass::IS_IMPLICIT_ABSTRACT</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         抽象メソッドを持っているので <link linkend="language.oop5.abstract">
@@ -126,7 +129,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclass.constants.is-explicit-abstract">
-      <term><constant>ReflectionClass::IS_EXPLICIT_ABSTRACT</constant></term>
+      <term>
+       <constant>ReflectionClass::IS_EXPLICIT_ABSTRACT</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         その定義から <link linkend="language.oop5.abstract">
@@ -136,7 +142,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclass.constants.is-final">
-      <term><constant>ReflectionClass::IS_FINAL</constant></term>
+      <term>
+       <constant>ReflectionClass::IS_FINAL</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         <link linkend="language.oop5.final">final</link> クラスであることを示します。
@@ -145,7 +154,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclass.constants.is-readonly">
-      <term><constant>ReflectionClass::IS_READONLY</constant></term>
+      <term>
+       <constant>ReflectionClass::IS_READONLY</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         <link linkend="language.oop5.basic.class.readonly">readonly</link> クラスであることを示します。
@@ -154,7 +166,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclass.constants.skip-initialization-on-serialize">
-      <term><constant>ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE</constant></term>
+      <term>
+       <constant>ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <simpara>
         <function>serialize</function>がレイジーオブジェクトの初期化を
@@ -164,7 +179,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclass.constants.skip-destructor">
-      <term><constant>ReflectionClass::SKIP_DESTRUCTOR</constant></term>
+      <term>
+       <constant>ReflectionClass::SKIP_DESTRUCTOR</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <simpara>
         オブジェクトをレイジーにリセットする時に、
@@ -189,6 +207,12 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        クラス定数が型付けされました。
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>

diff --git a/reference/reflection/reflectionclassconstant.xml b/reference/reflection/reflectionclassconstant.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 51fc0eaf8ecc894bb567fb7de2de789bec74e257 Maintainer: mumumu Status: ready -->
 <reference xml:id="class.reflectionclassconstant" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>ReflectionClassConstant クラス</title>
@@ -116,7 +116,10 @@
     <variablelist>
 
      <varlistentry xml:id="reflectionclassconstant.constants.is-public">
-      <term><constant>ReflectionClassConstant::IS_PUBLIC</constant></term>
+      <term>
+       <constant>ReflectionClassConstant::IS_PUBLIC</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         アクセス権が <link linkend="language.oop5.visibility">public</link> であることを示します。
@@ -126,7 +129,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclassconstant.constants.is-protected">
-      <term><constant>ReflectionClassConstant::IS_PROTECTED</constant></term>
+      <term>
+       <constant>ReflectionClassConstant::IS_PROTECTED</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         アクセス権が <link linkend="language.oop5.visibility">protected</link> であることを示します。
@@ -136,7 +142,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclassconstant.constants.is-private">
-      <term><constant>ReflectionClassConstant::IS_PRIVATE</constant></term>
+      <term>
+       <constant>ReflectionClassConstant::IS_PRIVATE</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         アクセス権が <link linkend="language.oop5.visibility">private</link> であることを示します。
@@ -146,7 +155,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionclassconstant.constants.is-final">
-      <term><constant>ReflectionClassConstant::IS_FINAL</constant></term>
+      <term>
+       <constant>ReflectionClassConstant::IS_FINAL</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         定数が
@@ -180,6 +192,12 @@
      </thead>
      <tbody>
       <row>
+       <entry>8.4.0</entry>
+       <entry>
+        クラス定数が型付けされました。
+       </entry>
+      </row>
+        <row>
        <entry>8.0.0</entry>
        <entry>
         <methodname>ReflectionClassConstant::export</methodname> は、削除されました。

diff --git a/reference/reflection/reflectionfunction.xml b/reference/reflection/reflectionfunction.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 51fc0eaf8ecc894bb567fb7de2de789bec74e257 Maintainer: mumumu Status: ready -->
 <reference xml:id="class.reflectionfunction" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>ReflectionFunction クラス</title>
@@ -69,7 +69,10 @@
     <variablelist>
 
      <varlistentry xml:id="reflectionfunction.constants.is-deprecated">
-      <term><constant>ReflectionFunction::IS_DEPRECATED</constant></term>
+      <term>
+       <constant>ReflectionFunction::IS_DEPRECATED</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         非推奨の関数であることを示します。
@@ -93,6 +96,12 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        クラス定数が型付けされました。
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>

diff --git a/reference/reflection/reflectionmethod.xml b/reference/reflection/reflectionmethod.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 14767af0f05dffa6fdb9b49e1a1f4e9ca7022a60 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 51fc0eaf8ecc894bb567fb7de2de789bec74e257 Maintainer: takagi Status: ready -->
 <reference xml:id="class.reflectionmethod" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <title>ReflectionMethod クラス</title>
@@ -129,7 +129,10 @@
     <variablelist>
 
      <varlistentry xml:id="reflectionmethod.constants.is-static">
-      <term><constant>ReflectionMethod::IS_STATIC</constant></term>
+      <term>
+       <constant>ReflectionMethod::IS_STATIC</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         メソッドが static であることを示します。
@@ -139,7 +142,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-public">
-      <term><constant>ReflectionMethod::IS_PUBLIC</constant></term>
+      <term>
+       <constant>ReflectionMethod::IS_PUBLIC</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         メソッドが public であることを示します。
@@ -149,7 +155,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-protected">
-      <term><constant>ReflectionMethod::IS_PROTECTED</constant></term>
+      <term>
+       <constant>ReflectionMethod::IS_PROTECTED</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         メソッドが protected であることを示します。
@@ -159,7 +168,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-private">
-      <term><constant>ReflectionMethod::IS_PRIVATE</constant></term>
+      <term>
+       <constant>ReflectionMethod::IS_PRIVATE</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         メソッドが private であることを示します。
@@ -169,7 +181,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-abstract">
-      <term><constant>ReflectionMethod::IS_ABSTRACT</constant></term>
+      <term>
+       <constant>ReflectionMethod::IS_ABSTRACT</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         メソッドが abstract であることを示します。
@@ -179,7 +194,10 @@
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-final">
-      <term><constant>ReflectionMethod::IS_FINAL</constant></term>
+      <term>
+       <constant>ReflectionMethod::IS_FINAL</constant>
+       <type>int</type>
+      </term>
       <listitem>
        <para>
         メソッドが final であることを示します。
@@ -210,6 +228,12 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        クラス定数が型付けされました。
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>

diff --git a/reference/reflection/reflectionmethod/construct.xml b/reference/reflection/reflectionmethod/construct.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 790f63af6521908477b285ff753e454e118bb989 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <refentry xml:id="reflectionmethod.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -21,6 +21,12 @@
    <modifier>public</modifier> <methodname>ReflectionMethod::__construct</methodname>
    <methodparam><type>string</type><parameter>classMethod</parameter></methodparam>
   </constructorsynopsis>
+  <warning>
+   <simpara>
+    この代替のシグネチャは PHP 8.4.0 以降で非推奨となりました。
+    代わりに <methodname>ReflectionMethod::createFromMethodName</methodname> を使用してください。
+   </simpara>
+  </warning>
   <para>
    新しい <classname>ReflectionMethod</classname> を作成します。
   </para>