doc-en と同期（PDO・mysqli の文法修正、session の PHP 8.4 非推奨注記ほか・16ファイル）

reference/exec/functions/shell-exec.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7973fd533364af4dd6282ca9e7bee2dffec39b1c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 81593f08db3320d5366bf925c8561f097a9d69ad Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa,shimooka,mumumu -->
 <!-- splitted from ./en/functions/exec.xml, last change in rev 1.2 -->
 <refentry xml:id="function.shell-exec" xmlns="http://docbook.org/ns/docbook">
@@ -15,11 +15,11 @@
    <type class="union"><type>string</type><type>false</type><type>null</type></type><methodname>shell_exec</methodname>
    <methodparam><type>string</type><parameter>command</parameter></methodparam>
   </methodsynopsis>
-  <para>
-   この関数は <link
+  <simpara>
+   この関数は、非推奨の <link
    linkend="language.operators.execution">バッククォート演算子</link>
    と等価です。
-  </para>
+  </simpara>
   <note>
    <para>
     Windows では、パイプがテキストモードでオープンされるため、

reference/image/functions/getimagesize.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 525aa5f198d482c0d03be54ddee5af13b376ab99 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 22ca9442cb38626cc8fc522c62f74f32b3dc9709 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://docbook.org/ns/docbook" xml:id="function.getimagesize">
  <refnamediv>
@@ -286,6 +286,7 @@ if (isset($info["APP13"])) {
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
+   <member><function>getimagesizefromstring</function></member>
    <member><function>image_type_to_mime_type</function></member>
    <member><function>exif_imagetype</function></member>
    <member><function>exif_read_data</function></member>

reference/mysqli/configure.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 050e16021ff71318012fa16322e98d8603d5ab38 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
 <section xml:id="mysqli.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 
@@ -34,14 +34,15 @@
    各拡張モジュールが使用するクライアントライブラリを選択したりすることができます。
   </para>
 
-  <para>
+  <simpara>
    クライアントライブラリには MySQL Native Driver を使うことを推奨します。
+   PHP 8.2.0 以降では、MySQL Native Driver が唯一の選択肢です。
    そのほうがパフォーマンスが向上し、MySQL Client Library
    を使用した場合には使えない機能も使用することができます。
    <link linkend="mysqli.overview.mysqlnd">PHP の MySQL Native
    Driver とは?</link>
    に、MySQL Native Driver の利点が簡単にまとめられています。
-  </para>
+  </simpara>
 
   <para>
    <literal>/path/to/mysql_config</literal> は、MySQL Server に含まれる
@@ -62,7 +63,14 @@
     </thead>
     <tbody>
      <row>
-      <entry>5.4.x 以降</entry>
+      <entry>8.2.0 以降</entry>
+      <entry>mysqlnd</entry>
+      <entry><option role="configure">--with-mysqli</option></entry>
+      <entry>libmysqlclient はサポートされません。</entry>
+      <entry>mysqlnd しか使えなくなりました。</entry>
+     </row>
+     <row>
+      <entry>5.4.0 から 8.1.x まで</entry>
       <entry>mysqlnd</entry>
       <entry><option role="configure">--with-mysqli</option></entry>
       <entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
@@ -86,14 +94,6 @@
    </tgroup>
   </table>
 
-  <para>
-   MySQL 拡張モジュールとクライアントライブラリの組み合わせは自由であることに注意しましょう。
-   たとえば、MySQL 拡張モジュールは MySQL Client Library (libmysqlclient) を使うようにして有効にし、
-   一方 <literal>mysqli</literal> 拡張モジュールは MySQL Native Driver
-   を使うようにするということも可能です。
-   しかし、それ以外にも拡張モジュールとクライアントライブラリのすべての組み合わせが使用可能です。
-  </para>
-
  </section>
 
  <section xml:id="mysqli.installation.windows">

reference/mysqli/ini.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 90787fda14dcb0976a9738423e6c6013c037d048 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi,mumumu -->
 <section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
  &reftitle.runtime;
@@ -147,9 +147,9 @@
     <type>int</type>
    </term>
    <listitem>
-    <para>
+    <simpara>
      作成できる持続的接続の最大数。0 を設定すると無制限となります。
-    </para>
+    </simpara>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mysqli.max-links">
@@ -158,9 +158,9 @@
     <type>int</type>
    </term>
    <listitem>
-    <para>
-     プロセス毎の MySQL 接続の最大数。
-    </para>
+    <simpara>
+     プロセス毎の接続の最大数。
+    </simpara>
    </listitem>
   </varlistentry>
    <varlistentry xml:id="ini.mysqli.default-port">

reference/mysqli/mysqli/poll.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c5ccd084c8f830801a939bf1829ddddcaf019730 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="mysqli.poll" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -56,18 +56,18 @@
     <varlistentry>
      <term><parameter>error</parameter></term>
      <listitem>
-      <para>
-      クエリが失敗した、あるいは接続が切断されたなどのエラーが発生した接続のリスト。
-      </para>
+      <simpara>
+       クエリが失敗した、あるいは接続が切断されたなどのエラーが発生した接続のリスト。
+      </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><parameter>reject</parameter></term>
      <listitem>
-      <para>
-      関数から結果を取得できるような非同期クエリが実行されていないという理由で、
-      拒否された接続のリスト。
-      </para>
+      <simpara>
+       問い合わせの対象となる保留中の非同期クエリが存在しないという理由で、
+       拒否された接続のリスト。
+      </simpara>
      </listitem>
     </varlistentry>
     <varlistentry>

reference/mysqli/mysqli/stmt-init.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="mysqli.stmt-init" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -26,10 +26,10 @@
    ステートメントオブジェクトを割り当て、初期化します。
   </para>
   <note>
-   <para>
-    <function>mysqli_stmt_prepare</function> がコールされるまで、
-    これ以降のあらゆる mysqli_stmt 関数のコールは失敗します。
-   </para>
+   <simpara>
+    これ以降、<function>mysqli_stmt_prepare</function> をコールするまでは、
+    <classname>mysqli_stmt</classname> のどのメソッドをコールしても失敗します。
+   </simpara>
   </note>
  </refsect1>
 
@@ -44,9 +44,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   オブジェクトを返します。
-  </para>
+  <simpara>
+   <classname>mysqli_stmt</classname> オブジェクトを返します。
+  </simpara>
  </refsect1>
 
  <refsect1 role="seealso">

reference/mysqli/quickstart.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 60a292997b3c6341cf52099d901aa0b5f8673d87 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: mumumu Status: ready -->
 
 <chapter xml:id="mysqli.quickstart" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>クイックスタートガイド</title>
@@ -253,13 +253,13 @@ mysqli.default_socket=/tmp/mysql.sock
    ソケット(パイプ名)のデフォルトは
    <literal>\\.\pipe\MySQL</literal> となります。
   </para>
-  <para>
+  <simpara>
    Unixドメインソケットベース、
    および Windows の名前付きパイプベースの接続が両方確立されず、
    port パラメータが未設定の場合、
    ライブラリはデフォルトのポートを
    <literal>3306</literal> に設定します。
-  </para>
+  </simpara>
   <para>
    <link linkend="mysqlnd.overview">mysqlnd</link>
    ライブラリと
@@ -331,7 +331,7 @@ mysqli.default_socket=/tmp/mysql.sock
    Webサーバーは多くの
    PHP プロセスをforkさせる可能性があることに注意して下さい。
   </para>
-  <para>
+  <simpara>
    持続的接続についてよくある不満が、
    再利用する前にステートがリセットされないというものです。
    たとえば、
@@ -343,7 +343,7 @@ mysqli.default_socket=/tmp/mysql.sock
    これは、望ましくない副作用と見なされるかもしれません。
    一方で、<literal>persistent</literal> という名前は、
    ステートを維持することを約束していると理解されるかもしれません。
-  </para>
+  </simpara>
   <para>
    mysqli 拡張モジュールは、
    持続的接続について、両方の解釈をサポートしています:
@@ -1079,9 +1079,9 @@ array(2) {
   <para>
    <emphasis role="bold">クライアント側でプリペアドステートメントをエミュレートする</emphasis>
   </para>
-  <para>
+  <simpara>
    API は、クライアント側でのプリペアドステートメントのエミュレートをサポートしていません。
-  </para>
+  </simpara>
   <para>
    <emphasis role="bold">参照</emphasis>
   </para>
@@ -1198,13 +1198,13 @@ Hi!
     </screen>
    </example>
   </para>
-  <para>
+  <simpara>
    アプリケーションやフレームワークの開発者は、
    セッションの値やデータベースカタログを調べることによって、
    もっと便利なAPIを提供できます。
    しかし、カタログを調べることをベースにしたカスタムのやり方は、
    パフォーマンスに影響がある可能性があることに注意して下さい。
-  </para>
+  </simpara>
   <para>
    <emphasis role="bold">結果セットを扱う</emphasis>
   </para>

reference/mysqli/summary.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 4e8c90ca8a4a63575341cde6f5fbdc34419d2cff Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: lacatoire Status: ready -->
 <chapter xml:id="mysqli.summary" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 
  <title>MySQLi 拡張モジュールの関数概要</title>
@@ -203,7 +203,7 @@
      <entry><methodname>mysqli::get_warnings</methodname></entry>
      <entry><function>mysqli_get_warnings</function></entry>
      <entry>N/A</entry>
-     <entry>ドキュメント化されていない</entry>
+     <entry>SHOW WARNINGS の結果を取得する</entry>
     </row>
     <row>
      <entry><methodname>mysqli::init</methodname></entry>
@@ -388,7 +388,7 @@
      <entry><link linkend="mysqli-stmt.field-count">$mysqli_stmt::field_count</link></entry>
      <entry><function>mysqli_stmt_field_count</function></entry>
      <entry>N/A</entry>
-     <entry>指定されたステートメントのフィールド数を返す - ドキュメント化されていない</entry>
+     <entry>ステートメントのフィールド数を返す</entry>
     </row>
     <row>
      <entry><link linkend="mysqli-stmt.insert-id">$mysqli_stmt::insert_id</link></entry>
@@ -406,13 +406,13 @@
      <entry><link linkend="mysqli-stmt.param-count">$mysqli_stmt::param_count</link></entry>
      <entry><function>mysqli_stmt_param_count</function></entry>
      <entry>N/A</entry>
-     <entry>指定されたステートメントのパラメータ数を返す</entry>
+     <entry>ステートメントのパラメータ数を返す</entry>
     </row>
     <row>
      <entry><link linkend="mysqli-stmt.sqlstate">$mysqli_stmt::sqlstate</link></entry>
      <entry><function>mysqli_stmt_sqlstate</function></entry>
      <entry>N/A</entry>
-     <entry>直前のステートメント操作の SQLSTATE エラーを返す</entry>
+     <entry>直前の操作の SQLSTATE エラーを返す</entry>
     </row>
     <row>
      <entry><emphasis role="bold">メソッド</emphasis></entry>

reference/mysqlinfo/set.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7cff4d34f0324c9de72d15957e1b62e20f37dfaf Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu --><set xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="set.mysqlinfo">
  <title>MySQL ドライバおよびプラグイン</title>
  <titleabbrev>MySQL</titleabbrev>

reference/pdo/constants.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: mumumu Status: ready -->
 <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
 <appendix xml:id="pdo.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -434,7 +434,9 @@
     </term>
     <listitem>
      <simpara>
-      ステートメントが返すクラス名を設定します。
+      <classname>PDOStatement</classname> オブジェクトを拡張するクラス名と、
+      そのコンストラクタの引数を設定します。
+      配列の最初の要素がクラス名で、2 番目の要素がコンストラクタの引数の配列です。
      </simpara>
     </listitem>
    </varlistentry>

reference/pgsql/functions/pg-fetch-object.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
 <!-- splitted from ./ja/functions/pgsql.xml, last change in rev 1.6 -->
-<!-- EN-Revision: 39bb8a868935a56cfce438b0169e13c02c93211c Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi -->
 <refentry xml:id="function.pg-fetch-object" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -87,11 +87,11 @@
 
  <refsect1 role="errors">
   &reftitle.errors;
-  <para>
+  <simpara>
    <parameter>constructor_args</parameter> が空ではないのに、
    クラスにコンストラクタが存在しない場合、
    <classname>ValueError</classname> がスローされます。
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="changelog">