答案:缺少mbstring扩展导致php报错,需安装并启用该扩展。首先通过php -m和php –ini确认问题,然后根据操作系统安装扩展:linux使用apt或yum,macos用brew,windows则修改php.ini文件。最后重启服务并验证扩展是否加载成功,确保CLI与Web环境PHP版本一致。

出现 “The requested PHP extension mbstring is missing” 错误,说明你的 PHP 环境缺少 mbstring 扩展。这个扩展用于处理多字节字符编码(如 UTF-8),很多 PHP 框架和 composer 包都依赖它。
1. 确认问题来源
先检查当前使用的 PHP 版本和配置文件位置:
- 运行 php -m 查看已加载的扩展,确认列表中是否有 mbstring
- 运行 php –ini 查看当前加载的 php.ini 文件路径
2. 启用 mbstring 扩展
根据你的操作系统和 PHP 安装方式操作: Linux(以 ubuntu/debian 为例):
- 安装扩展:运行 sudo apt-get install php-mbstring
- 如果使用 apache,重启服务:sudo systemctl restart apache2
- 如果使用 PHP-FPM,重启对应服务,如:sudo systemctl restart php-fpm
- 安装:运行 sudo yum install php-mbstring 或 dnf install php-mbstring(新版)
- 重启 Web 服务
macOS(使用 Homebrew):
- 如果你通过 brew 安装 PHP,运行:brew install php@版本号(通常自带 mbstring)
- 或尝试:brew reinstall php
Windows(WAMP/XAMPP):
3. 验证是否解决
执行以下命令确认扩展已加载:
- php -m | grep mbstring —— 应该输出 mbstring
- php -r “echo function_exists(‘mb_strlen’) ? ‘OK’ : ‘MISSING’;” —— 应输出 OK
4. 多 PHP 版本注意点
如果你系统中有多个 PHP 版本(如 PHP 7.4 和 PHP 8.1),确保你在命令行和 Web 服务中使用的是同一个版本,并且扩展在两者中都启用。
- 例如使用 PHP 8.1:运行 sudo apt install php8.1-mbstring
- 检查 CLI 使用的版本:php -v
基本上就这些。只要正确安装并启用 mbstring 扩展,Composer 的报错就会消失。
以上就是composer提示“The requested PHP extension mbstring is missing”如何处理?的详细内容,更多请关注php中文网其它相关文章!


