PHP Conference Japan 2024

pg_client_encoding

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

pg_client_encoding 获取客户端编码

描述

pg_client_encoding(?PgSql\Connection $connection = null): string

PostgreSQL 支持在服务器和客户端之间对某些字符集进行自动字符集转换。pg_client_encoding() 返回客户端编码作为字符串。返回的字符串将是标准 PostgreSQL 编码标识符之一。

注意:

此函数需要 PostgreSQL 7.0 或更高版本。如果 libpq 在没有多字节编码支持的情况下编译,pg_client_encoding() 始终返回 SQL_ASCII。支持的编码取决于 PostgreSQL 版本。请参阅 PostgreSQL 文档中支持的编码。

该函数以前称为 pg_clientencoding()

参数

connection

一个 PgSql\Connection 实例。当 connectionnull 时,将使用默认连接。默认连接是 pg_connect()pg_pconnect() 最后建立的连接。

警告

从 PHP 8.1.0 开始,使用默认连接已弃用。

返回值

客户端编码。

变更日志

版本 描述
8.1.0 现在,connection 参数期望一个 PgSql\Connection 实例;以前,期望一个 资源
8.0.0 connection 现在可以为空。

示例

示例 #1 pg_client_encoding() 示例

<?php
// 假设 $conn 是与 ISO-8859-1 数据库的连接
$encoding = pg_client_encoding($conn);

echo
"客户端编码为: ", $encoding, "\n";
?>

以上示例将输出

Client encoding is: ISO-8859-1

参见

添加注释

用户贡献的笔记

此页面没有用户贡献的笔记。
To Top