[PHP 8.4] mysqli拡張モジュール (#170)

* 英語版状態 * [PHP 8.4] mysqli拡張モジュール
php · Nov 17, 2024 · c4d0507 · c4d0507
1 parent 5f0376f
commit c4d0507
Show file tree

Hide file tree

Showing 7 changed files with 151 additions and 19 deletions.
diff --git a/reference/mysqli/constants.xml b/reference/mysqli/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 6d3ade3a588d629e52a948ceb36bea814e47a4f3 Maintainer: takagi Status: working -->
+<!-- EN-Revision: 8fb5db5a5eea9940e1cb5ea599817da36d3f36dd Maintainer: takagi Status: working -->
 <!-- CREDITS: hirokawa,mumumu -->
 <appendix xml:id="mysqli.constants" xmlns="http://docbook.org/ns/docbook">
  &reftitle.constants;
@@ -263,24 +263,24 @@
      </para>
     </listitem>
    </varlistentry>
-   <!-- to be translated -->
    <varlistentry xml:id="constant.mysqli-store-result-copy_data">
     <term>
      <constant>MYSQLI_STORE_RESULT_COPY_DATA</constant>
      (<type>int</type>)
     </term>
     <listitem>
      <simpara>
-      As of PHP 8.1, this constants no longer has any effect.
-      Before PHP 8.1, this constant is used to copy results
-      from the internal <literal>mysqlnd</literal> buffer
-      into the PHP variables fetched.
-      By default, <literal>mysqlnd</literal> will use a reference logic
-      to avoid copying and duplicating results held in memory.
-      For certain result sets, for example, result sets with many small rows,
-      the copy approach can reduce the overall memory usage
-      because PHP variables holding results may be released earlier.
-      Available with <literal>mysqlnd</literal> only.
+      PHP 8.1 以降、この定数はもはや意味をなしません。
+      PHP 8.1 より前は、
+      <literal>mysqlnd</literal> の内部バッファに格納されたフェッチ結果を
+      PHP 変数へコピーするために使用されていました。
+      デフォルトでは <literal>mysqlnd</literal>  は、メモリ内の結果を
+      重複させないようにコピーではなく参照ロジックを使用します。
+      しかし、特定の結果セット、たとえば多数の小さな行を持つ結果セットでは、
+      PHP 変数を個別で早期に解放できるコピー方式の方が
+      全体的なメモリ使用量を削減る可能性があります。
+      <literal>mysqlnd</literal> のみで利用可能です。
+      PHP 8.4.0 で非推奨となりました。
      </simpara>
     </listitem>
    </varlistentry>
@@ -812,6 +812,17 @@
      </para>
     </listitem>
    </varlistentry>
+   <varlistentry xml:id="constant.mysqli-type-vector">
+    <term>
+     <constant>MYSQLI_TYPE_VECTOR</constant>
+     (<type>int</type>)
+    </term>
+    <listitem>
+     <para>
+      フィールドは <literal>VECTOR</literal> と定義されています。
+     </para>
+    </listitem>
+   </varlistentry>
    <varlistentry xml:id="constant.mysqli-need-data">
     <term><constant>MYSQLI_NEED_DATA</constant></term>
     <listitem>
@@ -849,6 +860,7 @@
     </term>
     <listitem>
      <para>
+      PHP 8.4.0 で削除されました。
      </para>
     </listitem>
    </varlistentry>
@@ -879,6 +891,7 @@
     </term>
     <listitem>
      <para>
+      PHP 8.4.0 で削除されました。
      </para>
     </listitem>
    </varlistentry>
@@ -899,6 +912,7 @@
     </term>
     <listitem>
      <para>
+      PHP 8.4.0 で削除されました。
      </para>
     </listitem>
    </varlistentry>
@@ -1006,6 +1020,7 @@
     <listitem>
      <para>
       権限テーブルをリフレッシュします。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1018,6 +1033,7 @@
      <para>
       ログをフラッシュします。<acronym>SQL</acronym> 文
       <literal>FLUSH LOGS</literal> を実行するのと同じです。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1030,6 +1046,7 @@
      <para>
       テーブルキャッシュをフラッシュします。<acronym>SQL</acronym> 文
       <literal>FLUSH TABLES</literal> を実行するのと同じです。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1042,6 +1059,7 @@
      <para>
       ホストキャッシュをフラッシュします。<acronym>SQL</acronym> 文
       <literal>FLUSH HOSTS</literal> を実行するのと同じです。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1053,7 +1071,7 @@
     <listitem>
      <para>
       <constant>MYSQLI_REFRESH_SLAVE</constant> のエイリアスです。
-      PHP 8.1.0 以降で利用可能です。
+      PHP 8.1.0 以降で利用可能です。PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1066,6 +1084,7 @@
      <para>
       状態変数をリセットします。<acronym>SQL</acronym> 文
       <literal>FLUSH STATUS</literal> を実行するのと同じです。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1077,6 +1096,7 @@
     <listitem>
      <para>
       スレッドキャッシュをフラッシュします。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1091,6 +1111,7 @@
       マスタサーバーの情報をリセットしてスレーブを再起動します。
       <acronym>SQL</acronym> 文
       <literal>RESET SLAVE</literal> を実行するのと同じです。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1105,6 +1126,7 @@
       バイナリログインデックスにあるバイナリログファイルを削除してインデックスファイルを切り詰めます。
       <acronym>SQL</acronym> 文
       <literal>RESET MASTER</literal> を実行するのと同じです。
+      PHP 8.4.0 で非推奨となりました。
      </para>
     </listitem>
    </varlistentry>
@@ -1117,6 +1139,7 @@
     <listitem>
      <simpara>
       Closes and reopens the backup log files.
+      PHP 8.4.0 で非推奨となりました。
      </simpara>
     </listitem>
    </varlistentry>

diff --git a/reference/mysqli/mysqli/kill.xml b/reference/mysqli/mysqli/kill.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 7ce9e1661da0479fe49641e3da2c2761cf029d5c Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="mysqli.kill" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -9,6 +9,10 @@
   <refpurpose>サーバーに MySQL スレッドの停止を問い合わせる</refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-4-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <para>&style.oop;</para>
@@ -55,6 +59,30 @@
   &mysqli.conditionalexception;
  </refsect1>
 
+ <refsect1 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>
+       <methodname>mysqli::kill</methodname> と
+       <function>mysqli_kill</function> は非推奨となりました。代わりに
+       <literal>KILL</literal> SQL コマンドを使用してください。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>

diff --git a/reference/mysqli/mysqli/ping.xml b/reference/mysqli/mysqli/ping.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 63b99082ef83eade08151f8cb528246fded81db9 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 7ce9e1661da0479fe49641e3da2c2761cf029d5c Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="mysqli.ping" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -9,6 +9,10 @@
   <refpurpose>サーバーとの接続をチェックし、もし切断されている場合は再接続を試みる</refpurpose>
  </refnamediv>
 
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-4-0;
+ </refsynopsisdiv>
+
  <refsect1 role="description">
   &reftitle.description;
   <para>&style.oop;</para>
@@ -60,6 +64,31 @@
   &mysqli.conditionalexception;
  </refsect1>
 
+ <refsect1 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>
+       <methodname>mysqli::ping</methodname> と
+       <function>mysqli_ping</function> は非推奨となりました。
+       <literal>reconnect</literal> 機能は
+       PHP 8.2.0 で廃止されたため、この関数はもはや必要ありません。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <example>

diff --git a/reference/mysqli/mysqli/refresh.xml b/reference/mysqli/mysqli/refresh.xml
@@ -1,13 +1,17 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 7ce9e1661da0479fe49641e3da2c2761cf029d5c Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="mysqli.refresh" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>mysqli::refresh</refname>
   <refname>mysqli_refresh</refname>
   <refpurpose>リフレッシュする</refpurpose>
  </refnamediv>
+
+ <refsynopsisdiv>
+  &warn.deprecated.function-8-4-0;
+ </refsynopsisdiv>
 
  <refsect1 role="description">
   &reftitle.description;
@@ -56,6 +60,30 @@
   </para>
  </refsect1>
 
+ <refsect1 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>
+       <methodname>mysqli::refresh</methodname> と
+       <function>mysqli_refresh</function> は非推奨となりました。代わりに
+       <literal>FLUSH</literal> SQL コマンドを使用してください。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>

diff --git a/reference/mysqli/mysqli/store-result.xml b/reference/mysqli/mysqli/store-result.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 90953eddaa06c6c83faf0dea76c241dfafeaa2a1 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 699e596aaba256f7c3c81be8bb309e12fbd03ef4 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="mysqli.store-result" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -99,6 +99,29 @@
   &mysqli.conditionalexception;
  </refsect1>
 
+ <refsect1 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>
+       <parameter>mode</parameter> パラメータの指定は非推奨となりました。
+       PHP 8.1 以降では、このパラメータを指定しても意味はありません。
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

diff --git a/reference/mysqli/mysqli/thread-id.xml b/reference/mysqli/mysqli/thread-id.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 7e5d0d1bb69180c9de1992edf9613215c975fa57 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1afd3581fea176162adacef6dd692dfc114410f3 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 <refentry xml:id="mysqli.thread-id" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>

diff --git a/reference/mysqli/mysqli_stmt/attr-set.xml b/reference/mysqli/mysqli_stmt/attr-set.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 61374bbe228e8e9c55a24aba59a1e2bb2a871148 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 4683a073bf428da8cd06a9bc428a131292c42ba3 Maintainer: takagi Status: ready -->
 <!-- Credits: mumumu -->
 
 <refentry xml:id="mysqli-stmt.attr-set" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -71,6 +71,7 @@
             カーソルの使用時にサーバーからいちどに取得する行数。
             <parameter>value</parameter> に指定できる値の範囲は
             1 から unsigned long の最大値までで、デフォルトは 1 です。
+            PHP 8.4.0 で削除されました。
            </entry>
           </row>
          </tbody>