トップページ　→関数リファレンス　→データベース関連　→ベンダー固有のモジュール　→PostgreSQL　→PostgreSQL 関数

関数・クラス解説

pg_execute

version:PHP 5 >= 5.1.0, PHP 7 (公式)

指定したパラメータを用いてプリペアドステートメントを実行するリクエストを送信し、その結果を待つ

公式リファレンス

書式

pg_execute ([ resource $connection ], string $stmtname , array $params ) : resource|false

説明

指定したパラメータを用いてプリペアドステートメントを実行するリクエストを送信し、その結果を待ちます。

pg_execute() は pg_query_params() と似ています。しかし、実行するコマンドはクエリを指定することで決まるのではなく、事前に準備されたステートメントに値を指定することによって決まります。この機能のおかげで、繰り返し使用されるコマンドに構文解析や実行計画作成が最初の一度だけで済みます。実行するステートメントは、カレントのセッションで事前に準備しておく必要があります。pg_execute() は、PostgreSQL 7.4 以降のバージョンの接続にのみ対応しています。それ以前のバージョンでは失敗します。

パラメータは pg_query_params() と同じですが、クエリ文字列のかわりにプリペアドステートメントの名前を指定するという点だけが違います。

パラメータ

connection: PostgreSQL データベース接続リソース。connection が指定されていない場合はデフォルトの接続が使用されます。デフォルトの接続は、直近の pg_connect() あるいは pg_pconnect() によって作成されたものです。
stmtname: 実行するプリペアドステートメントの名前。"" が指定された場合は無名ステートメントが実行されます。名前は、事前に pg_prepare()・pg_send_prepare() あるいは PREPARE SQL コマンドで準備されたものである必要があります。
params: プリペアドステートメント中の $1、$2 などのプレースホルダを置き換えるパラメータの配列。配列の要素数はプレースホルダの数と一致する必要があります。
警告この関数をコールする際に、要素の内容は文字列に変換されます。

返値

成功した場合にクエリ結果リソース、失敗した場合に FALSE を返します。

注意

警告この関数をコールする際に、要素の内容は文字列に変換されます。

サンプル

例1 pg_execute() の使用法 

// "mary"という名前のデータベースに接続
$dbconn = pg_connect("dbname=mary");

// 実行するクエリを準備
$result = pg_prepare($dbconn, "my_query", 'SELECT * FROM shops WHERE name = $1');

// プリペアドクエリの実行。文字列 "Joe's Widgets" のエスケープ処理は
// 一切必要ないことに注意
$result = pg_execute($dbconn, "my_query", array("Joe's Widgets"));

// 同じプリペアドクエリを違うパラメータで実行
$result = pg_execute($dbconn, "my_query", array("Clothes Clothes Clothes"));

参考

pg_prepare() - 指定したパラメータでプリペアドステートメントを作成するリクエストを送信し、その完了を待つ

pg_send_prepare() - 指定したパラメータでプリペアドステートメントを作成するリクエストを送信し、その結果を待たない

pg_query_params() - SQL コマンドとパラメータを分割してサーバーへ送信し、その結果を待つ

ワード検索

※入力キーワードが、関数名・説明文・タグに含まれるものを検索

関数名アルファベット別

A	B	C	D	E	F	G	H	I	J
K	L	M	N	O	P	Q	R	S	T
U	V	W	X	Y	Z	_

最終更新一覧

●stristr
　大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却

●stripslashes
　バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

●stripos
　大文字小文字を区別せずに文字列が最初に現れる位置を取得する

●stripcslashes
　addcslashes() でクォートされた文字列をアンクォートする

●strip_tags
　文字列から HTML と PHP のタグを除去して返却

●strcspn
　指定した文字が最初に現れる位置を調べる

●strcoll
　ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する

●strcmp
　2つの文字列を比較し同じか（あるいは大小）を判定する

●strchr
　strstr() のエイリアス

●strcasecmp
　2つの文字列を比較（大文字小文字を区別せず同じとみなす）

カテゴリー一覧

PHP の振る舞いの変更
 音声フォーマットの操作
 認証サービス
 コマンドライン関連
 圧縮およびアーカイブ
 暗号
 データベース関連
 日付および時刻関連
 ファイルシステム
 自然言語および文字エンコーディング
 画像処理および作成
 メール関連
 数学
 テキスト以外の MIME 型
 プロセス制御
 その他の基本モジュール
 その他のサービス
 検索エンジン用の拡張モジュール
 サーバー固有のモジュール
 セッション関連
 テキスト処理
 変数・データ型関連
 ウェブサービス
 Windows 用のモジュール
 XML 操作
 GUI用の拡張モジュール