> Return Values
>
> Returns TRUE on success or FALSE on failure. Returns string if
> PGSQL_DML_STRING is passed via options.
I have found in my copy of PHP (version 4.4.0) that if you use the 'PGSQL_DML_STRING' option, the function does not execute any query. It merely returns the query which would have been executed.
Another thing I noticed, pg_update does not seem to make use of pg_trace (atleast in 4.4.0).
PS this isn't a bug report, just an explanation of some undocumented features I noticed. As the manual says, the function is still in development so this behaviour may differ from version to version.
pg_update
(PHP 4 >= 4.3.0, PHP 5)
pg_update — テーブルを更新する
説明
mixed pg_update ( resource connection, string table_name, array data, array condition [, int options] )pg_update() は、data に関して condition にマッチするレコードを更新します。 options が指定された場合、指定したオプションとともに pg_convert() が data に適用されます。
| 警告 |
| この関数は、 実験的 なものです。この関数の動作・ 名前・その他ドキュメントに書かれている事項は、予告なく、将来的な PHP のリリースにおいて変更される可能性があります。 この関数は自己責任で使用してください。 |
パラメータ
- connection
PostgreSQL データベースの接続リソース。
- table_name
行を更新するテーブルの名前。
- data
テーブル table_name のフィールド名をキーに、 そしてマッチした対象を更新するデータを値にもつ配列。
- condition
テーブル table_name のフィールド名をキーに、 そして取得対象となる行にマッチするデータを値にもつ配列。
- options
PGSQL_CONV_OPTS、 PGSQL_DML_NO_CONV、 PGSQL_DML_EXEC あるいは PGSQL_DML_STRING の組み合わせ。 options の一部に PGSQL_DML_STRING が含まれていた場合、 クエリ文字列が返されます。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。 options に PGSQL_DML_STRING が渡された場合は文字列を返します。
例
例 1844. pg_update() の例
<?php
$db = pg_connect('dbname=foo');
$data = array('field1'=>'AA', 'field2'=>'BB');
// これは安全です。なぜなら $_POST は自動的に変換されるからです。
$res = pg_update($db, 'post_log', $_POST, $data);
if ($res) {
echo "データが更新されました: $res\n";
} else {
echo "ユーザが誤った入力を送信しました。\n";
}
?>
参考
| pg_convert() |
pg_update
jhooks
13-Apr-2006 11:54
13-Apr-2006 11:54
sdibb at myway dot com
14-Jun-2005 11:26
14-Jun-2005 11:26
This function is similar to PEAR::DB's autoExecute() function, with the only difference being that the where clause is an array instead of a string.
Also, if you want to use your instance of the DB class with this function, you can reference the existing resource connection with $db->connection.
An example would be:
<?
pg_update($db->connection, $arr_update, $arr_where);
?>