Skip to content

Commit

Permalink
[PHP 8.4] PDOサブクラス・新メソッド (#205)
Browse files Browse the repository at this point in the history
* 新規ファイルコピー・リビジョン変更・ホワイトスペース修正

* referenceの更新

* 新たなPDOサブクラスとメソッドの翻訳

* 「コメント」「Cスタイル」の改善と「新機能」へのバックポート

* *C 定数* → *C 言語の定数*
  • Loading branch information
KentarouTakeda authored Dec 13, 2024
1 parent 6f7e145 commit 2c97ea1
Show file tree
Hide file tree
Showing 46 changed files with 3,794 additions and 1,287 deletions.
10 changes: 5 additions & 5 deletions appendices/migration84/new-features.xml
Original file line number Diff line number Diff line change
Expand Up @@ -375,7 +375,7 @@ $object = $reflector->newLazyGhost($initializer);
シングルクオートやダブルクオートで囲まれたリテラルでのクオートの二重化によるエスケープ
</member>
<member>
2 つのハイフンとネストされていない C スタイルのコメント
2 つのハイフンによるコメント、ネストされていない C 言語形式のコメント
</member>
</simplelist>
</para>
Expand All @@ -396,7 +396,7 @@ $object = $reflector->newLazyGhost($initializer);
バッククオートで囲まれたリテラルでのクオートの二重化によるエスケープ
</member>
<member>
1 つの空白が続く 2 つのハイフン、ネストされていない C スタイルのコメント
2 つのハイフンによるコメント、C 言語形式のコメント
<literal>#</literal> によるコメント
</member>
</simplelist>
Expand All @@ -414,13 +414,13 @@ $object = $reflector->newLazyGhost($initializer);
シングルクオートやダブルクオートで囲まれたリテラルでのクオートの二重化によるエスケープ
</member>
<member>
C スタイルの「エスケープ」文字列リテラル (<literal>E'string'</literal>)
C 言語形式の「エスケープ」文字列リテラル (<literal>E'string'</literal>)
</member>
<member>
ドル記号で囲まれた文字列リテラル
</member>
<member>
2 つのハイフンとネストされていない C スタイルのコメント
2 つのハイフンによるコメント、ネストされていない C 言語形式のコメント
</member>
<member>
<literal>?</literal> 演算子のエスケープシーケンスとしての <literal>??</literal> のサポート
Expand All @@ -444,7 +444,7 @@ $object = $reflector->newLazyGhost($initializer);
識別子の角括弧によるクオート
</member>
<member>
2 つのハイフンとネストされていない C スタイルのコメント
2 つのハイフンとネストされていない C 言語形式のコメント
</member>
</simplelist>
</para>
Expand Down
77 changes: 77 additions & 0 deletions reference/pdo/pdo/connect.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 7dd805d34addc6e98afaa0b3851c8656afbec9b6 Maintainer: KentarouTakeda Status: ready -->
<!-- CREDITS: KentarouTakeda -->
<refentry xml:id="pdo.connect" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<refnamediv>
<refname>PDO::connect</refname>
<refpurpose>データベースに接続しドライバが対応する PDO サブクラスを返す</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="PDO">
<modifier>public</modifier> <modifier>static</modifier> <type>static</type><methodname>PDO::connect</methodname>
<methodparam><type>string</type><parameter>dsn</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><modifier role="attribute">#[\SensitiveParameter]</modifier><type class="union"><type>string</type><type>null</type></type><parameter>password</parameter><initializer>&null;</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<simpara>
接続するデータベースに対応する <classname>PDO</classname> サブクラスが
存在する場合そのインスタンスを、
存在しない場合は汎用的な <classname>PDO</classname> インスタンスを作成します。
</simpara>
</refsect1>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo.construct')/db:refsect1[@role='parameters']/.)">
<xi:fallback/>
</xi:include>

<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
接続するデータベースに対応する <classname>PDO</classname> サブクラスが
存在する場合そのインスタンス、
または汎用的な <classname>PDO</classname> インスタンスを返します。
</simpara>
</refsect1>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo.construct')/db:refsect1[@role='errors']/.)">
<xi:fallback/>
</xi:include>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><classname>Pdo\Dblib</classname></member>
<member><classname>Pdo\Firebird</classname></member>
<member><classname>Pdo\Mysql</classname></member>
<member><classname>Pdo\Odbc</classname></member>
<member><classname>Pdo\Pgsql</classname></member>
<member><classname>Pdo\Sqlite</classname></member>
<member><methodname>PDO::__construct</methodname></member>
</simplelist>
</refsect1>

</refentry>
<!-- 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
-->
5 changes: 1 addition & 4 deletions reference/pdo/pdo/construct.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 7dd805d34addc6e98afaa0b3851c8656afbec9b6 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka,mumumu -->
<refentry xml:id="pdo.construct" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand Down Expand Up @@ -112,7 +112,6 @@
<refsect1 role="errors">
&reftitle.errors;
<para>
<methodname>PDO::__construct</methodname> は、
指定されたデータベースへの接続に失敗した場合、
<constant>PDO::ATTR_ERRMODE</constant> が設定されているかどうかに関わらず、
<classname>PDOException</classname> をスローします。
Expand Down Expand Up @@ -193,7 +192,6 @@ $dbh = new PDO($dsn, $user, $password);
</example>
</para>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
Expand All @@ -215,4 +213,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

166 changes: 166 additions & 0 deletions reference/pdo_dblib/pdo-dblib.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,166 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 379d23588def29a360fca16d5daec6c659e13509 Maintainer: KentarouTakeda Status: ready -->
<!-- CREDITS: KentarouTakeda -->
<reference xml:id="class.pdo-dblib" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Pdo\Dblib クラス</title>
<titleabbrev>Pdo\Dblib</titleabbrev>

<partintro>

<!-- {{{ ClassName intro -->
<section xml:id="pdo-dblib.intro">
&reftitle.intro;
<simpara>
DBLib PDO ドライバによる接続を示す <classname>PDO</classname> サブクラスです。
</simpara>
</section>
<!-- }}} -->

<section xml:id="pdo-dblib.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis class="class">
<ooclass>
<classname>Pdo\Dblib</classname>
</ooclass>
<ooclass>
<modifier>extends</modifier>
<classname>PDO</classname>
</ooclass>
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
<xi:fallback/>
</xi:include>
<classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-dblib.constants.attr-connection-timeout">Pdo\Dblib::ATTR_CONNECTION_TIMEOUT</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-dblib.constants.attr-query-timeout">Pdo\Dblib::ATTR_QUERY_TIMEOUT</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-dblib.constants.attr-stringify-uniqueidentifier">Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-dblib.constants.attr-version">Pdo\Dblib::ATTR_VERSION</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-dblib.constants.attr-tds-version">Pdo\Dblib::ATTR_TDS_VERSION</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-dblib.constants.attr-skip-empty-rowsets">Pdo\Dblib::ATTR_SKIP_EMPTY_ROWSETS</varname>
</fieldsynopsis>
<fieldsynopsis>
<modifier>public</modifier>
<modifier>const</modifier>
<type>int</type>
<varname linkend="pdo-dblib.constants.attr-datetime-convert">Pdo\Dblib::ATTR_DATETIME_CONVERT</varname>
</fieldsynopsis>
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])">
<xi:fallback/>
</xi:include>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])">
<xi:fallback/>
</xi:include>
</classsynopsis>
<!-- }}} -->

</section>

<section xml:id="pdo-dblib.constants">
&reftitle.constants;
<variablelist>
<varlistentry xml:id="pdo-dblib.constants.attr-connection-timeout">
<term><constant>Pdo\Dblib::ATTR_CONNECTION_TIMEOUT</constant></term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-dblib.constants.attr-query-timeout">
<term><constant>Pdo\Dblib::ATTR_QUERY_TIMEOUT</constant></term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-dblib.constants.attr-stringify-uniqueidentifier">
<term><constant>Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</constant></term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-dblib.constants.attr-version">
<term><constant>Pdo\Dblib::ATTR_VERSION</constant></term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-dblib.constants.attr-tds-version">
<term><constant>Pdo\Dblib::ATTR_TDS_VERSION</constant></term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-dblib.constants.attr-skip-empty-rowsets">
<term><constant>Pdo\Dblib::ATTR_SKIP_EMPTY_ROWSETS</constant></term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-dblib.constants.attr-datetime-convert">
<term><constant>Pdo\Dblib::ATTR_DATETIME_CONVERT</constant></term>
<listitem>
<simpara>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</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
-->
6 changes: 3 additions & 3 deletions reference/pdo_firebird/constants.xml
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
</term>
<listitem>
<para>
<constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant> &Alias;
<constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant> &Alias;
</para>
</listitem>
</varlistentry>
Expand All @@ -22,7 +22,7 @@
</term>
<listitem>
<para>
<constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant> &Alias;
<constant>Pdo\Firebird::ATTR_TIME_FORMAT</constant> &Alias;
</para>
</listitem>
</varlistentry>
Expand All @@ -33,7 +33,7 @@
</term>
<listitem>
<para>
<constant>Pdo\Firebird::ATTR_TIMESTAMP_FORMAT</constant> &Alias;
<constant>Pdo\Firebird::ATTR_TIMESTAMP_FORMAT</constant> &Alias;
</para>
</listitem>
</varlistentry>
Expand Down
Loading

0 comments on commit 2c97ea1

Please sign in to comment.