diff --git a/appendices/migration84/other-changes.xml b/appendices/migration84/other-changes.xml index d1d546cfda..43dcb12cb6 100644 --- a/appendices/migration84/other-changes.xml +++ b/appendices/migration84/other-changes.xml @@ -1,6 +1,6 @@ - + その他の変更 @@ -250,7 +250,7 @@ - PDO::PGSQL_ATTR_RESULT_MEMORY_SIZE が追加されました。 + Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE が追加されました。 サポートされているドライバで PDO::getAttribute を使用して クエリ結果のメモリ使用量を取得できるようになりました。 @@ -323,7 +323,7 @@ PDO_PGSQL - PDO::PGSQL_ATTR_RESULT_MEMORY_SIZE + Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE によるクエリのメモリ使用量の取得をサポートしました。 diff --git a/reference/pdo/constants.xml b/reference/pdo/constants.xml index a35345336e..d637f6e729 100644 --- a/reference/pdo/constants.xml +++ b/reference/pdo/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -256,6 +256,13 @@ プリフェッチサイズを大きくするとパフォーマンスは向上しますが、 メモリ使用量は増加します。 + + 一方 PDO_PGSQL ドライバは、この属性をトグルとして扱います。 + PHP 8.5.0 以降、値 0 を指定すると遅延（1行ずつの）フェッチが有効になります。 + 詳細は + PDO_PGSQL ドライバのドキュメント + を参照ください。 + @@ -746,6 +753,12 @@ (int) + + + PHP 8.5.0 以降、この定数は非推奨となりました。 + 代わりに Pdo\Sqlite::DETERMINISTIC を使用してください。 + + PDO::sqliteCreateFunction で作られる関数が決定論的であることを指定します。 diff --git a/reference/pdo_firebird/constants.xml b/reference/pdo_firebird/constants.xml index 65d984f440..e167585d11 100644 --- a/reference/pdo_firebird/constants.xml +++ b/reference/pdo_firebird/constants.xml @@ -1,8 +1,15 @@ - +
&reftitle.constants; &pdo.driver-constants; + + + 以下の定数は、PHP 8.5.0 以降非推奨となりました。 + 代わりに、対応する Pdo\Firebird + 定数を使用してください。 + + @@ -10,9 +17,9 @@ (int) - + Pdo\Firebird::ATTR_DATE_FORMAT &Alias; - + @@ -21,9 +28,9 @@ (int) - + Pdo\Firebird::ATTR_TIME_FORMAT &Alias; - + @@ -32,9 +39,9 @@ (int) - + Pdo\Firebird::ATTR_TIMESTAMP_FORMAT &Alias; - + diff --git a/reference/pdo_mysql/constants.xml b/reference/pdo_mysql/constants.xml index 579db8b0e7..5a8786d170 100644 --- a/reference/pdo_mysql/constants.xml +++ b/reference/pdo_mysql/constants.xml @@ -1,10 +1,16 @@ - +
&reftitle.constants; &pdo.driver-constants; + + + 以下の定数は、PHP 8.5.0 以降非推奨となりました。 + 代わりに、対応する Pdo\Mysql 定数を使用してください。 + + diff --git a/reference/pdo_odbc/constants.xml b/reference/pdo_odbc/constants.xml index cffc65b0dd..8aacc49d4c 100644 --- a/reference/pdo_odbc/constants.xml +++ b/reference/pdo_odbc/constants.xml @@ -1,6 +1,6 @@ - +
&reftitle.constants; @@ -12,11 +12,21 @@ (string) - - - + + PDO_ODBC 拡張モジュールがリンクしている ODBC ライブラリを表します。 + 取り得る値は、unixODBC、iODBC、 + generic などです。 + + + + + 以下の定数は、PHP 8.5.0 以降非推奨となりました。 + 代わりに、対応する Pdo\Odbc 定数を使用してください。 + + + PDO::ODBC_ATTR_USE_CURSOR_LIBRARY diff --git a/reference/pdo_pgsql/constants.xml b/reference/pdo_pgsql/constants.xml index 93105524a8..57b14e5aa6 100644 --- a/reference/pdo_pgsql/constants.xml +++ b/reference/pdo_pgsql/constants.xml @@ -1,6 +1,6 @@ - +
&reftitle.constants; &pdo.driver-constants; @@ -12,7 +12,68 @@ - Pdo\Pgsql::ATTR_DISABLE_PREPARES &Alias; + Pdo\Pgsql::ATTR_DISABLE_PREPARES &Alias;。 + PHP 8.5.0 以降、この定数は非推奨です。 + + + + + + PDO::PGSQL_TRANSACTION_IDLE + (int) + + + + Pdo\Pgsql::TRANSACTION_IDLE と同等です。 + PHP 8.5.0 以降、この定数は効果がないため非推奨です。 + + + + + + PDO::PGSQL_TRANSACTION_ACTIVE + (int) + + + + Pdo\Pgsql::TRANSACTION_ACTIVE と同等です。 + PHP 8.5.0 以降、この定数は効果がないため非推奨です。 + + + + + + PDO::PGSQL_TRANSACTION_INTRANS + (int) + + + + Pdo\Pgsql::TRANSACTION_INTRANS と同等です。 + PHP 8.5.0 以降、この定数は効果がないため非推奨です。 + + + + + + PDO::PGSQL_TRANSACTION_INERROR + (int) + + + + Pdo\Pgsql::TRANSACTION_INERROR と同等です。 + PHP 8.5.0 以降、この定数は効果がないため非推奨です。 + + + + + + PDO::PGSQL_TRANSACTION_UNKNOWN + (int) + + + + Pdo\Pgsql::TRANSACTION_UNKNOWN と同等です。 + PHP 8.5.0 以降、この定数は効果がないため非推奨です。 diff --git a/reference/pdo_pgsql/pdo-pgsql.xml b/reference/pdo_pgsql/pdo-pgsql.xml index 836778fc98..72dbb54207 100644 --- a/reference/pdo_pgsql/pdo-pgsql.xml +++ b/reference/pdo_pgsql/pdo-pgsql.xml @@ -1,8 +1,8 @@ - + - + Pdo\Pgsql クラス Pdo\Pgsql @@ -157,39 +157,78 @@ - - Pdo\Pgsql::TRANSACTION_IDLE + + PDO::ATTR_PREFETCH + PHP 8.5.0 以降、この属性を 0 に設定すると、遅延（1行ずつの）フェッチが有効になります。 + 最初の PDOStatement::fetch の呼び出しの前に結果セット全体をメモリにバッファリングするのではなく、 + フェッチするたびにサーバーから1行ずつ取得します。 + これによって、大きな結果セットでのメモリ使用量を削減できます。 + それ以外の値の場合は、デフォルトのバッファリング動作のままになります。 + + この属性は、PDO::setAttribute を使って接続ごとに設定するか、 + PDO::prepare や PDO::query + のドライバオプションを使ってステートメントごとに設定できます。 + + + + 遅延モードでは、1つの接続で同時にアクティブにできるステートメントは1つだけです。 + 別のステートメントを実行すると、前のステートメントの読み取っていない行は暗黙のうちに破棄されます。 + エラーは発生しません。 + + + + + + Pdo\Pgsql::TRANSACTION_IDLE + + + + この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。 + + Pdo\Pgsql::TRANSACTION_ACTIVE - - + + + この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。 + + Pdo\Pgsql::TRANSACTION_INTRANS - - + + + この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。 + + Pdo\Pgsql::TRANSACTION_INERROR - - + + + この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。 + + Pdo\Pgsql::TRANSACTION_UNKNOWN - - + + + この定数は何の効果もなく、PHP 8.5.0 以降は非推奨です。 + + diff --git a/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml b/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml index 2019e69a36..323575fbac 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copyfromarray.xml @@ -1,6 +1,6 @@ - + @@ -13,7 +13,7 @@ public boolPdo\Pgsql::copyFromArray stringtableName - arrayrows + arrayTraversablerows stringseparator"\t" stringnullAs"\\\\N" stringnullfields&null; @@ -40,7 +40,7 @@ rows - separator で区切られたフィールドの文字列の配列 + 各フィールドを separator で区切った文字列の数値添字配列（または Traversable） @@ -79,40 +79,68 @@ - - &reftitle.seealso; diff --git a/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml b/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml index 260e02cede..3beb36620d 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copyfromfile.xml @@ -1,6 +1,6 @@ - + @@ -58,40 +58,46 @@ - - &reftitle.seealso; diff --git a/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml b/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml index a2d7bc1e8f..8354a15688 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copytoarray.xml @@ -1,6 +1,6 @@ - + @@ -52,40 +52,40 @@ - - - &reftitle.seealso; diff --git a/reference/pdo_pgsql/pdo/pgsql/copytofile.xml b/reference/pdo_pgsql/pdo/pgsql/copytofile.xml index c09e197b43..0ee28d8842 100644 --- a/reference/pdo_pgsql/pdo/pgsql/copytofile.xml +++ b/reference/pdo_pgsql/pdo/pgsql/copytofile.xml @@ -1,6 +1,6 @@ - + @@ -49,7 +49,7 @@ fields - 挿入するフィールドの一覧 + エクスポートするフィールドの一覧 @@ -63,50 +63,47 @@ - - - &reftitle.seealso; diff --git a/reference/pdo_pgsql/pdo/pgsql/getnotify.xml b/reference/pdo_pgsql/pdo/pgsql/getnotify.xml index 043538550c..c7089a558d 100644 --- a/reference/pdo_pgsql/pdo/pgsql/getnotify.xml +++ b/reference/pdo_pgsql/pdo/pgsql/getnotify.xml @@ -1,6 +1,6 @@ - + @@ -52,9 +52,12 @@ &reftitle.returnvalues; - ひとつ以上の通知が保留中だった場合、 - message と pid のフィールドを含む1行を返します。 - そうでなければ &false; を返します。 + 通知が保留中だった場合は1行を返し、そうでなければ &false; を返します。 + この行には、message フィールド（チャネル名）と + pid フィールド（通知を送信したバックエンドのプロセス ID）が含まれます。 + 通知が空でないペイロードを伴う場合は、この行に payload フィールドも含まれます。 + PDO::FETCH_NUM の場合、これらのフィールドは + インデックス 0、1、2 にあります。 @@ -76,30 +79,40 @@ - &reftitle.seealso; diff --git a/reference/pdo_pgsql/pdo/pgsql/getpid.xml b/reference/pdo_pgsql/pdo/pgsql/getpid.xml index 7762cc4e36..9636d4ab53 100644 --- a/reference/pdo_pgsql/pdo/pgsql/getpid.xml +++ b/reference/pdo_pgsql/pdo/pgsql/getpid.xml @@ -1,6 +1,6 @@ - + @@ -32,6 +32,34 @@ サーバーのPIDを int として返します。 + + + &reftitle.examples; + + <methodname>Pdo\Pgsql::getPid</methodname> の例 + +getPid(); +?> +]]> + + &example.outputs.similar; + + + + + + + + &reftitle.seealso; + + pg_get_pid + + - + @@ -42,8 +42,11 @@ mode - モードが r の場合、読み込み用のストリームをオープンします。 - モードが w の場合、書き込み用のストリームをオープンします。 + アクセスモード。mode に w または + + が含まれる場合は、読み込みと書き込み用にストリームを + オープンします。そうでない場合は、読み込み専用でオープンします。 + b（バイナリ）フラグは効果がありません。デフォルトの + "rb" は、読み込み用にストリームをオープンします。 @@ -73,10 +76,10 @@ $db = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass); $db->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); $db->beginTransaction(); $stmt = $db->prepare("SELECT oid FROM BLOBS WHERE ident = ?"); -$stmt->execute(array($some_id)); +$stmt->execute([$some_id]); $stmt->bindColumn('oid', $oid, PDO::PARAM_STR); $stmt->fetch(PDO::FETCH_BOUND); -$stream = $db->pgsqlLOBOpen($oid, 'r'); +$stream = $db->lobOpen($oid, 'r'); header("Content-type: application/octet-stream"); fpassthru($stream); ?> diff --git a/reference/pdo_pgsql/pdo/pgsql/lobunlink.xml b/reference/pdo_pgsql/pdo/pgsql/lobunlink.xml index 75dac80552..2a195e5729 100644 --- a/reference/pdo_pgsql/pdo/pgsql/lobunlink.xml +++ b/reference/pdo_pgsql/pdo/pgsql/lobunlink.xml @@ -1,6 +1,6 @@ - + @@ -48,20 +48,21 @@ <methodname>Pdo\Pgsql::lobUnlink</methodname> の例 + この例では、ラージオブジェクトを参照している行を削除する前に、 + そのラージオブジェクトをデータベースから削除します。 Pdo\Pgsql::lobCreate および - Pdo\Pgsql::lobOpen の例で使用した blob - テーブルからラージオブジェクトを参照している行を削除する前に、 - この例ではラージオブジェクトをデータベースから削除します。 + Pdo\Pgsql::lobOpen の例と同じ blob + テーブルを使用します。 setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); $db->beginTransaction(); -$db->pgsqlLOBUnlink($oid); +$db->lobUnlink($oid); $stmt = $db->prepare("DELETE FROM BLOBS where ident = ?"); -$stmt->execute(array($some_id)); +$stmt->execute([$some_id]); $db->commit(); ?> ]]> diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyFromArray.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyFromArray.xml index 421ddc9947..bd2de8327b 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyFromArray.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyFromArray.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlCopyFromArray @@ -8,12 +8,17 @@ Pdo\Pgsql::copyFromArray &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public boolPDO::pgsqlCopyFromArray stringtableName - arrayrows + arrayTraversablerows stringseparator"\t" stringnullAs"\\\\N" stringnullfields&null; @@ -22,6 +27,30 @@ &info.method.alias; Pdo\Pgsql::copyFromArray. + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + rows は Traversable も + 受け付けるようになりました。 + それ以前は、array のみを受け付けていました。 + + + + + + - + PDO::pgsqlCopyFromFile @@ -8,9 +8,14 @@ Pdo\Pgsql::copyFromFile &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public boolPDO::pgsqlCopyFromFile stringtableName stringfilename diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToArray.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToArray.xml index dd4c997a20..c9d4d93b86 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToArray.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToArray.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlCopyToArray @@ -8,9 +8,14 @@ Pdo\Pgsql::copyToArray &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public arrayfalsePDO::pgsqlCopyToArray stringtableName stringseparator"\t" diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToFile.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToFile.xml index d4719d5374..7a601f2c4f 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToFile.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlCopyToFile.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlCopyToFile @@ -8,9 +8,14 @@ Pdo\Pgsql::copyToFile &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public boolPDO::pgsqlCopyToFile stringtableName stringfilename diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlGetNotify.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlGetNotify.xml index b532a687a4..34075b985c 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlGetNotify.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlGetNotify.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlGetNotify @@ -8,9 +8,14 @@ Pdo\Pgsql::getNotify &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public arrayfalsePDO::pgsqlGetNotify intfetchModePDO::FETCH_DEFAULT inttimeoutMilliseconds0 diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlGetPid.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlGetPid.xml index ebd50fda57..b246f1a44e 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlGetPid.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlGetPid.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlGetPid @@ -8,9 +8,14 @@ Pdo\Pgsql::getPid &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public intPDO::pgsqlGetPid diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBCreate.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBCreate.xml index 7dc63c1cd5..1832134ec9 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBCreate.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBCreate.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlLOBCreate @@ -8,9 +8,14 @@ Pdo\Pgsql::lobCreate &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public stringPDO::pgsqlLOBCreate diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBOpen.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBOpen.xml index fc4759453f..70f8a373fa 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBOpen.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBOpen.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlLOBOpen @@ -8,9 +8,14 @@ Pdo\Pgsql::lobOpen &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public resourcefalsePDO::pgsqlLOBOpen stringoid stringmode"rb" diff --git a/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBUnlink.xml b/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBUnlink.xml index d32de1d713..15689f4266 100644 --- a/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBUnlink.xml +++ b/reference/pdo_pgsql/pdo_overloaded/pgsqlLOBUnlink.xml @@ -1,6 +1,6 @@ - + PDO::pgsqlLOBUnlink @@ -8,9 +8,14 @@ Pdo\Pgsql::lobUnlink &Alias; + + + &warn.deprecated.function-8-5-0; + &reftitle.description; + #[\Deprecated] public boolPDO::pgsqlLOBUnlink stringoid diff --git a/reference/pdo_pgsql/reference.xml b/reference/pdo_pgsql/reference.xml index 3c95c34204..7a2607ccd9 100644 --- a/reference/pdo_pgsql/reference.xml +++ b/reference/pdo_pgsql/reference.xml @@ -1,6 +1,6 @@ - + @@ -20,10 +20,10 @@
&reftitle.resources; - + この拡張モジュールでは、ストリームリソースを定義しています。これは - PDO::pgsqlLOBOpen が返すものです。 - + Pdo\Pgsql::lobOpen が返すものです。 +
&reference.pdo-pgsql.configure; @@ -32,9 +32,12 @@
General notes - - bytea フィールドはストリームとして返されます。 - + + bytea カラムはストリームリソースとして返されます。 + これらの値を読み込む方法や、PDO::PARAM_LOB を使って + データをバインドする方法については、 + ラージオブジェクト (LOB) を参照ください。 +
@@ -106,11 +109,15 @@ sslmode - - SSLモード。サポートされている値とその意味については、 + + SSLモード。指定できる値は disable、allow、 + prefer、require、verify-ca + および verify-full です。それぞれの意味については、 PostgreSQL Documentation を参照ください。 - + 多くのホスティング型 PostgreSQL サービスでは暗号化された接続が必須です。 + そのため、接続するには require 以上の厳格なモードを指定する必要があります。 + diff --git a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml index 5ef00c51df..9dbcfd7dbd 100644 --- a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml +++ b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateAggregate.xml @@ -1,6 +1,6 @@ - + @@ -10,6 +10,10 @@ + + &warn.deprecated.function-8-5-0; + + &reftitle.description; diff --git a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml index d923f71f1a..3b8a145071 100644 --- a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml +++ b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateCollation.xml @@ -1,6 +1,6 @@ - + PDO::sqliteCreateCollation @@ -9,6 +9,10 @@ + + &warn.deprecated.function-8-5-0; + + &reftitle.description; diff --git a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml index 88b0836815..e4cef1700e 100644 --- a/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml +++ b/reference/pdo_sqlite/pdo_overloaded/sqliteCreateFunction.xml @@ -1,6 +1,6 @@ - + @@ -10,6 +10,10 @@ + + &warn.deprecated.function-8-5-0; + + &reftitle.description;