必须手动修改phpEnv的my.ini/my.cnf文件，在[client]、[mysql]、[mysqld]三段同时配置utf8mb4，重启MySQL服务，再按库→表→字段顺序执行ALTER语句转换旧数据，并在PHP连接时显式声明charset=utf8mb4。

phpEnv 里改 MySQL 默认字符集为 utf8mb4，核心不是点几下界面，而是得手动改配置文件 + 重启服务 + 手动转旧表——只点“设置”或“重载配置”基本没用。

phpEnv 的 my.cnf 在哪？怎么改才生效

phpEnv 默认不暴露 MySQL 配置文件路径，但实际位置通常是：C:\phpEnv\phpenv\mysql\my.ini（Windows）或 /usr/local/phpenv/mysql/my.cnf（Linux/macOS，取决于安装方式）。别信面板里“配置修改”的编辑框——它常只改了部分段落，漏掉关键项。

必须手动打开该文件，在以下三处**同时添加或修正**：

• [client] 段下加：default-character-set = utf8mb4
• [mysql] 段下加：default-character-set = utf8mb4
• [mysqld] 段下加：

  character-set-server = utf8mb4
  collation-server = utf8mb4_unicode_ci
  init_connect = 'SET NAMES utf8mb4'
  skip-character-set-client-handshake = FALSE

⚠️ 注意：skip-character-set-client-handshake = TRUE 是危险操作，会强制忽略客户端声明，导致某些 ORM（如 Laravel 的 PDO）连接失败；设为 FALSE（或直接删掉这行）更稳妥。

立即学习“PHP免费学习笔记（深入）”；

改完配置后必须重启 MySQL，且验证不能只看 phpEnv 面板

phpEnv 面板上的“重启 MySQL”按钮有时只发 soft-restart，不一定真正 reload 配置。保险做法是：

• Windows：进任务管理器，结束所有 mysqld.exe 进程，再点面板重启
• Linux/macOS：终端执行 sudo pkill mysqld && /path/to/phpenv/mysql/bin/mysqld --defaults-file=/path/to/my.cnf &

登录 MySQL 后，**不要只跑 SHOW VARIABLES LIKE 'character_set%'**，必须检查这四个值是否全为 utf8mb4：

btpanel phpsite 宝塔面板PHP网站

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

下载

• character_set_client
• character_set_connection
• character_set_database
• character_set_server

如果 character_set_client 还是 latin1 或 utf8，说明 init_connect 没生效——常见原因是当前登录用户有 SUPER 权限（比如 root），它会跳过 init_connect。此时需在连接后手动执行：SET NAMES utf8mb4。

已有数据库和表不自动升级，ALTER 顺序错一步就存不了 emoji

phpEnv 重启后新建的库/表会继承配置，但所有已存在的库、表、字段仍保持原字符集。插入 emoji 报错 Incorrect string value: '\xF0\x9F\x98\x80' 就是这个原因。

转换必须按严格顺序执行（缺一不可）：

• 先改库：ALTER DATABASE `dbname` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
• 再改每张表：ALTER TABLE `tablename` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
• 最后单独确认字段级定义：SHOW CREATE TABLE `tablename` —— 如果某 VARCHAR 字段声明里还带 CHARACTER SET utf8，就得单独改：ALTER TABLE `tablename` MODIFY `column_name` VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

⚠️ 大表执行 CONVERT TO 会锁表重建，phpEnv 通常跑在开发机上，务必提前停应用、备份，别在“测试环境”里赌运气。

PHP 连接层不显式声明 utf8mb4，前面全白干

即使 MySQL 服务端和表都设对了，PHP 默认用 mysql_connect() 或未配 charset 的 PDO 连接，character_set_client 仍可能是 latin1。典型表现：写入正常，查出来中文是问号，emoji 直接被截断。

三种可靠写法：

• PDO 构造时传参：new PDO($dsn, $user, $pass, [PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"])
• mysqli 连接后立即调：$mysqli->set_charset("utf8mb4")
• 连接字符串加参数（推荐）：mysql:host=localhost;charset=utf8mb4（PDO）或 ?charset=utf8mb4（mysqli_real_connect）

别依赖 init_connect 自动执行——它对 root 用户无效，而 phpEnv 默认 root 连接，这就成了最常被忽略的断点。