Skip to content

Commit 2c97ea1

Browse files
KentarouTakedaKentarouTakeda
authored
[PHP 8.4] PDOサブクラス・新メソッド (#205)
* 新規ファイルコピー・リビジョン変更・ホワイトスペース修正 * referenceの更新 * 新たなPDOサブクラスとメソッドの翻訳 * 「コメント」「Cスタイル」の改善と「新機能」へのバックポート * *C 定数* → *C 言語の定数*
1 parent 6f7e145 commit 2c97ea1

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+3794
-1287
lines changed

‎appendices/migration84/new-features.xml

+5-5
Original file line numberDiff line numberDiff line change
@@ -375,7 +375,7 @@ $object = $reflector->newLazyGhost($initializer);
375375
シングルクオートやダブルクオートで囲まれたリテラルでのクオートの二重化によるエスケープ
376376
</member>
377377
<member>
378-
2 つのハイフンとネストされていない C スタイルのコメント
378+
2 つのハイフンによるコメント、ネストされていない C 言語形式のコメント
379379
</member>
380380
</simplelist>
381381
</para>
@@ -396,7 +396,7 @@ $object = $reflector->newLazyGhost($initializer);
396396
バッククオートで囲まれたリテラルでのクオートの二重化によるエスケープ
397397
</member>
398398
<member>
399-
1 つの空白が続く 2 つのハイフン、ネストされていない C スタイルのコメント、
399+
2 つのハイフンによるコメント、C 言語形式のコメント、
400400
<literal>#</literal> によるコメント
401401
</member>
402402
</simplelist>
@@ -414,13 +414,13 @@ $object = $reflector->newLazyGhost($initializer);
414414
シングルクオートやダブルクオートで囲まれたリテラルでのクオートの二重化によるエスケープ
415415
</member>
416416
<member>
417-
C スタイルの「エスケープ」文字列リテラル (<literal>E'string'</literal>)
417+
C 言語形式の「エスケープ」文字列リテラル (<literal>E'string'</literal>)
418418
</member>
419419
<member>
420420
ドル記号で囲まれた文字列リテラル
421421
</member>
422422
<member>
423-
2 つのハイフンとネストされていない C スタイルのコメント
423+
2 つのハイフンによるコメント、ネストされていない C 言語形式のコメント
424424
</member>
425425
<member>
426426
<literal>?</literal> 演算子のエスケープシーケンスとしての <literal>??</literal> のサポート
@@ -444,7 +444,7 @@ $object = $reflector->newLazyGhost($initializer);
444444
識別子の角括弧によるクオート
445445
</member>
446446
<member>
447-
2 つのハイフンとネストされていない C スタイルのコメント
447+
2 つのハイフンとネストされていない C 言語形式のコメント
448448
</member>
449449
</simplelist>
450450
</para>

‎reference/pdo/pdo/connect.xml

+77
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 7dd805d34addc6e98afaa0b3851c8656afbec9b6 Maintainer: KentarouTakeda Status: ready -->
4+
<!-- CREDITS: KentarouTakeda -->
5+
<refentry xml:id="pdo.connect" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
6+
<refnamediv>
7+
<refname>PDO::connect</refname>
8+
<refpurpose>データベースに接続しドライバが対応する PDO サブクラスを返す</refpurpose>
9+
</refnamediv>
10+
11+
<refsect1 role="description">
12+
&reftitle.description;
13+
<methodsynopsis role="PDO">
14+
<modifier>public</modifier> <modifier>static</modifier> <type>static</type><methodname>PDO::connect</methodname>
15+
<methodparam><type>string</type><parameter>dsn</parameter></methodparam>
16+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>username</parameter><initializer>&null;</initializer></methodparam>
17+
<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>
18+
<methodparam choice="opt"><type class="union"><type>array</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
19+
</methodsynopsis>
20+
<simpara>
21+
接続するデータベースに対応する <classname>PDO</classname> サブクラスが
22+
存在する場合そのインスタンスを、
23+
存在しない場合は汎用的な <classname>PDO</classname> インスタンスを作成します。
24+
</simpara>
25+
</refsect1>
26+
27+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo.construct')/db:refsect1[@role='parameters']/.)">
28+
<xi:fallback/>
29+
</xi:include>
30+
31+
<refsect1 role="returnvalues">
32+
&reftitle.returnvalues;
33+
<simpara>
34+
接続するデータベースに対応する <classname>PDO</classname> サブクラスが
35+
存在する場合そのインスタンス、
36+
または汎用的な <classname>PDO</classname> インスタンスを返します。
37+
</simpara>
38+
</refsect1>
39+
40+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo.construct')/db:refsect1[@role='errors']/.)">
41+
<xi:fallback/>
42+
</xi:include>
43+
44+
<refsect1 role="seealso">
45+
&reftitle.seealso;
46+
<simplelist>
47+
<member><classname>Pdo\Dblib</classname></member>
48+
<member><classname>Pdo\Firebird</classname></member>
49+
<member><classname>Pdo\Mysql</classname></member>
50+
<member><classname>Pdo\Odbc</classname></member>
51+
<member><classname>Pdo\Pgsql</classname></member>
52+
<member><classname>Pdo\Sqlite</classname></member>
53+
<member><methodname>PDO::__construct</methodname></member>
54+
</simplelist>
55+
</refsect1>
56+
57+
</refentry>
58+
<!-- Keep this comment at the end of the file
59+
Local variables:
60+
mode: sgml
61+
sgml-omittag:t
62+
sgml-shorttag:t
63+
sgml-minimize-attributes:nil
64+
sgml-always-quote-attributes:t
65+
sgml-indent-step:1
66+
sgml-indent-data:t
67+
indent-tabs-mode:nil
68+
sgml-parent-document:nil
69+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
70+
sgml-exposed-tags:nil
71+
sgml-local-catalogs:nil
72+
sgml-local-ecat-files:nil
73+
End:
74+
vim600: syn=xml fen fdm=syntax fdl=2 si
75+
vim: et tw=78 syn=sgml
76+
vi: ts=1 sw=1
77+
-->

‎reference/pdo/pdo/construct.xml

+1-4
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<?xml version="1.0" encoding="utf-8"?>
22
<!-- $Revision$ -->
3-
<!-- EN-Revision: d76a7fe17dd2488e47d664a8ab38e161b13ac843 Maintainer: takagi Status: ready -->
3+
<!-- EN-Revision: 7dd805d34addc6e98afaa0b3851c8656afbec9b6 Maintainer: takagi Status: ready -->
44
<!-- CREDITS: hirokawa,shimooka,mumumu -->
55
<refentry xml:id="pdo.construct" xmlns="http://docbook.org/ns/docbook">
66
<refnamediv>
@@ -112,7 +112,6 @@
112112
<refsect1 role="errors">
113113
&reftitle.errors;
114114
<para>
115-
<methodname>PDO::__construct</methodname> は、
116115
指定されたデータベースへの接続に失敗した場合、
117116
<constant>PDO::ATTR_ERRMODE</constant> が設定されているかどうかに関わらず、
118117
<classname>PDOException</classname> をスローします。
@@ -193,7 +192,6 @@ $dbh = new PDO($dsn, $user, $password);
193192
</example>
194193
</para>
195194
</refsect1>
196-
197195
</refentry>
198196
<!-- Keep this comment at the end of the file
199197
Local variables:
@@ -215,4 +213,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
215213
vim: et tw=78 syn=sgml
216214
vi: ts=1 sw=1
217215
-->
218-

‎reference/pdo_dblib/pdo-dblib.xml

+166
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,166 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- $Revision$ -->
3+
<!-- EN-Revision: 379d23588def29a360fca16d5daec6c659e13509 Maintainer: KentarouTakeda Status: ready -->
4+
<!-- CREDITS: KentarouTakeda -->
5+
<reference xml:id="class.pdo-dblib" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
6+
<title>Pdo\Dblib クラス</title>
7+
<titleabbrev>Pdo\Dblib</titleabbrev>
8+
9+
<partintro>
10+
11+
<!-- {{{ ClassName intro -->
12+
<section xml:id="pdo-dblib.intro">
13+
&reftitle.intro;
14+
<simpara>
15+
DBLib PDO ドライバによる接続を示す <classname>PDO</classname> サブクラスです。
16+
</simpara>
17+
</section>
18+
<!-- }}} -->
19+
20+
<section xml:id="pdo-dblib.synopsis">
21+
&reftitle.classsynopsis;
22+
<!-- {{{ Synopsis -->
23+
<classsynopsis class="class">
24+
<ooclass>
25+
<classname>Pdo\Dblib</classname>
26+
</ooclass>
27+
<ooclass>
28+
<modifier>extends</modifier>
29+
<classname>PDO</classname>
30+
</ooclass>
31+
<classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
32+
<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;']]))">
33+
<xi:fallback/>
34+
</xi:include>
35+
<classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
36+
<fieldsynopsis>
37+
<modifier>public</modifier>
38+
<modifier>const</modifier>
39+
<type>int</type>
40+
<varname linkend="pdo-dblib.constants.attr-connection-timeout">Pdo\Dblib::ATTR_CONNECTION_TIMEOUT</varname>
41+
</fieldsynopsis>
42+
<fieldsynopsis>
43+
<modifier>public</modifier>
44+
<modifier>const</modifier>
45+
<type>int</type>
46+
<varname linkend="pdo-dblib.constants.attr-query-timeout">Pdo\Dblib::ATTR_QUERY_TIMEOUT</varname>
47+
</fieldsynopsis>
48+
<fieldsynopsis>
49+
<modifier>public</modifier>
50+
<modifier>const</modifier>
51+
<type>int</type>
52+
<varname linkend="pdo-dblib.constants.attr-stringify-uniqueidentifier">Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</varname>
53+
</fieldsynopsis>
54+
<fieldsynopsis>
55+
<modifier>public</modifier>
56+
<modifier>const</modifier>
57+
<type>int</type>
58+
<varname linkend="pdo-dblib.constants.attr-version">Pdo\Dblib::ATTR_VERSION</varname>
59+
</fieldsynopsis>
60+
<fieldsynopsis>
61+
<modifier>public</modifier>
62+
<modifier>const</modifier>
63+
<type>int</type>
64+
<varname linkend="pdo-dblib.constants.attr-tds-version">Pdo\Dblib::ATTR_TDS_VERSION</varname>
65+
</fieldsynopsis>
66+
<fieldsynopsis>
67+
<modifier>public</modifier>
68+
<modifier>const</modifier>
69+
<type>int</type>
70+
<varname linkend="pdo-dblib.constants.attr-skip-empty-rowsets">Pdo\Dblib::ATTR_SKIP_EMPTY_ROWSETS</varname>
71+
</fieldsynopsis>
72+
<fieldsynopsis>
73+
<modifier>public</modifier>
74+
<modifier>const</modifier>
75+
<type>int</type>
76+
<varname linkend="pdo-dblib.constants.attr-datetime-convert">Pdo\Dblib::ATTR_DATETIME_CONVERT</varname>
77+
</fieldsynopsis>
78+
<classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
79+
<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'])">
80+
<xi:fallback/>
81+
</xi:include>
82+
<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'])">
83+
<xi:fallback/>
84+
</xi:include>
85+
</classsynopsis>
86+
<!-- }}} -->
87+
88+
</section>
89+
90+
<section xml:id="pdo-dblib.constants">
91+
&reftitle.constants;
92+
<variablelist>
93+
<varlistentry xml:id="pdo-dblib.constants.attr-connection-timeout">
94+
<term><constant>Pdo\Dblib::ATTR_CONNECTION_TIMEOUT</constant></term>
95+
<listitem>
96+
<simpara>
97+
</simpara>
98+
</listitem>
99+
</varlistentry>
100+
<varlistentry xml:id="pdo-dblib.constants.attr-query-timeout">
101+
<term><constant>Pdo\Dblib::ATTR_QUERY_TIMEOUT</constant></term>
102+
<listitem>
103+
<simpara>
104+
</simpara>
105+
</listitem>
106+
</varlistentry>
107+
<varlistentry xml:id="pdo-dblib.constants.attr-stringify-uniqueidentifier">
108+
<term><constant>Pdo\Dblib::ATTR_STRINGIFY_UNIQUEIDENTIFIER</constant></term>
109+
<listitem>
110+
<simpara>
111+
</simpara>
112+
</listitem>
113+
</varlistentry>
114+
<varlistentry xml:id="pdo-dblib.constants.attr-version">
115+
<term><constant>Pdo\Dblib::ATTR_VERSION</constant></term>
116+
<listitem>
117+
<simpara>
118+
</simpara>
119+
</listitem>
120+
</varlistentry>
121+
<varlistentry xml:id="pdo-dblib.constants.attr-tds-version">
122+
<term><constant>Pdo\Dblib::ATTR_TDS_VERSION</constant></term>
123+
<listitem>
124+
<simpara>
125+
</simpara>
126+
</listitem>
127+
</varlistentry>
128+
<varlistentry xml:id="pdo-dblib.constants.attr-skip-empty-rowsets">
129+
<term><constant>Pdo\Dblib::ATTR_SKIP_EMPTY_ROWSETS</constant></term>
130+
<listitem>
131+
<simpara>
132+
</simpara>
133+
</listitem>
134+
</varlistentry>
135+
<varlistentry xml:id="pdo-dblib.constants.attr-datetime-convert">
136+
<term><constant>Pdo\Dblib::ATTR_DATETIME_CONVERT</constant></term>
137+
<listitem>
138+
<simpara>
139+
</simpara>
140+
</listitem>
141+
</varlistentry>
142+
</variablelist>
143+
</section>
144+
</partintro>
145+
146+
</reference>
147+
<!-- Keep this comment at the end of the file
148+
Local variables:
149+
mode: sgml
150+
sgml-omittag:t
151+
sgml-shorttag:t
152+
sgml-minimize-attributes:nil
153+
sgml-always-quote-attributes:t
154+
sgml-indent-step:1
155+
sgml-indent-data:t
156+
indent-tabs-mode:nil
157+
sgml-parent-document:nil
158+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
159+
sgml-exposed-tags:nil
160+
sgml-local-catalogs:nil
161+
sgml-local-ecat-files:nil
162+
End:
163+
vim600: syn=xml fen fdm=syntax fdl=2 si
164+
vim: et tw=78 syn=sgml
165+
vi: ts=1 sw=1
166+
-->

‎reference/pdo_firebird/constants.xml

+3-3
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
</term>
1212
<listitem>
1313
<para>
14-
<constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant> &Alias;。
14+
<constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant> &Alias;
1515
</para>
1616
</listitem>
1717
</varlistentry>
@@ -22,7 +22,7 @@
2222
</term>
2323
<listitem>
2424
<para>
25-
<constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant> &Alias;。
25+
<constant>Pdo\Firebird::ATTR_TIME_FORMAT</constant> &Alias;
2626
</para>
2727
</listitem>
2828
</varlistentry>
@@ -33,7 +33,7 @@
3333
</term>
3434
<listitem>
3535
<para>
36-
<constant>Pdo\Firebird::ATTR_TIMESTAMP_FORMAT</constant> &Alias;。
36+
<constant>Pdo\Firebird::ATTR_TIMESTAMP_FORMAT</constant> &Alias;
3737
</para>
3838
</listitem>
3939
</varlistentry>

0 commit comments

Comments
 (0)