Skip to content

pdo: PHP 8.5.0 の非推奨と pdo_pgsql の COPY/LOB メソッドを同期 #406

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

Open
KentarouTakeda wants to merge 1 commit into
base: master
Choose a base branch
from
Open

pdo: PHP 8.5.0 の非推奨と pdo_pgsql の COPY/LOB メソッドを同期 #406

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
6 changes: 3 additions & 3 deletions appendices/migration84/other-changes.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: 0f1d7fba407bd1385616508a1e42e31fe009bff2 Maintainer: KentarouTakeda Status: ready -->
<!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: KentarouTakeda Status: ready -->
<!-- Credits: KentarouTakeda -->
<sect1 xml:id="migration84.other-changes">
<title>その他の変更</title>
Expand Down Expand Up @@ -250,7 +250,7 @@
</simpara>

<simpara>
<constant>PDO::PGSQL_ATTR_RESULT_MEMORY_SIZE</constant> が追加されました。
<constant>Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</constant> が追加されました。
サポートされているドライバで <methodname>PDO::getAttribute</methodname> を使用して
クエリ結果のメモリ使用量を取得できるようになりました。
</simpara>
Expand Down Expand Up @@ -323,7 +323,7 @@
<title>PDO_PGSQL</title>

<simpara>
<constant>PDO::PGSQL_ATTR_RESULT_MEMORY_SIZE</constant>
<constant>Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</constant>
によるクエリのメモリ使用量の取得をサポートしました。
</simpara>

Expand Down
15 changes: 14 additions & 1 deletion reference/pdo/constants.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: 5d8e96f9b174f7471daebce760657eb0f190b0ba Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: mumumu Status: ready -->
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
<appendix xml:id="pdo.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
Expand Down Expand Up @@ -256,6 +256,13 @@
プリフェッチサイズを大きくするとパフォーマンスは向上しますが、
メモリ使用量は増加します。
</simpara>
<simpara>
一方 PDO_PGSQL ドライバは、この属性をトグルとして扱います。
PHP 8.5.0 以降、値 <literal>0</literal> を指定すると遅延（1行ずつの）フェッチが有効になります。
詳細は
<link linkend="pdo-pgsql.constants.attr-prefetch">PDO_PGSQL ドライバのドキュメント</link>
を参照ください。
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.attr-timeout">
Expand Down Expand Up @@ -746,6 +753,12 @@
(<type>int</type>)
</term>
<listitem>
<warning>
<simpara>
PHP 8.5.0 以降、この定数は<emphasis>非推奨</emphasis>となりました。
代わりに <constant>Pdo\Sqlite::DETERMINISTIC</constant> を使用してください。
</simpara>
</warning>
<simpara>
<methodname>PDO::sqliteCreateFunction</methodname>
で作られる関数が決定論的であることを指定します。
Expand Down
21 changes: 14 additions & 7 deletions reference/pdo_firebird/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,18 +1,25 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b9cf1a2e7307131913ac3c16c2fb67ed9ad38527 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: takagi Status: ready -->
<section xml:id="ref.pdo-firebird.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&pdo.driver-constants;
<warning>
<simpara>
以下の定数は、PHP 8.5.0 以降<emphasis>非推奨</emphasis>となりました。
代わりに、対応する <classname>Pdo\Firebird</classname>
定数を使用してください。
</simpara>
</warning>
<variablelist>
<varlistentry xml:id="pdo.constants.fb-attr-date-format">
<term>
<constant>PDO::FB_ATTR_DATE_FORMAT</constant>
(<type>int</type>)
</term>
<listitem>
<para>
<simpara>
<constant>Pdo\Firebird::ATTR_DATE_FORMAT</constant> &Alias;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.fb-attr-time-format">
Expand All @@ -21,9 +28,9 @@
(<type>int</type>)
</term>
<listitem>
<para>
<simpara>
<constant>Pdo\Firebird::ATTR_TIME_FORMAT</constant> &Alias;
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.fb-attr-timestamp-format">
Expand All @@ -32,9 +39,9 @@
(<type>int</type>)
</term>
<listitem>
<para>
<simpara>
<constant>Pdo\Firebird::ATTR_TIMESTAMP_FORMAT</constant> &Alias;
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
Expand Down
8 changes: 7 additions & 1 deletion reference/pdo_mysql/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,16 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 5d8e96f9b174f7471daebce760657eb0f190b0ba Maintainer: takagi Status: ready -->
<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->
<section xml:id="ref.pdo-mysql.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&pdo.driver-constants;
<warning>
<simpara>
以下の定数は、PHP 8.5.0 以降<emphasis>非推奨</emphasis>となりました。
代わりに、対応する <classname>Pdo\Mysql</classname> 定数を使用してください。
</simpara>
</warning>
<variablelist>
<varlistentry xml:id="pdo.constants.mysql-attr-use-buffered-query">
<term>
Expand Down
18 changes: 14 additions & 4 deletions reference/pdo_odbc/constants.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: 220e1d0ef80ba8f68254db56ee9f2203be4cd8e6 Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 8d40a1fab3f89d6e35caece522991b67fb9df246 Maintainer: mumumu Status: ready -->

<section xml:id="pdo-odbc.global.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
Expand All @@ -12,11 +12,21 @@
(<type>string</type>)
</term>
<listitem>
<para>

</para>
<simpara>
PDO_ODBC 拡張モジュールがリンクしている ODBC ライブラリを表します。
取り得る値は、<literal>unixODBC</literal>、<literal>iODBC</literal>、
<literal>generic</literal> などです。
</simpara>
</listitem>
</varlistentry>
</variablelist>
<warning>
<simpara>
以下の定数は、PHP 8.5.0 以降<emphasis>非推奨</emphasis>となりました。
代わりに、対応する <classname>Pdo\Odbc</classname> 定数を使用してください。
</simpara>
</warning>
<variablelist>
<varlistentry xml:id="pdo.constants.odbc-attr-use-cursor-library">
<term>
<constant>PDO::ODBC_ATTR_USE_CURSOR_LIBRARY</constant>
Expand Down
65 changes: 63 additions & 2 deletions reference/pdo_pgsql/constants.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: 9b69a8dcce47d6619d6459914e784627cbb02a5f Maintainer: mumumu Status: ready -->
<!-- EN-Revision: 858400b07586b88dcb1e17a95e7a178b54b89d86 Maintainer: mumumu Status: ready -->
<section xml:id="ref.pdo-pgsql.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&pdo.driver-constants;
Expand All @@ -12,7 +12,68 @@
</term>
<listitem>
<simpara>
<constant>Pdo\Pgsql::ATTR_DISABLE_PREPARES</constant> &Alias;
<constant>Pdo\Pgsql::ATTR_DISABLE_PREPARES</constant> &Alias;。
PHP 8.5.0 以降、この定数は非推奨です。
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.pgsql-transaction-idle">
<term>
<constant>PDO::PGSQL_TRANSACTION_IDLE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<constant>Pdo\Pgsql::TRANSACTION_IDLE</constant> と同等です。
PHP 8.5.0 以降、この定数は効果がないため非推奨です。
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.pgsql-transaction-active">
<term>
<constant>PDO::PGSQL_TRANSACTION_ACTIVE</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<constant>Pdo\Pgsql::TRANSACTION_ACTIVE</constant> と同等です。
PHP 8.5.0 以降、この定数は効果がないため非推奨です。
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.pgsql-transaction-intrans">
<term>
<constant>PDO::PGSQL_TRANSACTION_INTRANS</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<constant>Pdo\Pgsql::TRANSACTION_INTRANS</constant> と同等です。
PHP 8.5.0 以降、この定数は効果がないため非推奨です。
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.pgsql-transaction-inerror">
<term>
<constant>PDO::PGSQL_TRANSACTION_INERROR</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<constant>Pdo\Pgsql::TRANSACTION_INERROR</constant> と同等です。
PHP 8.5.0 以降、この定数は効果がないため非推奨です。
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo.constants.pgsql-transaction-unknown">
<term>
<constant>PDO::PGSQL_TRANSACTION_UNKNOWN</constant>
(<type>int</type>)
</term>
<listitem>
<simpara>
<constant>Pdo\Pgsql::TRANSACTION_UNKNOWN</constant> と同等です。
PHP 8.5.0 以降、この定数は効果がないため非推奨です。
</simpara>
</listitem>
</varlistentry>
Expand Down
63 changes: 51 additions & 12 deletions reference/pdo_pgsql/pdo-pgsql.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3f82c54505bbf99a7dfdee2ae7f674b1e2719bd3 Maintainer: KentarouTakeda Status: ready -->
<!-- EN-Revision: 205c3b8ad9af665e2b49dcc6020005bb479217a3 Maintainer: KentarouTakeda Status: ready -->
<!-- CREDITS: mumumu,KentarouTakeda -->
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" xml:id="class.pdo-pgsql" role="class">
<reference xml:id="class.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude" role="class">
<title>Pdo\Pgsql クラス</title>
<titleabbrev>Pdo\Pgsql</titleabbrev>

Expand Down Expand Up @@ -157,39 +157,78 @@
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.transaction-idle">
<term><constant>Pdo\Pgsql::TRANSACTION_IDLE</constant></term>
<varlistentry xml:id="pdo-pgsql.constants.attr-prefetch">
<term><constant>PDO::ATTR_PREFETCH</constant></term>
<listitem>
<simpara>
PHP 8.5.0 以降、この属性を <literal>0</literal> に設定すると、遅延（1行ずつの）フェッチが有効になります。
最初の <methodname>PDOStatement::fetch</methodname> の呼び出しの前に結果セット全体をメモリにバッファリングするのではなく、
フェッチするたびにサーバーから1行ずつ取得します。
これによって、大きな結果セットでのメモリ使用量を削減できます。
それ以外の値の場合は、デフォルトのバッファリング動作のままになります。
</simpara>
<simpara>
この属性は、<methodname>PDO::setAttribute</methodname> を使って接続ごとに設定するか、
<methodname>PDO::prepare</methodname> や <methodname>PDO::query</methodname>
のドライバオプションを使ってステートメントごとに設定できます。
</simpara>
<caution>
<simpara>
遅延モードでは、1つの接続で同時にアクティブにできるステートメントは1つだけです。
別のステートメントを実行すると、前のステートメントの読み取っていない行は暗黙のうちに破棄されます。
エラーは発生しません。
</simpara>
</caution>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.transaction-idle">
<term><constant>Pdo\Pgsql::TRANSACTION_IDLE</constant></term>
<listitem>
<warning>
<simpara>
この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。
</simpara>
</warning>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.transaction-active">
<term><constant>Pdo\Pgsql::TRANSACTION_ACTIVE</constant></term>
<listitem>
<simpara>
</simpara>
<warning>
<simpara>
この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。
</simpara>
</warning>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.transaction-intrans">
<term><constant>Pdo\Pgsql::TRANSACTION_INTRANS</constant></term>
<listitem>
<simpara>
</simpara>
<warning>
<simpara>
この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。
</simpara>
</warning>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.transaction-inerror">
<term><constant>Pdo\Pgsql::TRANSACTION_INERROR</constant></term>
<listitem>
<simpara>
</simpara>
<warning>
<simpara>
この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。
</simpara>
</warning>
</listitem>
</varlistentry>
<varlistentry xml:id="pdo-pgsql.constants.transaction-unknown">
<term><constant>Pdo\Pgsql::TRANSACTION_UNKNOWN</constant></term>
<listitem>
<simpara>
</simpara>
<warning>
<simpara>
この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。
</simpara>
</warning>
</listitem>
</varlistentry>
</variablelist>
Expand Down
Loading
Loading