PHP 8.3 CLI环境下mb_internal_encoding()函数未定义问题求助

核心原因 #

Apache与CLI环境使用独立的php.ini配置文件，PHP 8.3的CLI环境未启用mbstring扩展；或是CLI版本的PHP编译时未集成mbstring模块。

解决步骤 #

• 确认CLI环境的PHP状态

  1. 执行php -v再次验证CLI使用的PHP版本确实为8.3
  2. 执行php -m查看已加载的扩展列表，检查是否存在mbstring
  3. 执行php --ini定位CLI对应的php.ini配置文件路径（通常和Apache使用的路径不同）

• 启用mbstring扩展

  1. 打开上述找到的CLI版php.ini文件
  2. 查找;extension=mbstring（Linux/macOS）或;extension=php_mbstring.dll（Windows），去掉行首的分号;以启用扩展
  3. 若找不到该行，直接添加extension=mbstring（Windows对应extension=php_mbstring.dll）
  4. 保存配置后，重新执行php -m确认mbstring已加载

• 安装缺失的mbstring扩展包
  如果执行php -m仍看不到mbstring，说明CLI版PHP未安装该扩展：

  • Debian/Ubuntu系统：执行sudo apt install php8.3-mbstring
  • RHEL/CentOS系统：执行sudo dnf install php8.3-mbstring
  • 手动编译PHP的情况：重新编译时添加--enable-mbstring参数

• 验证修复效果
  执行php -r "echo mb_internal_encoding();"，若能正常输出当前编码（如UTF-8），则问题已解决

内容的提问来源于stack exchange，提问作者Juergen Schulze