phpEnv提示The PHP extension 'bcmath' is required 解决Laravel环境

宝塔面板内快速启用 bcmath（推荐优先尝试）

适用于大多数宝塔用户，无需命令行，但要注意版本匹配：

• 登录宝塔 → 【软件商店】→ 找到你站点正在用的 PHP 版本（如 PHP 8.2），点【设置】
• 切换到【安装扩展】选项卡，找到 bcmath，点【安装】（不是【启用】）
• 安装完成后，务必点右上角【重载配置】——这步漏掉，扩展不会加载进 FPM
• 再执行 php -m | grep bcmath，如果 CLI 还没出来，说明 CLI 用的是另一套配置，需手动补一行 extension=bcmath.so 到 CLI 对应的 php.ini

注意：php -v 显示的版本号（如 8.2.15）和宝塔里显示的“PHP 8.2”要一致；若显示 8.3 却去点了 8.2 的扩展，肯定无效。

CentOS/AlmaLinux 下用 yum 安装 bcmath 的坑

直接 yum install php-bcmath 在多数现代系统上会失败，因为默认仓库不提供多版本共存支持：

• 先查当前 PHP 版本：php -v，假设输出是 PHP 8.1.27
• 查启用的 SCL 或 Remi 源：yum repolist enabled | grep -E "(remi|epel)"，没结果就先运行 yum install epel-release && yum install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
• 启用对应 PHP 版本的模块：dnf module enable php:remi-8.1（RHEL8+/AlmaLinux 8+）或 yum-config-manager --enable remi-php81（CentOS 7）
• 再装：yum install php-bcmath（此时 remi 源会自动解析为 php81-bcmath）
• 重启服务：systemctl restart php-fpm，并确认 php -m | grep bcmath 有输出

最容易被忽略的一点：Laravel 的 artisan 命令走的是 CLI，而网页请求走的是 FPM，二者可能由不同用户（如 root vs www）运行，权限或 open_basedir 限制也可能导致 .so 文件加载失败——所以看到 extension=bcmath.so 写对了，仍报错时，先 ls -l 看 bcmath.so 文件是否存在且可读。

好了，本文到此结束，带大家了解了《phpEnv提示The PHP extension 'bcmath' is required 解决Laravel环境》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！