Fix #81065: Changes to Reflection modifiers not documented

php · May 23, 2021 · b328f5e · b328f5e
1 parent bf00ac7
commit b328f5e
Show file tree

Hide file tree

Showing 7 changed files with 80 additions and 26 deletions.
diff --git a/appendices/migration74/incompatible.xml b/appendices/migration74/incompatible.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 19af072c3eb88de9b99be2e982af8949f0b68a95 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 6f41560bf19de74e2dfbc78f4175d35f5b378abe Maintainer: mumumu Status: ready -->
 
 <sect1 xml:id="migration74.incompatible" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>下位互換性のない変更点</title>
@@ -253,6 +253,11 @@
    ではなく <classname>Exception</classname>
    が生成されるようになりました。これは、シリアル化をサポートしていない他の内部的なクラスと一貫した挙動です。
   </para>
+
+  <para>
+   <classname>ReflectionClassConstant</classname>,
+   <classname>ReflectionMethod</classname>, <classname>ReflectionProperty</classname> のクラス定数の値が変更されました。
+  </para>
  </sect2>
 
  <sect2 xml:id="migration74.incompatible.reflection">

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: 98df2cf9a939729d73adee1484ec05929c74c98b Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 6f41560bf19de74e2dfbc78f4175d35f5b378abe Maintainer: mumumu Status: ready -->
 
 <phpdoc:classref xml:id="class.reflectionclassconstant" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -41,16 +41,19 @@
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionclassconstant.constants.is-public">ReflectionClassConstant::IS_PUBLIC</varname>
+     <initializer>1</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionclassconstant.constants.is-protected">ReflectionClassConstant::IS_PROTECTED</varname>
+     <initializer>2</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionclassconstant.constants.is-private">ReflectionClassConstant::IS_PRIVATE</varname>
+     <initializer>4</initializer>
     </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
@@ -113,6 +116,7 @@
       <listitem>
        <para>
         アクセス権が <link linkend="language.oop5.visibility">public</link> であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>256</literal> でした。
        </para>
       </listitem>
      </varlistentry>
@@ -122,6 +126,7 @@
       <listitem>
        <para>
         アクセス権が <link linkend="language.oop5.visibility">protected</link> であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>512</literal> でした。
        </para>
       </listitem>
      </varlistentry>
@@ -131,11 +136,19 @@
       <listitem>
        <para>
         アクセス権が <link linkend="language.oop5.visibility">private</link> であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>1024</literal> でした。
        </para>
       </listitem>
      </varlistentry>
 
     </variablelist>
+    <note>
+     <para>
+      これらの定数の値は、PHP のバージョンが異なると変更される可能性があります。
+      これらの値を直接用いず、常に定数を使うことを推奨します。
+     </para>
+    </note>
+
    </section>
   </section>
 <!-- }}} -->

diff --git a/reference/reflection/reflectionclassconstant/getmodifiers.xml b/reference/reflection/reflectionclassconstant/getmodifiers.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: cf616ef1f0bd14778a591210de8a231fa564e863 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 6f41560bf19de74e2dfbc78f4175d35f5b378abe Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="reflectionclassconstant.getmodifiers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -29,7 +29,7 @@
   <para>
    アクセス修飾子の数値表現を返します。
    これらの修飾子の実際の意味は、
-   <link linkend="reflectionmethod.constants.modifiers">定義済みの定数</link> で説明しています。
+   <link linkend="reflectionclassconstant.constants.modifiers">定義済みの定数</link> で説明しています。
   </para>
  </refsect1>
 

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: 98df2cf9a939729d73adee1484ec05929c74c98b Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 6f41560bf19de74e2dfbc78f4175d35f5b378abe Maintainer: takagi Status: ready -->
 
 <phpdoc:classref xml:id="class.reflectionmethod" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -47,37 +47,37 @@
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionmethod.constants.is-static">ReflectionMethod::IS_STATIC</varname>
-     <initializer>1</initializer>
+     <initializer>16</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionmethod.constants.is-public">ReflectionMethod::IS_PUBLIC</varname>
-     <initializer>256</initializer>
+     <initializer>1</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionmethod.constants.is-protected">ReflectionMethod::IS_PROTECTED</varname>
-     <initializer>512</initializer>
+     <initializer>2</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionmethod.constants.is-private">ReflectionMethod::IS_PRIVATE</varname>
-     <initializer>1024</initializer>
+     <initializer>4</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionmethod.constants.is-abstract">ReflectionMethod::IS_ABSTRACT</varname>
-     <initializer>2</initializer>
+     <initializer>64</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionmethod.constants.is-final">ReflectionMethod::IS_FINAL</varname>
-     <initializer>4</initializer>
+     <initializer>32</initializer>
     </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
@@ -137,46 +137,70 @@
      <varlistentry xml:id="reflectionmethod.constants.is-static">
       <term><constant>ReflectionMethod::IS_STATIC</constant></term>
       <listitem>
-       <para>メソッドが static であることを示します。</para>
+       <para>
+        メソッドが static であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>1</literal> でした。
+       </para>
       </listitem>
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-public">
       <term><constant>ReflectionMethod::IS_PUBLIC</constant></term>
       <listitem>
-       <para>メソッドが public であることを示します。</para>
+       <para>
+        メソッドが public であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>256</literal> でした。
+       </para>
       </listitem>
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-protected">
       <term><constant>ReflectionMethod::IS_PROTECTED</constant></term>
       <listitem>
-       <para>メソッドが protected であることを示します。</para>
+       <para>
+        メソッドが protected であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>512</literal> でした。
+       </para>
       </listitem>
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-private">
       <term><constant>ReflectionMethod::IS_PRIVATE</constant></term>
       <listitem>
-       <para>メソッドが private であることを示します。</para>
+       <para>
+        メソッドが private であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>1024</literal> でした。
+       </para>
       </listitem>
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-abstract">
       <term><constant>ReflectionMethod::IS_ABSTRACT</constant></term>
       <listitem>
-       <para>メソッドが abstract であることを示します。</para>
+       <para>
+        メソッドが abstract であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>2</literal> でした。
+       </para>
       </listitem>
      </varlistentry>
 
      <varlistentry xml:id="reflectionmethod.constants.is-final">
       <term><constant>ReflectionMethod::IS_FINAL</constant></term>
       <listitem>
-       <para>メソッドが final であることを示します。</para>
+       <para>
+        メソッドが final であることを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>4</literal> でした。
+       </para>
       </listitem>
      </varlistentry>
 
     </variablelist>
+    <note>
+     <para>
+      これらの定数の値は、PHP のバージョンが異なると変更される可能性があります。
+      これらの値を直接用いず、常に定数を使うことを推奨します。
+     </para>
+    </note>
    </section>
   </section>
 <!-- }}} -->

diff --git a/reference/reflection/reflectionmethod/getmodifiers.xml b/reference/reflection/reflectionmethod/getmodifiers.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8c6d47907a700e7d824c6b02108d631e5cc1091f Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 6f41560bf19de74e2dfbc78f4175d35f5b378abe Maintainer: takagi Status: ready -->
 
 <refentry xml:id="reflectionmethod.getmodifiers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -71,10 +71,10 @@ echo implode(' ', Reflection::getModifierNames($bar->getModifiers()));
     <screen>
 <![CDATA[
 Modifiers for method foo():
-261
+49
 final public static
 Modifiers for method bar():
-65792
+1
 public
 ]]>
     </screen>

diff --git a/reference/reflection/reflectionproperty.xml b/reference/reflection/reflectionproperty.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 98df2cf9a939729d73adee1484ec05929c74c98b Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 6f41560bf19de74e2dfbc78f4175d35f5b378abe Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <phpdoc:classref xml:id="class.reflectionproperty" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -43,25 +43,25 @@
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionproperty.constants.is-static">ReflectionProperty::IS_STATIC</varname>
-     <initializer>1</initializer>
+     <initializer>16</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionproperty.constants.is-public">ReflectionProperty::IS_PUBLIC</varname>
-     <initializer>256</initializer>
+     <initializer>1</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionproperty.constants.is-protected">ReflectionProperty::IS_PROTECTED</varname>
-     <initializer>512</initializer>
+     <initializer>2</initializer>
     </fieldsynopsis>
     <fieldsynopsis>
      <modifier>const</modifier>
      <type>int</type>
      <varname linkend="reflectionproperty.constants.is-private">ReflectionProperty::IS_PRIVATE</varname>
-     <initializer>1024</initializer>
+     <initializer>4</initializer>
     </fieldsynopsis>
 
     <classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>
@@ -126,6 +126,7 @@
        <para>
         <link linkend="language.oop5.static">static</link>
         プロパティを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>1</literal> でした。
        </para>
       </listitem>
      </varlistentry>
@@ -136,6 +137,7 @@
        <para>
         <link linkend="language.oop5.visibility">public</link>
         プロパティを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>256</literal> でした。
        </para>
       </listitem>
      </varlistentry>
@@ -146,6 +148,7 @@
        <para>
         <link linkend="language.oop5.visibility">protected</link>
         プロパティを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>512</literal> でした。
        </para>
       </listitem>
      </varlistentry>
@@ -156,11 +159,18 @@
        <para>
         <link linkend="language.oop5.visibility">private</link>
         プロパティを示します。
+        PHP 7.4.0 より前のバージョンでは、この値は <literal>1024</literal> でした。
        </para>
       </listitem>
      </varlistentry>
 
     </variablelist>
+    <note>
+     <para>
+      これらの定数の値は、PHP のバージョンが異なると変更される可能性があります。
+      これらの値を直接用いず、常に定数を使うことを推奨します。
+     </para>
+    </note>
    </section>
   </section>
 <!-- }}} -->

diff --git a/reference/reflection/reflectionproperty/getmodifiers.xml b/reference/reflection/reflectionproperty/getmodifiers.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 584095e7e8433fe22ac21019af4de7a10fcd1d36 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 6f41560bf19de74e2dfbc78f4175d35f5b378abe Maintainer: mumumu Status: ready -->
 
 <refentry xml:id="reflectionproperty.getmodifiers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -31,6 +31,8 @@
   &reftitle.returnvalues;
   <para>
    修飾子の数値表現を返します。
+   これらの修飾子の実際の意味は、
+   <link linkend="reflectionproperty.constants.modifiers">定義済みの定数</link> で説明しています。
   </para>
  </refsect1>