pg_close_stmt

プリペアドステートメントをクローズする

説明

PgSql\Resultfalse pg_close_stmt(PgSql\Connection $connection, string $statement_name)

サーバー上のプリペアドステートメントをクローズし、そのリソースを解放して、 ステートメント名を再利用できるようにします。 これは、DEALLOCATE SQL コマンドを発行する方法に代わる手段です。 そのコマンドでは、後からステートメント名を再利用することはできません。

この関数は、PHP が libpq 17 以降でビルドされている場合にのみ利用可能です。

パラメータ

connection
PgSql\Connection クラスのインスタンス。
statement_name
クローズするプリペアドステートメントの名前。

戻り値

成功した場合に PgSql\Result クラスのインスタンスを返します。 失敗した場合に false を返します。

エラー / 例外

statement_name が空の場合や null バイトを含む場合は、 ValueError がスローされます。

参考

  • pg_prepare
  • pg_execute