doc-en と同期し INI ディレクティブの PHP 8.5.0 変更を反映（7ファイル）

appendices/ini.core.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 185dda85976e5ed392664db011abda0110726c0d Maintainer: takagi Status: ready -->
+<!-- EN-Revision: a52e3d27cca786940272d0ae8efc21b5d6739070 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 
  <section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -64,7 +64,7 @@
         <entry><link linkend="ini.disable-classes">disable_classes</link></entry>
         <entry>""</entry>
         <entry>&php.ini; のみ</entry>
-        <entry></entry>
+        <entry>PHP 8.5.0 以降は削除されています。</entry>
        </row>
        <row>
         <entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>
@@ -237,15 +237,15 @@
        <type>string</type>
       </term>
       <listitem>
-       <para>
+       <simpara>
         このディレクティブを使うと、特定のクラスを無効にすることができます。
         クラス名の一覧をカンマ区切りで指定します。
         クラスを無効にすると、クラスのインスタンス化ができなくなります。
-       </para>
-       <para>
+       </simpara>
+       <simpara>
         このディレクティブを使って無効にできるのは、内部クラスのみです。
         ユーザーが定義したクラスは影響を受けません。
-       </para>
+       </simpara>
        <simpara>
         このディレクティブは &php.ini; で設定しなければなりません。
         &httpd.conf; では設定できません。
@@ -256,6 +256,7 @@
          十分なセキュリティ対策とはみなすべきではありません。
         </simpara>
        </warning>
+       &warn.removed.feature-8-5-0;
       </listitem>
      </varlistentry>
 
@@ -611,7 +612,7 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
         <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>
          <entry>"1"</entry>
          <entry><constant>INI_PERDIR</constant></entry>
-         <entry></entry>
+         <entry>PHP 8.5.0 以降は非推奨です。</entry>
        </row>
        <row>
         <entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>
@@ -805,6 +806,18 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
         <link linkend="features.commandline">コマンドライン</link>
         も参照ください。
         </simpara>
+        &warn.deprecated.feature-8-5-0;
+        <note>
+         <simpara>
+          CLI 以外の SAPI において、クエリ文字列から
+          <code>$_SERVER['argc']</code> および <code>$_SERVER['argv']</code>
+          を導出する挙動は非推奨になりました。
+          <literal>register_argc_argv=0</literal> を設定し、
+          その使い方が安全であることを確認した上で、
+          <varname>$_GET</varname> または <code>$_SERVER['QUERY_STRING']</code>
+          のいずれかに切り替えて情報を取得するようにしてください。
+         </simpara>
+        </note>
        </listitem>
       </varlistentry>
 

appendices/ini.list.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b1116af46680f7baf89c46610430a3b63ce9a1f0 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: a52e3d27cca786940272d0ae8efc21b5d6739070 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 
  <section xml:id="ini.list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -210,7 +210,7 @@
        <entry><link linkend="ini.disable-classes">disable_classes</link></entry>
        <entry><literal>""</literal></entry>
        <entry>&php.ini; のみ</entry>
-       <entry></entry>
+       <entry>PHP 8.5.0 以降では削除されました</entry>
       </row>
       <row>
        <entry><link linkend="ini.disable-functions">disable_functions</link></entry>
@@ -554,13 +554,13 @@
        <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>
        <entry><literal>"1"</literal></entry>
        <entry><constant>INI_PERDIR</constant></entry>
-       <entry></entry>
+       <entry>PHP 8.5.0 以降は非推奨</entry>
       </row>
       <row>
        <entry><link linkend="ini.report-memleaks">report_memleaks</link></entry>
        <entry><literal>"1"</literal></entry>
        <entry><constant>INI_ALL</constant></entry>
-       <entry></entry>
+       <entry>PHP 8.5.0 以降は非推奨</entry>
       </row>
       <row>
        <entry>report_zend_debug</entry>

features/commandline.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 96b10a98853e3b8236504e5775f95eb4a15c82c3 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: b08b472de7041be8dbae153556b714efa93f20c0 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>PHP をコマンドラインから使用する</title>
@@ -206,6 +206,7 @@ if (php_sapi_name() === 'cli') {
             </informalexample>
            </para>
           </warning>
+          &warn.deprecated.feature-8-5-0;
           </entry>
          </row>
          <row>
@@ -363,7 +364,6 @@ Usage: php [options] [-f] <file> [--] [args...]
   -s               Output HTML syntax highlighted source.
   -v               Version number
   -w               Output source with stripped comments and whitespace.
-  -z <file>        Load Zend extension <file>.
 
   args...          Arguments passed to script. Use -- args when first argument
                    starts with - or script is read from stdin
@@ -843,30 +843,14 @@ Zend Engine v2.3.0, Copyright (c) 1998-2009 Zend Technologies
         </note>
        </entry>
       </row>
-      <row>
-       <entry>-z</entry>
-       <entry>--zend-extension</entry>
-       <entry>
-        <para>
-         Zend 拡張モジュールをロードします。ファイル名のみが指定された場合、
-         PHP はこの拡張をカレントのシステムのデフォルトライブラリパスから
-         ロードしようとします
-         (Linux システムの場合は <filename>/etc/ld.so.conf</filename> で
-         指定されています)。
-         ファイル名を絶対パスで指定した場合、システムのライブラリサーチパスを
-         使用しません。ディレクトリ情報を有する相対ファイル名を
-         指定すると、PHP は
-         カレントのディレクトリの相対パスから拡張モジュールをロードする
-         ことのみを行ないます。
-        </para>
-       </entry>
-      </row>
       <row>
        <entry></entry>
        <entry>--ini</entry>
        <entry>
         <para>
          設定ファイルの名前、設定ファイルを検索するディレクトリを表示します。
+         オプションで <literal>--ini=diff</literal> を渡すと、
+         ロードされた設定ファイルとデフォルトの設定との差分を表示します。
          <example>
           <title><literal>--ini</literal> の例</title>
           <programlisting role="shell">
@@ -879,6 +863,11 @@ Additional .ini files parsed:      (none)
 ]]>
           </programlisting>
          </example>
+         <note>
+          <simpara>
+           <literal>--ini=diff</literal> オプションは PHP 8.5.0 より前では使用できません。
+          </simpara>
+         </note>
         </para>
        </entry>
       </row>

install/fpm/configuration.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f0149750aedec8b2eaa46338d90213dc4767d8b3 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1f01e2a8e478c63bd6598cde09235ec027b23dd5 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
   <sect1 xml:id="install.fpm.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -395,17 +395,17 @@
        <para>
         <literal>static</literal> - 子プロセスの数は固定 (<literal>pm.max_children</literal>) です。
        </para>
-       <para>
+       <simpara>
         <literal>ondemand</literal> - プロセスを必要に応じて立ち上げます。
         dynamic とは対照的に、リクエストされると
         <literal>pm.start_servers</literal> で指定しただけサービスを開始します。
-       </para>
-       <para>
+       </simpara>
+       <simpara>
         <literal>dynamic</literal> - 子プロセスの数は、
         <literal>pm.max_children</literal>、<literal>pm.start_servers</literal>、
         <literal>pm.min_spare_servers</literal>、<literal>pm.max_spare_servers</literal>
         の内容に基づいて動的に設定されます。
-       </para>
+       </simpara>
       </listitem>
      </varlistentry>
      <varlistentry xml:id="pm.max-children">
@@ -414,11 +414,11 @@
        <type>int</type>
       </term>
       <listitem>
-       <para>
+       <simpara>
         <literal>pm</literal> が <literal>static</literal> の場合は作成される子プロセスの数、
-        <literal>pm</literal> が <literal>dynamic</literal> の場合は作成される子プロセスの最大数。
+        <literal>pm</literal> が <literal>dynamic</literal> または <literal>ondemand</literal> の場合は作成される子プロセスの最大数。
         このオプションは必須です。
-       </para>
+       </simpara>
        <para>
         このオプションは、同時に処理できるリクエストの最大数を設定します。 
         mpm_prefork での ApacheMaxClients ディレクティブや、
@@ -1060,8 +1060,7 @@ php_admin_value[memory_limit] = 32M
      <literal>php_value</literal> や
      <literal>php_flag</literal> で渡した PHP の設定は、その前に設定されていた内容を上書きします。
      ただし
-     <link linkend="ini.disable-functions">disable_functions</link> や
-     <link linkend="ini.disable-classes">disable_classes</link> は別で、
+     <link linkend="ini.disable-functions">disable_functions</link> は別で、
      <filename>php.ini</filename> で定義された値を上書きするのではなく、
      新たに指定した値を追記することになります。
     </para>

reference/errorfunc/ini.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 72a6f3d35e914602703b698a5d8f52732b61ed3e Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: e5ff446c832aded712d45c885609ffdd277e6a49 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi,mumumu -->
 <section xml:id="errorfunc.configuration" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.runtime;
@@ -66,7 +66,7 @@
      <entry><link linkend="ini.report-memleaks">report_memleaks</link></entry>
      <entry>"1"</entry>
      <entry><constant>INI_ALL</constant></entry>
-     <entry></entry>
+     <entry>PHP 8.5.0 以降で非推奨です。</entry>
     </row>
     <row>
      <entry><link linkend="ini.track-errors">track_errors</link></entry>
@@ -201,26 +201,42 @@
      </note>
     </listitem>
    </varlistentry>
-
    <varlistentry xml:id="ini.display-errors">
     <term>
      <parameter>display_errors</parameter>
      <type>string</type>
     </term>
     <listitem>
      <para>
-      エラーをHTML出力の一部として画面に出力するかどうかを定義します。
-     </para>
-     <para>
-      "stderr" を指定すると、エラーの内容を <literal>stdout</literal>
-      (標準出力) ではなく <literal>stderr</literal> (標準エラー出力)
-      に送ります。
+      エラーを出力の一部として画面に表示するか、ユーザーから隠すかを決めます。
+      <itemizedlist>
+       <listitem>
+        <simpara>
+         <literal>Off</literal> - エラーを一切表示しません。
+        </simpara>
+       </listitem>
+       <listitem>
+        <simpara>
+         <literal>On</literal> または <literal>stdout</literal> - エラーを <literal>stdout</literal> に表示します。これがデフォルトです。
+        </simpara>
+       </listitem>
+       <listitem>
+        <simpara>
+         <literal>stderr</literal> - エラーを <literal>stderr</literal> に表示します。<literal>CLI</literal>、<literal>phpdbg</literal>、<literal>CGI</literal> の SAPI でのみ有効です。
+        </simpara>
+       </listitem>
+      </itemizedlist>
      </para>
+     <simpara>
+       同梱されている <literal>php.ini-development</literal> ではこれを
+       <literal>On</literal> に、<literal>php.ini-production</literal> では
+       <literal>Off</literal> に設定しています。
+     </simpara>
      <note>
-      <para>
+      <simpara>
       開発をサポートする仕組みであり、本番のシステムでは
       使用すべきではありません (例えばインターネットに接続されたシステムなど)。
-      </para>
+      </simpara>
      </note>
      <note>
       <para>
@@ -325,14 +341,15 @@
      <type>bool</type>
     </term>
     <listitem>
-     <para>
+     <simpara>
       このパラメータを On (デフォルト) にすると、Zend メモリマネージャーが検出した
       メモリリークの報告を表示します。この報告は、Posix プラットフォームでは標準エラー出力に送られます。
       Windows では、デバッガに OutputDebugString() を使って送られ、
       <link xlink:href="&url.dbgview;">DbgView</link> のようなツールで見ることができます。
       このパラメータが使えるのはデバッグビルドだけであり、かつ
       error_reporting で <constant>E_WARNING</constant> を有効にしている場合のみです。
-     </para>
+     </simpara>
+     &warn.deprecated.feature-8-5-0;
     </listitem>
    </varlistentry>