PHP 8.3 调用 mb_strlen 报未定义函数 mbstring 扩展怎么装

现象

新服务器部署 Laravel 项目,访问首页直接 500,日志里是 Call to undefined function mb_strlen(),执行 composer install 也提示 requires ext-mbstring。php -m 的输出里确实找不到 mbstring,但 apt 显示相关包已经装过。

原因

mbstring 是独立扩展,PHP 主包不带。提示装过包,常见是装到了另一个 PHP 版本上,比如系统同时存在 8.1 和 8.3,命令行走的是 8.1,FPM 跑的却是 8.3;也可能是扩展文件存在但 mods-available 里没有启用,或者编译时加了 --disable-mbstring。

解决步骤

第一步,确认版本和扩展目录。先看 CLI 与 FPM 的版本号、extension_dir 是否一致,再判断要装哪一个版本的包。

php -v
php --ini
php -i | grep extension_dir
dpkg -l | grep php8.3

第二步,装对应版本并启用。安装 php8.3-mbstring 后用 phpenmod 启用,确保 cli 和 fpm 两个 SAPI 都链接到同一个 ini 目录,再重启 FPM。

sudo apt install -y php8.3-mbstring
sudo phpenmod -v 8.3 mbstring
sudo systemctl restart php8.3-fpm
php -m | grep -i mbstring

第三步,处理多版本冲突。如果命令行仍然看不到,检查 /etc/php/8.3/cli/conf.d 下是否有 20-mbstring.ini,并确认 update-alternatives 指向的 php 就是 8.3。容器环境则要在 Dockerfile 里装扩展,而不是在运行中的容器里手工装。

验证

php -m 两个 SAPI 都能列出 mbstring,调用 mb_strlen('中文') 返回 2,composer install 不再报缺少扩展,页面 500 消失。

小结

扩展缺失多数是版本装错或没启用。先对齐 CLI 与 FPM 的版本,再装包、启用、重启,三步缺一不可。

您可以还会对下面的文章感兴趣: