PHP Conference Japan 2024

pg_set_client_encoding

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

pg_set_client_encoding 設定用戶端編碼

說明

pg_set_client_encoding(PgSql\Connection $connection = ?, string $encoding): int

pg_set_client_encoding() 設定用戶端編碼,成功則返回 0,錯誤則返回 -1。

PostgreSQL 會自動將後端資料庫編碼的資料轉換為前端編碼。

注意事項:

此函式過去的名稱為 pg_setclientencoding()

參數

connection

一個 PgSql\Connection 實例。當 connection 未指定時,將使用預設連線。預設連線是透過 pg_connect()pg_pconnect() 建立的最後一個連線。

警告

自 PHP 8.1.0 起,不建議使用預設連線。

encoding

所需的用戶端編碼。可選值包括 SQL_ASCIIEUC_JPEUC_CNEUC_KREUC_TWUNICODEMULE_INTERNALLATINX (X=1...9)、KOI8WINALTSJISBIG5WIN1250

可用的編碼確切列表取決於您的 PostgreSQL 版本,因此請查看 PostgreSQL 手冊以獲取更具體的列表。

返回值

成功時返回 0,錯誤時返回 -1

更新日誌

版本 說明
8.1.0 connection 參數現在需要一個 PgSql\Connection 實例;以前需要的是 資源

範例

範例 #1 pg_set_client_encoding() 範例

<?php

$conn
= pg_pconnect("dbname=publisher");
if (!
$conn) {
echo
"發生錯誤。\n";
exit;
}

// 將用戶端編碼設定為 UNICODE。資料將自動
// 從後端編碼轉換為前端編碼。
pg_set_client_encoding($conn, "UNICODE");

$result = pg_query($conn, "SELECT author, email FROM authors");
if (!
$result) {
echo
"發生錯誤。\n";
exit;
}

// 輸出 UTF-8 資料
while ($row = pg_fetch_row($result)) {
echo
"作者: $row[0] 電子郵件: $row[1]";
echo
"<br />\n";
}

?>

參見

新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top