From b4a510be028703693d4c6e1b421081a591caa5a1 Mon Sep 17 00:00:00 2001
From: "SUMIDA, Ippei" <ippey.s@gmail.com>
Date: Sat, 23 Nov 2024 22:09:57 +0900
Subject: [PATCH] [PHP 8.4] DBA resource to Object conversions (#185)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* DBAの翻訳

* class.dba-connection ページタイトルの翻訳

* php/doc-en@1a53c22 をチェリーピックで翻訳追加

---------

Co-authored-by: 武田 憲太郎 <takeda@youmind.jp>
---
 reference/dba/book.xml                | 12 +++---
 reference/dba/dba.connection.xml      | 57 +++++++++++++++++++++++++++
 reference/dba/functions/dba-open.xml  | 13 ++++--
 reference/dba/functions/dba-popen.xml | 13 ++++--
 4 files changed, 84 insertions(+), 11 deletions(-)
 create mode 100644 reference/dba/dba.connection.xml

diff --git a/reference/dba/book.xml b/reference/dba/book.xml
index 32cbdec4ad8..97b01d8bdd0 100644
--- a/reference/dba/book.xml
+++ b/reference/dba/book.xml
@@ -1,13 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: takagi Status: ready -->
+<!-- EN-Revision: 1a53c22773e4e08ab5b67ba3d4d91cc011047da5 Maintainer: takagi Status: ready -->
 <!-- CREDITS: hirokawa -->
- 
 <book xml:id="book.dba" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundled" ?>
  <title>データベース (dbm 形式) 抽象化レイヤ</title>
  <titleabbrev>DBA</titleabbrev>
- 
+
  <!-- {{{ preface -->
  <preface xml:id="intro.dba">
   &reftitle.intro;
@@ -22,14 +21,17 @@
   </para>
  </preface>
  <!-- }}} -->
- 
+
  &reference.dba.setup;
  &reference.dba.constants;
  &reference.dba.examples;
+
+ <!-- Dba\Connection class -->
+ &reference.dba.dba.connection;
+ <!-- dba_*() functions -->
  &reference.dba.reference;
 
 </book>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/dba/dba.connection.xml b/reference/dba/dba.connection.xml
new file mode 100644
index 00000000000..735a71204b0
--- /dev/null
+++ b/reference/dba/dba.connection.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: Ippey Status: ready -->
+<!-- CREDITS: ippey -->
+
+<reference xml:id="class.dba-connection" role="class" xmlns="http://docbook.org/ns/docbook">
+ <title>Dba\Connection クラス</title>
+ <titleabbrev>Dba\Connection</titleabbrev>
+
+ <partintro>
+
+  <!-- {{{ Dba\Connection intro -->
+  <section xml:id="dba-connection.intro">
+   &reftitle.intro;
+   <para>
+    PHP 8.4.0 以降、 <literal>dba</literal> リソースを置き換える完全不透明クラスです。
+   </para>
+  </section>
+  <!-- }}} -->
+
+  <section xml:id="dba-connection.synopsis">
+   &reftitle.classsynopsis;
+
+   <!-- {{{ Synopsis -->
+   <classsynopsis class="class">
+    <ooclass>
+     <modifier>final</modifier>
+     <classname>Dba\Connection</classname>
+    </ooclass>
+   </classsynopsis>
+   <!-- }}} -->
+
+  </section>
+
+ </partintro>
+
+</reference>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/dba/functions/dba-open.xml b/reference/dba/functions/dba-open.xml
index b221e0a1023..b873535bf3e 100644
--- a/reference/dba/functions/dba-open.xml
+++ b/reference/dba/functions/dba-open.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: e4faf426c06f29bef4b1fbd7043d56f4756a0a50 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: mumumu Status: ready -->
 <refentry xml:id="function.dba-open" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>dba_open</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>resource</type><type>false</type></type><methodname>dba_open</methodname>
+   <type class="union"><type>Dba\Connection</type><type>false</type></type><methodname>dba_open</methodname>
    <methodparam><type>string</type><parameter>path</parameter></methodparam>
    <methodparam><type>string</type><parameter>mode</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
@@ -217,7 +217,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   成功した場合に正のハンドルを返します。
+   成功した場合に <classname>Dba\Connection</classname> インスタンスを返します。
    &return.falseforfailure;。
   </para>
  </refsect1>
@@ -243,6 +243,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <classname>Dba\Connection</classname> インスタンスを返すようになりました。
+       以前は &resource; を返していました。
+      </entry>
+     </row>
      <row>
       <entry>8.2.0</entry>
       <entry>
diff --git a/reference/dba/functions/dba-popen.xml b/reference/dba/functions/dba-popen.xml
index dc4db4fd425..524530fd71e 100644
--- a/reference/dba/functions/dba-popen.xml
+++ b/reference/dba/functions/dba-popen.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 9264401165d31437c4afd80ec936f775ae23d367 Maintainer: mumumu Status: ready -->
+<!-- EN-Revision: 44428b04b7b046593e9ab33874eddd1fea7dfab1 Maintainer: mumumu Status: ready -->
 <refentry xml:id="function.dba-popen" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>dba_popen</refname>
@@ -9,7 +9,7 @@
  <refsect1 role="description">
   &reftitle.description;
   <methodsynopsis>
-   <type class="union"><type>resource</type><type>false</type></type><methodname>dba_popen</methodname>
+   <type class="union"><type>Dba\Connection</type><type>false</type></type><methodname>dba_popen</methodname>
    <methodparam><type>string</type><parameter>path</parameter></methodparam>
    <methodparam><type>string</type><parameter>mode</parameter></methodparam>
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>handler</parameter><initializer>&null;</initializer></methodparam>
@@ -110,7 +110,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   成功した場合に正のハンドルを返します。
+   成功した場合に <classname>Dba\Connection</classname> インスタンスを返します。
    &return.falseforfailure;。
   </para>
  </refsect1>
@@ -136,6 +136,13 @@
      </row>
     </thead>
     <tbody>
+     <row>
+      <entry>8.4.0</entry>
+      <entry>
+       <classname>Dba\Connection</classname> インスタンスを返すようになりました。
+       以前は &resource; を返していました。
+      </entry>
+     </row>
      <row>
       <entry>8.2.0</entry>
       <entry>