From 334a70770bbca54381df03e819d2a0d71e10f757 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Sun, 10 May 2026 21:37:05 +0200 Subject: [PATCH] =?UTF-8?q?Pdo\Sqlite::loadExtension=20=E3=81=A8=20Pdo\Sql?= =?UTF-8?q?ite::openBlob=20=E3=81=AE=E6=96=B0=E8=A6=8F=E7=BF=BB=E8=A8=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit php/doc-en の現状はスタブ (`Description.` のみ、`&warn.undocumented.func;` 付き) のため、 SQLite3::loadExtension / SQLite3::openBlob の既訳と php-src の挙動を参考に、 Pdo\Sqlite 向けに最小限の説明を新規翻訳しました。 - reference/pdo_sqlite/pdo/sqlite/loadextension.xml — Pdo\Sqlite::loadExtension - 戻り値は `void`、失敗時は `PDOException` がスローされます (php-src ext/pdo_sqlite/pdo_sqlite.c) - reference/pdo_sqlite/pdo/sqlite/openblob.xml — Pdo\Sqlite::openBlob - SQLite3::openBlob と同等。失敗時は `E_WARNING` が発生し `false` を返します EN-Revision はスタブを追加した php/doc-en@2527c5e3 を参照しています。 --- .../pdo_sqlite/pdo/sqlite/loadextension.xml | 96 +++++++++++ reference/pdo_sqlite/pdo/sqlite/openblob.xml | 152 ++++++++++++++++++ 2 files changed, 248 insertions(+) create mode 100644 reference/pdo_sqlite/pdo/sqlite/loadextension.xml create mode 100644 reference/pdo_sqlite/pdo/sqlite/openblob.xml diff --git a/reference/pdo_sqlite/pdo/sqlite/loadextension.xml b/reference/pdo_sqlite/pdo/sqlite/loadextension.xml new file mode 100644 index 0000000000..f492889a8b --- /dev/null +++ b/reference/pdo_sqlite/pdo/sqlite/loadextension.xml @@ -0,0 +1,96 @@ + + + + + + Pdo\Sqlite::loadExtension + SQLite 拡張ライブラリの読み込みを試みる + + + + &reftitle.description; + + public voidPdo\Sqlite::loadExtension + stringname + + + SQLite 拡張ライブラリの読み込みを試みます。 + + + + + &reftitle.parameters; + + + name + + + 読み込みたい拡張ライブラリのパス。 + + + + + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.errors; + + name が空文字列だった場合、 + ValueError をスローします。 + + + 拡張ライブラリの読み込みに失敗した場合、 + PDOException をスローします。 + + + + + &reftitle.examples; + + <methodname>Pdo\Sqlite::loadExtension</methodname> の例 + +loadExtension('/path/to/libagg.so'); +?> +]]> + + + + + + &reftitle.seealso; + + SQLite3::loadExtension + + + + + diff --git a/reference/pdo_sqlite/pdo/sqlite/openblob.xml b/reference/pdo_sqlite/pdo/sqlite/openblob.xml new file mode 100644 index 0000000000..6236c0ea94 --- /dev/null +++ b/reference/pdo_sqlite/pdo/sqlite/openblob.xml @@ -0,0 +1,152 @@ + + + + + + Pdo\Sqlite::openBlob + BLOB を読み書きするためのストリームリソースを開く + + + + &reftitle.description; + + public resourcefalsePdo\Sqlite::openBlob + stringtable + stringcolumn + introwid + stringnulldbname"main" + intflagsPdo\Sqlite::OPEN_READONLY + + + BLOB を読み書きするためのストリームリソースを開きます。 + これは、以下によって選択されます: + + + SELECT column FROM dbname.table WHERE rowid = rowid + + + + ストリームに書き込むことで BLOB のサイズを変更することはできません。 + BLOB のサイズを希望のサイズに設定するには、代わりに UPDATE 文を実行するか、 + SQLite の zeroblob() 関数を使ってください。 + + + + + + &reftitle.parameters; + + + table + + + テーブル名。 + + + + + column + + + カラム名。 + + + + + rowid + + + 行 ID。 + + + + + dbname + + + データベースのシンボリック名。 + + + + + flags + + + Pdo\Sqlite::OPEN_* + 定数のいずれか。 + Pdo\Sqlite::OPEN_READONLY を指定するとストリームを読み取り専用で開き、 + Pdo\Sqlite::OPEN_READWRITE を指定すると読み取りと書き込みができるように開きます。 + + + + + + + + &reftitle.returnvalues; + + ストリームリソースを返します。 + 失敗時には &false; を返します。 + + + + + &reftitle.errors; + + BLOB を開けない場合、E_WARNING レベルのエラーが発生します。 + + + + + &reftitle.examples; + + <methodname>Pdo\Sqlite::openBlob</methodname> の例 + +exec('CREATE TABLE test (text text)'); +$db->exec("INSERT INTO test VALUES ('Lorem ipsum')"); +$stream = $db->openBlob('test', 'text', 1); +echo stream_get_contents($stream); +fclose($stream); +?> +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + SQLite3::openBlob + + + + +