mysqli::set_charset

mysqli_set_charset

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

mysqli::set_charset -- mysqli_set_charset — 设置客户端字符集

说明

面向对象风格

public mysqli::set_charset(string $charset): bool

过程式风格

mysqli_set_charset(mysqli $mysql, string $charset): bool

设置在从数据库服务器发送数据和接收数据时使用的字符集。

参数

mysql: 仅限过程式风格：由 mysqli_connect() 或 mysqli_init() 返回的 mysqli 对象
charset: 所需的字符集。

返回值

成功时返回 true，失败时返回 false。

错误/异常

如果启用了 mysqli 错误报告（MYSQLI_REPORT_ERROR）并且请求的操作失败，则会生成警告。此外，如果将模式设置为 MYSQLI_REPORT_STRICT，则会抛出 mysqli_sql_exception 而不是警告。

示例

示例 #1 mysqli::set_charset() 示例

面向对象风格

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "test");

printf("Initial character set: %s\n", $mysqli->character_set_name());

/* change character set to utf8mb4 */
$mysqli->set_charset("utf8mb4");

printf("Current character set: %s\n", $mysqli->character_set_name());

过程式风格

<?php

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect('localhost', 'my_user', 'my_password', 'test');

printf("Initial character set: %s\n", mysqli_character_set_name($link));

/* change character set to utf8mb4 */
mysqli_set_charset($link, "utf8mb4");

printf("Current character set: %s\n", mysqli_character_set_name($link));

上面的示例将输出类似于以下内容

Initial character set: latin1
Current character set: utf8mb4

注释

注意:
要在 Windows 平台上使用此函数，您需要 MySQL 客户端库版本 4.1.11 或更高版本（对于 MySQL 5.0，您需要 5.0.6 或更高版本）。

注意:
这是更改字符集的首选方法。使用 mysqli_query() 设置它（例如 SET NAMES utf8）不推荐。有关更多信息，请参阅 MySQL 字符集概念部分。

参见

mysqli_character_set_name() - 返回数据库连接的当前字符集
mysqli_real_escape_string() - 转义字符串中的特殊字符以供在 SQL 语句中使用，同时考虑连接的当前字符集
MySQL 字符集概念
» MySQL 支持的字符集列表

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加备注

用户贡献的注释 5 个注释

向上

向下

Konstantin Rozinov ¶

6 年前

Claude 的评论（https://php.net/manual/en/mysqli.set-charset.php#121067）是正确的。

在建立连接后，像这样设置字符集（实际上是编码）
$connection->set_charset("utf8mb4")

无法为连接设置正确的排序规则

character_set_client: utf8mb4
character_set_connection: utf8mb4
character_set_database: utf8mb4
character_set_filesystem: binary
character_set_results: utf8mb4
character_set_server: utf8mb4
character_set_system: utf8
collation_connection: utf8mb4_general_ci <---- 仍然显示 general
collation_database: utf8mb4_unicode_ci
collation_server: utf8mb4_unicode_ci

如果您使用 SET NAMES，则可以使用
$connection->query("SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci");

character_set_client: utf8mb4
character_set_connection: utf8mb4
character_set_database: utf8mb4
character_set_filesystem: binary
character_set_results: utf8mb4
character_set_server: utf8mb4
character_set_system: utf8
collation_connection: utf8mb4_unicode_ci <-- 现在显示 unicode
collation_database: utf8mb4_unicode_ci
collation_server: utf8mb4_unicode_ci

请注意，我在服务器上设置了以下变量

将以下内容设置为：utf8mb4_unicode_ci

character_set_client
character_set_connection
character_set_database
character_set_results
character_set_server

collation_connection
collation_server

设置

character-set-client-handshake = FALSE 或 0
skip-character-set-client-handshake = TRUE 或 1

向上

向下

Emmanuel Appiah ¶

8 年前

所以在我的情况下，我尝试将 mysql 的排序规则从 utf8mb4_unicode_ci 更改为 uft8_general_ci。

然后粘贴

mysqli_set_charset( $con, 'utf8');

在我执行 SELECT 命令之前。

这是我从数据库读取的代码

/*

$DB_SERVER="db_server_name";
$DB_USER_READER="root";
$DB_PASS_READER="passw*rd";
$DB_NAME="db_name";
$DB_PORT="端口号";

$SELECT_WHAT="`name_of_column_as_in_your_table`";
$WHICH_TBL="`table_name`";
$ON_WHAT_CONDITION="`id`='7'";

*/

$con = mysqli_connect($DB_SERVER, $DB_USER_READER, $DB_PASS_READER, $DB_NAME, $DB_PORT);//这是用于选择的唯一连接
    
mysqli_set_charset( $con, 'utf8');
    
        
$slct_stmnt = "SELECT ".$SELECT_WHAT." FROM ".$WHICH_TBL." WHERE ".$ON_WHAT_CONDITION;

$slct_query = mysqli_query($con, $slct_stmnt);
    
if ($slct_query==true) {
//在此处执行您的操作 . . .
}

它运行得非常完美。祝一切顺利。上面的代码可以从数据库中包含此类数据的表的列中读取中文、俄语或阿拉伯语或任何国际语言。

向上

向下

claude dot pache at gmail dot com ¶

7 年前

虽然文档说使用该函数比使用 SET NAMES 更好，但如果您使用与默认排序规则不同的排序规则，则它还不够

<?php
// 这将重置 collation_connection 为 latin1_swedish_ci
// (latin1 的默认排序规则):
$mysqli->set_charset('latin1');

// 为了获得 collation_connection 的预期值，您必须在 mysqli::set_charset() *之后* 执行以下语句:
$mysqli->query("SET NAMES latin1 COLLATE latin1_german1_ci");

向上

向下

-4

ASchmidt at Anamera dot net ¶

6 年前

将字符集（例如，utf8mb4）和排序规则与模式（数据库）设置对齐

<?php
$mysqli = new mysqli( DB_HOST, DB_USER, DB_PASSWORD, DB_SCHEMA, DB_PORT );
if ( 0 !== $mysqli->connect_errno )
 throw new \Exception( $mysqli->connect_error, $mysqli->connect_errno );

if ( TRUE !== $mysqli->set_charset( 'utf8mb4' ) )
 throw new \Exception( $mysql->error, $mysqli->errno );

if ( TRUE !== $mysqli->query( 'SET collation_connection = @@collation_database;' ) )
 throw new \Exception( $mysql->error, $mysqli->errno );
?>

确认

<?php 
echo 'character_set_name: ', $mysqli->character_set_name(), '<br />', PHP_EOL;
foreach( $mysqli->query( "SHOW VARIABLES LIKE '%_connection';" )->fetch_all() as $setting )
 echo $setting[0], ': ', $setting[1], '<br />', PHP_EOL;
?>

将输出类似以下内容
character_set_name: utf8mb4
character_set_connection: utf8mb4
collation_connection: utf8mb4_unicode_520_ci

向上

向下

-3

chris at ocproducts dot com ¶

6 年前

请注意，根据 PHP 中编译的 MySQL 客户端库的不同，使用 utf8mb4 与此函数一起使用可能会导致此函数返回 false。如果客户端库早于 utf8mb4 的引入，那么 PHP 对库的 'mysql_set_character_set' 的调用将返回错误，因为它无法识别该字符集。

唯一知道是否有错误的方法是检查返回值，因为 PHP 警告不会由此函数发出。
mysqli_error 将返回类似以下内容
"Can't initialize character set utf8mb4 (path: /usr/share/mysql/charsets/)"
（我认为目录与它无关；我认为 utf8mb4 与 utf8 之间的区别是在内部处理的）

一种解决方法是用 utf8 重新调用，然后使用 utf8mb4 执行 'SET NAMES' 查询。

如果您的 MySQL 服务器配置为默认使用 utf8，那么您可能在遇到模糊错误之前不会注意到这些问题。看起来它仍然会将数据以字节形式正确保存到数据库中。但是，如果您将字符串截断以适应字段，则可能会遇到 "Data too long for column" 错误，因为从 MySQL 的角度来看，在长度检查期间，每个 4 字节字符实际上将是多个单独的字符。这导致我调试了几个小时。