2024 日本 PHP 研討會

pg_escape_identifier

(PHP 5 >= 5.4.4, PHP 7, PHP 8)

pg_escape_identifier 跳脫要插入文字欄位的識別符號

說明

pg_escape_identifier(PgSql\Connection $connection = ?, 字串 $data): 字串

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};");
?>

另請參閱

新增註釋

使用者提供的註釋

此頁面沒有使用者提供的註記。
To Top