(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_affected_rows — 傳回受影響的記錄 (tuples) 數量
pg_affected_rows() 會傳回受 INSERT、UPDATE 和 DELETE 查詢影響的 tuple（實例／記錄／列）數量。
從 PostgreSQL 9.0 及以上版本開始，伺服器會傳回 SELECT 的列數。較舊的 PostgreSQL 版本對於 SELECT 會傳回 0。
注意事項:
這個函式以前稱為 pg_cmdtuples()。
受查詢影響的列數。如果沒有 tuple 受影響，則會傳回 0。
| 版本 | 說明 |
|---|---|
| 8.1.0 | result 參數現在需要一個 PgSql\Result 實例；以前需要的是 資源。 |
範例 #1 pg_affected_rows() 範例
<?php
$result = pg_query($conn, "INSERT INTO authors VALUES ('Orwell', 2002, 'Animal Farm')");
$cmdtuples = pg_affected_rows($result);
echo $cmdtuples . " 個 tuple 受影響。\n";
?>上述範例將輸出
1 tuples are affected.
pg-affected-rows () 只會對執行的最後一個 SQL 陳述式生效。如果您將多個陳述式組合在一起，則 pg_affected_rows 可能不會傳回您預期的結果。
例如
<?php
$result = pg_query ('BEGIN; INSERT INTO foo (bar) VALUES (\'baz\'); COMMIT');
echo (pg_affected_rows ($result));
?>
將會導致印出 0，因為 Postgres 執行的最後一個陳述式是 COMMIT，它不會影響任何列。
我還沒試過，所以不確定是否有效，但如果您將查詢拆分，應該可以取得所需的列數。
例如
<?php
$result = pg_query ('BEGIN; INSERT INTO foo (bar) VALUES (\'baz\');');
echo (pg_affected_rows ($result));
pg_query ('COMMIT;');
?>
應該允許您取得受前一個查詢影響的列數。但我還沒試過，所以別太指望它。請注意，當您在一個 BEGIN;COMMIT; 中提交多個 SQL 查詢時，像這樣：
$SQLQuery = 'BEGIN;';
$SQLQuery.= 'INSERT INTO a (a,b) VALUES (1,2);';
$SQLQuery.= 'INSERT INTO b (ref_b,c) VALUES (2,5);';
$SQLQuery.= 'COMMIT;';
$HandleResults = pg_query($SQLQuery);
echo(pg_affected_rows($HandleResults));
pg_affected_rows() 將會返回 0