Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[PHP 8.4] PDOサブクラス・新メソッド #205

Merged
merged 5 commits into from
Dec 13, 2024
Merged

[PHP 8.4] PDOサブクラス・新メソッド #205

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
b989320
新規ファイルコピー・リビジョン変更・ホワイトスペース修正
KentarouTakeda Dec 7, 2024
32c8ae9
referenceの更新
KentarouTakeda Dec 7, 2024
2b83a2b
新たなPDOサブクラスとメソッドの翻訳
KentarouTakeda Dec 7, 2024
5727ee3
「コメント」「Cスタイル」の改善と「新機能」へのバックポート
KentarouTakeda Dec 9, 2024
1044fa7
*C 定数* → *C 言語の定数*
KentarouTakeda Dec 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions appendices/migration84/new-features.xml
View file
Open in desktop
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
View file
Open in desktop
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
View file
Open in desktop
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
View file
Open in desktop
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
View file
Open in desktop
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