(PHP 5 >= 5.4.4, PHP 7, PHP 8)
pg_escape_identifier — 跳脫要插入文字欄位的識別符號
pg_escape_identifier() 會將識別字(例如表格、欄位名稱)轉義以用於查詢資料庫。它會傳回 PostgreSQL 伺服器使用的已轉義識別字字串。pg_escape_identifier() 會在資料前後加上雙引號。使用者不應自行加上雙引號。建議在查詢的識別字參數中使用此函式。對於 SQL 字面值(即 bytea 以外的參數),必須使用 pg_escape_literal() 或 pg_escape_string()。對於 bytea 類型欄位,必須使用 pg_escape_bytea()。
注意事項:
此函式具有內部轉義程式碼,也可以與 PostgreSQL 8.4 或更早版本一起使用。
connection
一個 PgSql\Connection 實例。當未指定 connection
時,將使用預設連線。預設連線是 pg_connect() 或 pg_pconnect() 建立的最後一個連線。
自 PHP 8.1.0 起,不建議使用預設連線。
data
包含要轉義的文字的 字串。
包含已轉義資料的 字串。
版本 | 說明 |
---|---|
8.1.0 | connection 參數現在需要一個 PgSql\Connection 實例;先前需要的是 資源。 |
範例 #1 pg_escape_identifier() 範例
<?php
// 連線到資料庫
$dbconn = pg_connect('dbname=foo');
// 轉義表格名稱資料
$escaped = pg_escape_identifier($table_name);
// 從 $table_name 選取資料列
pg_query("SELECT * FROM {$escaped};");
?>