phpEnv提示The PHP extension ‘bcmath’ is required 解决Laravel环境-php教程-PHP中文网

laravel 启动报“bcmath 扩展缺失”是因框架在 loadconfiguration.php 中硬性检测 bcadd() 等函数，用于金额计算、加密盐生成等关键操作；常见原因包括宝塔未启用该扩展、cli 与 fpm 环境 php.ini 不一致、或 centos/almalinux 下 yum 安装未匹配 php 版本。

$phpenv提示the php extension \'bcmath\' is required 解决laravel环境$

为什么 Laravel 启动报 `The PHP extension 'bcmath' is required`？

这不是 Laravel 的 bug，而是它在 vendor/laravel/framework/src/Illuminate/Foundation/Bootstrap/LoadConfiguration.php 里做的硬性检查：只要检测到 bcadd()、bcmul() 等函数不可用，就直接抛出这个错误。Laravel 用 bcmath 做金额计算、加密盐生成、配置哈希等关键操作，不满足就拒绝启动。

常见诱因有三个：
• 宝塔面板里 PHP 版本已安装但 bcmath 没勾选启用；
• CLI（命令行）环境和 Web（FPM）环境用了不同的 php.ini，你改了 Web 的，但 php artisan 走的是 CLI 的；
• CentOS/AlmaLinux 上用 yum 安装时没指定 PHP 版本后缀，导致装错包或冲突。

确认是 CLI 还是 FPM 环境缺失 bcmath

必须分开查，因为它们可能完全独立：

查 CLI 是否可用：php -m | grep bcmath 或 php -r "var_dump(extension_loaded('bcmath'));"
查 FPM 是否可用：在网站根目录建 info.php，内容为 <?php phpinfo();，浏览器访问后搜索 bcmath，同时记下 “Loaded Configuration File” 路径
对比两个环境的 php --ini 输出，看是否指向不同 php.ini

如果 CLI 有而 FPM 没有，说明你只改了 CLI 的配置；反之亦然。别只信 phpinfo() 页面——它只反映 Web 环境。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 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 文件是否存在且可读。