pg_query
クエリを実行する
&reftitle.description;
PgSql\Resultfalsepg_query
PgSql\Connectionconnection
stringquery
pg_query は、指定したデータベース
connection 上で query
を実行します。
特別な理由がない限り、この関数よりも pg_query_params を使うほうがいいでしょう。
エラーが発生して &false; が返された場合、もし接続が正常なら
pg_last_error 関数を使用してエラーの詳細情報が
取得可能です。
connectionは省略可能ですが、それは推奨されません。
なぜならスクリプトのバグが発見しにくくなるためです。
この関数は、以前は pg_exec と呼ばれていました。
pg_exec は互換性確保のためにまだ使用可能ですが、
新しい名前を使用することが推奨されています。
&reftitle.parameters;
connection
&pgsql.parameter.connection-with-unspecified-default;
query
実行する 1 つまたは複数の SQL 文。複数の文が関数に渡された場合は、
明示的に BEGIN/COMMIT コマンドを指定していない限りはそれらの文は
ひとつのトランザクションとして実行されます。しかし、1 回のコールで
複数のトランザクションを実行することは推奨されません。
ユーザーから受け取ったデータを文字列に直接組み込むのは危険で、SQL
インジェクション の脆弱性を引き起こしがちです。クエリ文字列に直接埋め込むのではなく、
pg_query_params を使ってパラメータとして指定することを推奨します。
ユーザーから受け取ったデータをクエリ文字列に直接埋め込む場合は、
適切にエスケープ
する必要があります。
&reftitle.returnvalues;
成功した場合に
PgSql\Result クラスのインスタンスを返します。
&return.falseforfailure;
&reftitle.changelog;
&Version;
&Description;
&pgsql.changelog.return-result-object;
&pgsql.changelog.connection-object;
&reftitle.examples;
pg_query の例
\n";
}
?>
]]>
pg_query で複数の文を使用する例
]]>
&reftitle.seealso;
pg_connect
pg_pconnect
pg_fetch_array
pg_fetch_object
pg_num_rows
pg_affected_rows