phpEnv MySQL 8.0默认字符集修改 phpEnv数据库环境标准化-php教程-PHP中文网

phpenv中mysql 8.0默认字符集非utf8mb4，须手动在my.ini的[mysqld]段添加character-set-server=utf8mb4和collation-server=utf8mb4_0900_ai_ci，同时在[client]与[mysql]段添加default-character-set=utf8mb4，重启服务后验证character_set_client/connection/results/server四变量全为utf8mb4，并在php连接时显式指定charset=utf8mb4，已有库表需按库→表顺序执行alter转换。

phpenv mysql 8.0默认字符集修改 phpenv数据库环境标准化

phpEnv 中 MySQL 8.0 默认字符集不是 utf8mb4，必须手动改配置文件，否则新建库/表仍可能用错编码，中文、emoji 写入直接报 Incorrect string value 错误。

phpEnv 的 my.ini 默认没设 utf8mb4

phpEnv 安装的 MySQL 8.0 虽然官方默认是 utf8mb4，但 phpEnv 自带的 my.ini（通常在 C:\phpEnv\MySQL\my.ini 或类似路径）往往沿用旧模板，[mysqld] 段下缺失关键配置。你执行 SHOW VARIABLES LIKE 'character_set_server'; 很可能看到返回 utf8（即 utf8mb3）或 latin1，这不是 MySQL 8.0 原生行为，而是 phpEnv 封装导致的偏差。

实操建议：

用记事本或 VS Code 打开 C:\phpEnv\MySQL\my.ini（路径以你实际安装为准）
在 [mysqld] 段下添加两行（不要替换已有同名项，直接追加）：
character-set-server = utf8mb4
collation-server = utf8mb4_0900_ai_ci
同时在 [client] 和 [mysql] 段下各加一行：
default-character-set = utf8mb4
保存后，必须重启 phpEnv 的 MySQL 服务（通过 phpEnv 控制面板“重启 MySQL”或命令行执行 net stop mysql && net start mysql）

改完配置后必须验证四类变量

只改配置不验证，等于没改。MySQL 连接层有四个关键变量决定实际行为：character_set_client、character_set_connection、character_set_results、character_set_server。它们必须全部是 utf8mb4，才算生效。

连接 MySQL 后执行：
SHOW VARIABLES LIKE 'character%';

重点关注这四行输出值是否全为 utf8mb4：

character_set_client
character_set_connection
character_set_results
character_set_server

如果其中任一值仍是 utf8 或 latin1，说明配置未加载成功，或被其他配置段覆盖（比如 [mysqld_safe] 里有冲突项）。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

PHP 连接时仍要显式指定 charset

即使服务端全设对了，PHP 的 mysqli 或 PDO 默认不会自动协商 utf8mb4，尤其 phpEnv 环境中 PHP 版本较老时更常见。

两种写法都需加 charset=utf8mb4：

mysqli：连接后立刻执行 mysqli_set_charset($conn, 'utf8mb4');，不能只靠 init_connect
PDO：DSN 中必须包含 ;charset=utf8mb4，例如：
$pdo = new PDO('mysql:host=127.0.0.1;dbname=test;charset=utf8mb4', $user, $pass);

漏掉这步，INSERT 中文可能存成问号，SELECT 返回乱码，且错误日志里看不到明显报错，排查成本很高。

已有数据库和表必须单独转换

修改 my.ini 只影响后续新建的库和表，已存在的库、表、列字符集保持原样。phpEnv 常用于本地开发，很多项目数据库是升级前建的，大概率还是 utf8 或 latin1。

安全转换顺序（务必先备份）：

改库：ALTER DATABASE `your_db` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci;
改表（含索引重建）：ALTER TABLE `your_table` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
若字段类型是 VARCHAR 且长度 > 191，需先缩小长度（因 utf8mb4 索引最大字节数为 767，对应 191 字符），否则 CONVERT 会失败

注意：CONVERT TO 会锁表，大表操作避开高峰期；phpEnv 是本地环境，虽无高并发压力，但表体积超过 10 万行时仍建议在空闲时执行。

最易被忽略的是：phpEnv 的 MySQL 服务名常为 mysql 或 mysql80，重启时若用错服务名（比如执行 net start mysqld），配置根本不会加载。验证前先确认服务状态——这是本地环境出问题的第一排查点。