答案:缺少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
Linux(CentOS/RHEL):
- 安装:运行 sudo yum install php-mbstring 或 dnf install php-mbstring(新版)
- 重启 Web 服务
macOS(使用 Homebrew):
- 如果你通过 brew 安装 PHP,运行:brew install php@版本号(通常自带 mbstring)
- 或尝试:brew reinstall php
Windows(WAMP/XAMPP):
- 打开 php.ini 文件(可通过 php --ini 查找)
- 找到 ;extension=mbstring 这一行,去掉前面的分号
- 保存并重启 Apache 或 Nginx
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中文网其它相关文章!