PDO 系と SimpleXML の PHP 8.4 の変更、および basic-syntax の原文修正を追従

entities/entities.remove.ent

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 75772fd985edd7dc6f94b067bd2ef3ab59511cb5 Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 755a3809d5604a933d33e767dce7506d7b6f0d68 Maintainer: KentarouTakeda Status: ready -->
 <!--
 
 This is a "remove" XML Entity file.

language/basic-syntax.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: ee1ce6a0e1875b6851274f8c373ca2bd48630fa0 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: e7ec2928daf49d50796dfe74d106eb1068a1c72b Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi, shimooka, mumumu -->
 
  <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook" annotations="interactive">
@@ -41,13 +41,13 @@
      </programlisting>
     </example>
    </para>
-   <para>
-    短縮型のタグ（例 3.）はデフォルトで有効ですが、
+   <simpara>
+    短縮型のタグ（上の例の 3 番目）はデフォルトで有効ですが、
     &php.ini; 設定ファイルのディレクティブ
     <link linkend="ini.short-open-tag">short_open_tag</link> で無効にすることもできますし、
     <option>--disable-short-tags</option> オプション付きで configure した場合は、
     デフォルトで無効にすることも出来ます。
-   </para>
+   </simpara>
    <para>
     <note>
      <para>
@@ -117,7 +117,7 @@ echo "最後のごあいさつ\n";
      <title>条件文を使った高度な脱出</title>
      <programlisting role="php">
 <![CDATA[
-<?php if ($expression == true): ?>
+<?php if (true): ?>
   条件式が真の場合にこれが表示されます。
 <?php else: ?>
   それ以外の場合にこちらが表示されます。

reference/pdo/pdo/getattribute.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 91183ddf1c54c6ce3051fdf0f5b9987272d51fbe Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: takagi Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="pdo.getattribute" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -41,18 +41,14 @@
        <literal>PDO::ATTR_*</literal> 定数の 1 つを指定します。
        データベース接続に適用される一般的な属性は以下の通りです。
        <simplelist> 
-        <member><literal>PDO::ATTR_AUTOCOMMIT</literal></member>
         <member><literal>PDO::ATTR_CASE</literal></member>
-        <member><literal>PDO::ATTR_CLIENT_VERSION</literal></member>
-        <member><literal>PDO::ATTR_CONNECTION_STATUS</literal></member>
+        <member><literal>PDO::ATTR_DEFAULT_FETCH_MODE</literal></member>
         <member><literal>PDO::ATTR_DRIVER_NAME</literal></member>
         <member><literal>PDO::ATTR_ERRMODE</literal></member>
         <member><literal>PDO::ATTR_ORACLE_NULLS</literal></member>
         <member><literal>PDO::ATTR_PERSISTENT</literal></member>
-        <member><literal>PDO::ATTR_PREFETCH</literal></member>
-        <member><literal>PDO::ATTR_SERVER_INFO</literal></member>
-        <member><literal>PDO::ATTR_SERVER_VERSION</literal></member>
-        <member><literal>PDO::ATTR_TIMEOUT</literal></member>
+        <member><literal>PDO::ATTR_STATEMENT_CLASS</literal></member>
+        <member><literal>PDO::ATTR_STRINGIFY_FETCHES</literal></member>
        </simplelist> 
       </para>
       <simpara>

reference/pdo/pdo/prepare.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: takagi Status: ready -->
 <!-- CREDITS: shimooka,mumumu -->
 <refentry xml:id="pdo.prepare" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -63,15 +63,16 @@
   </para>
   <note>
    <simpara>
+    PHP 8.4.0 より前のバージョンでは、
     エミュレートされたプリペアドステートメントと、
     名前パラメータやクエスチョンマークを書き換えるパーサーは、[シングル|ダブル]クォート
-    に対して標準とは異なるエスケープをサポートしています。
+    に対して標準とは異なるエスケープをサポートしていました。
     これによって、バックスラッシュのすぐ後にクォートで終了するクエリは
     そのままの形では認識されず、間違ったパラメータとして認識され、
-    実行されたときにプリペアドステートメントが失敗してしまいます。
+    実行されたときにプリペアドステートメントが失敗してしまうことがありました。
     回避策は、プリペアドステートメントのエミュレートをこの手のSQLクエリでは使わないようにし、
     かつ、ドライバがネイティブにサポートしているパラメータ形式を使うことで、
-    パラメータの書き換えを避けることです。
+    パラメータの書き換えを避けることでした。
    </simpara>
   </note>
   <para>
@@ -81,6 +82,15 @@
    クエリをデータベースに送信する時に <literal>?</literal>
    に変換されるということです。
   </para>
+  <simpara>
+   PHP 8.4.0 以降では、PDO はパラメータマーカーを探すためにドライバ固有の SQL
+   パーサーを使います。これによって、文字列リテラルやコメントの中に現れるマーカーが
+   プレースホルダと誤認されることはありません。
+   デフォルトのパーサーは、シングルクオートやダブルクオートで囲まれた文字列リテラルと、
+   2 つのハイフンによるコメント、ネストされていない C 言語形式のコメントを認識します。
+   ドライバによっては、追加の構文や異なる構文を認識するパーサーを提供している
+   場合があります。詳細はドライバ固有のドキュメントを参照してください。
+  </simpara>
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;

reference/pdo/pdostatement/getattribute.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8" ?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1cc1b815cd0a2a579fb79bc2ab0c1202574696bc Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: takagi Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="pdostatement.getattribute" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -25,6 +25,13 @@
      <literal>UPDATE ... WHERE CURRENT OF</literal>
      に対するカーソル名を取得する
     </simpara></listitem>
+    <listitem>
+     <simpara>
+      <constant>Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</constant>
+      (PostgreSQL 固有、PHP 8.4.0 以降で利用可能):
+      クエリ結果に割り当てられたメモリ使用量をバイト単位で取得する
+     </simpara>
+    </listitem>
    </itemizedlist>
    ドライバ固有の属性は、
    他のドライバでは使っては <emphasis>いけない</emphasis>

reference/pdo_firebird/configure.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c316dd3b8bce869f1c92c760900a29c2ba0a71af Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: takagi Status: ready -->
 <section xml:id="ref.pdo-firebird.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
  <para>
@@ -13,6 +13,11 @@ $ ./configure --with-pdo-firebird
 ]]>
   </screen>
  </para>
+ <simpara>
+  PHP 8.4.0 以降、この拡張モジュールは Firebird C++ API を使用しているため、
+  ビルドには C++ コンパイラが必要です。
+  また、fbclient 3.0 以降でビルドする必要があります。
+ </simpara>
 </section>
 
 <!-- Keep this comment at the end of the file

reference/pdo_pgsql/configure.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: c316dd3b8bce869f1c92c760900a29c2ba0a71af Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: takagi Status: ready -->
 <section xml:id="ref.pdo-pgsql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  &reftitle.install;
  <para>
@@ -13,6 +13,10 @@ $ ./configure --with-pdo-pgsql
 ]]>
   </screen>
  </para>
+ <simpara>
+  この拡張モジュールには、libpq（PostgreSQL の C クライアントライブラリ）が必要です。
+  PHP 8.4.0 以降では、libpq 10.0 以降が必要です。
+ </simpara>
 </section>
 
 <!-- Keep this comment at the end of the file

reference/pdo_pgsql/pdo-pgsql.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 603435cd84951fc720eded819c62ef2466d21b5c Maintainer: KentarouTakeda Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: KentarouTakeda Status: ready -->
 <!-- CREDITS: mumumu,KentarouTakeda -->
 <reference xml:id="class.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" role="class">
  <title>Pdo\Pgsql クラス</title>
@@ -46,6 +46,15 @@
      </listitem>
     </itemizedlist>
    </para>
+   <note>
+    <simpara>
+     このパーサーはドル記号で囲まれた文字列リテラルを認識するため、
+     その中にある疑問符はパラメータのプレースホルダとして扱われず、
+     エスケープする必要もありません。
+     PHP 8.4.0 以降、ドル記号で囲まれた文字列の中で疑問符を
+     <literal>??</literal> としてエスケープすることは非推奨です。
+    </simpara>
+   </note>
   </section>
   <!-- }}} -->
 

reference/pdo_pgsql/reference.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: shimooka Status: ready -->
+<!-- EN-Revision: 371e92c3d8d9ee92542dfae4dee1d9fd0c940385 Maintainer: shimooka Status: ready -->
 
  <reference xml:id="ref.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <?phpdoc extension-membership="bundledexternal" ?>
@@ -122,6 +122,15 @@
       </varlistentry>
 
      </variablelist>
+     <note>
+      <simpara>
+       PHP 8.4.0 以降、DSN で指定した認証情報
+       (<literal>user</literal> と <literal>password</literal>) が、
+       <classname>PDO</classname> コンストラクタに渡した
+       対応する引数よりも優先されます。
+       これより前のバージョンでは、PDO コンストラクタの引数のほうが優先されていました。
+      </simpara>
+     </note>
      <note>
       <simpara>
        DSN 文字列における全てのセミコロンは、スペースで置き換えられます。

reference/simplexml/simplexmlelement.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 603435cd84951fc720eded819c62ef2466d21b5c Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 418ec505128707215c5c99ad4a66a88bfd84a0ff Maintainer: takagi Status: ready -->
 <reference xml:id="class.simplexmlelement" 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>SimpleXMLElement クラス</title>
  <titleabbrev>SimpleXMLElement</titleabbrev>
@@ -57,6 +57,17 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>8.4.0</entry>
+       <entry>
+        値を取得するメソッド (<methodname>SimpleXMLElement::asXML</methodname> や
+        <methodname>SimpleXMLElement::getName</methodname> など) と、
+        <classname>SimpleXMLElement</classname> の &string; へのキャストは、
+        イテレータを暗黙的に巻き戻さなくなりました。
+        必要な場合は、<methodname>SimpleXMLElement::rewind</methodname> を使って
+        イテレータを明示的に巻き戻さなければなりません。
+       </entry>
+      </row>
       <row>
        <entry>8.0.0</entry>
        <entry>

reference/simplexml/simplexmlelement/rewind.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: dcb657b7e9e4f7622ce3394ae1fa3c14538721e1 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 418ec505128707215c5c99ad4a66a88bfd84a0ff Maintainer: takagi Status: ready -->
 <!-- CREDITS: shimooka -->
 <refentry xml:id="simplexmlelement.rewind" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -16,6 +16,17 @@
   <para>
    このメソッドは、<classname>SimpleXMLElement</classname> を最初の要素に巻き戻します。
   </para>
+
+  <note>
+   <simpara>
+    PHP 8.4.0 以降では、値を取得するメソッド
+    (<methodname>SimpleXMLElement::asXML</methodname> や
+    <methodname>SimpleXMLElement::getName</methodname> など) を呼び出したり、
+    <classname>SimpleXMLElement</classname> を &string; にキャストしたりしても、
+    イテレータが暗黙的に巻き戻されることはなくなりました。
+    必要な場合は、このメソッドを呼び出してイテレータを明示的に巻き戻さなければなりません。
+   </simpara>
+  </note>
  </refsect1>
 
  <refsect1 role="parameters">