# mysql_set_charset

(PHP 5 >= 5.2.3)

mysql_set_charset — 设置客户端的字符集

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

> - mysqli_character_set_name()
> - PDO: 添加 charset 到连接字符串，比如 charset=utf8

### 说明

mysql_set_charset ( string `$charset` [, resource `$link_identifier` = NULL ] ) : bool

设置当前连接的默认字符集。

### 参数

`charset`

  一个有效的字符集名称。

`link_identifier`

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

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 注释

> Note:

> 本函数需要 MySQL 5.0.7 或更高版本。

> Note:

> 这是改变字符集的最佳方式。不推荐您使用 mysql_query() 来设置 (比如 SET NAMES utf8)。 更多信息参见 MySQL character set concepts 一节。

### 参见

- mysql_client_encoding() - 返回字符集的名称
- Setting character sets in MySQL
- » List of character sets that MySQL supports