PhpStorm 编码需统一项目默认、文件保存、PHP运行时三者为UTF-8;用file -i或bin2hex验证真实编码;在File Encodings中设Project Encoding为UTF-8;批量转换选Convert to UTF-8并勾选Update source encoding;注意header、数据库、CLI及.git中旧编码文件残留问题。

PhpStorm 默认使用 UTF-8 编码读写 PHP 文件,但若项目中混用 GBK、ISO-8859-1 等编码,或文件保存后出现乱码、mb_strlen 计算异常、json_encode 返回 null,说明编码设置不一致 —— 这时不能只改编辑器显示编码,必须同步确保「项目默认编码」、「文件实际保存编码」、「PHP 解释器运行时编码」三者对齐。
怎样确认当前文件的真实编码
别信右下角状态栏显示的编码名。它只反映 PhpStorm 当前“认为”的编码,不等于文件磁盘内容真实编码。
- 用命令行检查:
file -i your_script.php
- 在 PhpStorm 中:右键文件 → Reload project from Disk → 弹窗会提示“Detected encoding: GBK”,点击
Reload with Encoding可临时验证 - 真实编码错位时,
var_dump(bin2hex(file_get_contents('a.php')))查看原始字节,比对 UTF-8 的c3 a9(é)或 GBK 的b4 fa
全局与项目级编码设置位置
PhpStorm 的编码控制分两层:全局默认值(影响新建项目),项目级覆盖(影响当前 .idea 目录)。优先改项目级,避免污染其他工程。
- 打开
File → Settings → Editor → File Encodings(macOS 是PhpStorm → Preferences) -
Global Encoding:设为UTF-8(不建议改,影响 IDE 自身界面和配置文件) -
Project Encoding:设为UTF-8(强制整个项目以 UTF-8 解析/保存) -
Default encoding for properties files:保持ISO-8859-1(.properties 文件规范要求) - 勾选
Transparent native-to-ascii conversion:让 \uXXXX 转义正常工作
如何批量转换已有文件编码
已有大量 GBK 文件?不能手动一个个 Reload + Save As。需用 IDE 内置批量转码功能,否则会破坏 BOM 或截断多字节字符。
《PHP设计模式》首先介绍了设计模式,讲述了设计模式的使用及重要性,并且详细说明了应用设计模式的场合。接下来,本书通过代码示例介绍了许多设计模式。最后,本书通过全面深入的案例分析说明了如何使用设计模式来计划新的应用程序,如何采用PHP语言编写这些模式,以及如何使用书中介绍的设计模式修正和重构已有的代码块。作者采用专业的、便于使用的格式来介绍相关的概念,自学成才的编程人员与经过更多正规培训的编程人员
立即学习“PHP免费学习笔记(深入)”;
- 在 Project 视图中,按住
Ctrl(macOSCmd)多选 PHP 文件,或用Shift选中整个src/目录 - 右键 →
File Encoding → Convert to UTF-8(不是Reload with Encoding) - 弹窗中务必勾选
Update source encoding to UTF-8,否则下次打开仍按旧编码读取 - 转换后检查:是否有
符号残留?有则说明原始编码识别错误,需先用iconv -f GBK -t UTF-8 old.php > new.php预处理
PHP 运行时与编码相关的陷阱
即使 PhpStorm 全部设成 UTF-8,PHP 脚本仍可能因环境差异输出乱码 —— 编码设置只是第一步。
-
header('Content-Type: text/html; charset=UTF-8')必须存在,且放在echo之前 - 数据库连接需显式指定编码:
mysqli_set_charset($conn, 'utf8mb4')或 DSN 中加;charset=utf8mb4 - CLI 模式下,
php -v输出含cli字样时,终端本身编码(如 Windows CMD 默认 GBK)会干扰var_dump显示,此时需用chcp 65001切换 -
json_encode()对非 UTF-8 字符串返回null,可用mb_convert_encoding($str, 'UTF-8', 'GBK')预处理
最易被忽略的是:.git 仓库中已提交的 GBK 文件,Pull 后 PhpStorm 会沿用历史编码读取,导致新设置不生效。遇到这种情况,先删掉 .idea/encodings.xml,再执行一次批量 Convert,最后提交新的 UTF-8 文件覆盖旧版本。










