答案:需启用php的mbstring扩展。编辑php.ini文件,取消extension=mbstring前的分号,保存后重启服务,通过php -m | grep mbstring验证,最后重新运行composer命令即可解决。

出现 “The requested PHP extension mbstring is missing” 提示,说明你的 PHP 环境中没有启用 mbstring 扩展。这个扩展用于处理多字节字符串(如中文),是 Composer 安装许多 PHP 包的必要依赖。以下是几种常见的解决方法。
检查并启用 mbstring 扩展
大多数情况下,mbstring 扩展已经随 PHP 一起安装,但未在配置文件中启用。
1. 找到 php.ini 文件
运行以下命令查看当前使用的 php.ini 路径:
php --ini
输出中会显示类似 Loaded Configuration File: /etc/php/8.1/cli/php.ini 的路径。
2. 编辑 php.ini 文件
用文本编辑器打开该文件:
sudo nano /etc/php/8.1/cli/php.ini
(路径根据你的版本和系统可能不同)
3. 启用 mbstring 扩展
在文件中找到这一行(通常被注释掉):
;extension=mbstring
去掉前面的分号,改为:
extension=mbstring
保存并退出。
确认扩展已加载
修改后,运行以下命令检查 mbstring 是否已启用:
php -m | grep mbstring
如果输出 mbstring,说明扩展已成功加载。
你也可以创建一个 PHP 文件,写入:
立即学习“PHP免费学习笔记(深入)”;
<?php phpinfo(); ?>
在浏览器中访问,搜索 “mbstring” 查看是否启用。
linux 系统下安装 mbstring(如未安装)
如果你的系统根本没有安装该扩展,可通过包管理器安装。
sudo apt-get install php-mbstring
centos/RHEL(使用 yum):
sudo yum install php-mbstring
CentOS/RHEL(使用 dnf,较新版本):
sudo dnf install php-mbstring
安装完成后,重启 Web 服务(如 apache 或 nginx)或 PHP-FPM:
sudo systemctl restart apache2
或
sudo systemctl restart php-fpm
windows 下启用 mbstring
Windows 用户通常使用 XAMPP、WAMP 或手动配置 PHP。
– 打开 php.ini(通常位于 XAMPPphpphp.ini) – 搜索 mbstring – 确保 extension=mbstring 前面没有分号 – 保存文件并重启 Apache
验证 Composer 是否正常运行
完成上述操作后,重新运行 Composer 命令:
composer install
或
composer update
报错应已消失。
基本上就这些。只要确保 mbstring 扩展被正确安装并启用,Composer 就不会再提示该错误。


