# mysql_client_encoding

(PHP 4 >= 4.3.0, PHP 5)

mysql_client_encoding — 返回字符集的名称

### 说明

mysql_client_encoding ([ resource `$link_identifier` ] ) : string

从 MySQL 中取得 character_set 变量的值。

### 参数

`link_identifier`

  MySQL 连接。如不指定连接标识，则使用由 mysql_connect() 最近打开的连接。如果没有找到该连接，会尝试不带参数调用 mysql_connect() 来创建。如没有找到连接或无法建立连接，则会生成 `E_WARNING` 级别的错误。

### 返回值

返回当前连接的默认字符集名称。

### 范例

Example #1 mysql_client_encoding() 例子

    <?php
    $link    = mysql_connect('localhost', 'mysql_user', 'mysql_password');
    $charset = mysql_client_encoding($link);

    echo "The current character set is: $charset\n";
    ?>

以上例程的输出类似于：

    The current character set is: latin1

### 注释

> Note:

> 本扩展自 PHP 5.5.0 起已废弃，并在自 PHP 7.0.0 开始被移除。应使用 MySQLi 或 PDO_MySQL 扩展来替换之。参见 MySQL：选择 API 指南以及相关 FAQ 来获取更多信息。用以替代本函数的有：

> - mysqli_character_set_name()
> - PDO::setAttribute() (e.g., $db->setAttribute(PDO::MYSQL_ATTR_INIT_COMMAND, "SET NAMES 'utf8'");)

### 参见

- mysql_real_escape_string() - 转义 SQL 语句中使用的字符串中的特殊字符，并考虑到连接的当前字符集