宝塔安装PHP扩展未生效，首要检查php.ini加载路径是否正确；需确认对应PHP版本的配置文件、手动添加extension=xxx.so并重载配置；注意CLI与FPM配置分离及扩展ABI兼容性问题。
宝塔面板里点“安装”后扩展没生效？先查 php.ini 加载路径
宝塔软件商店点安装 PHP 扩展，界面显示成功，但 php -m 或 phpinfo() 里找不到——大概率是扩展没写进当前 PHP 版本实际加载的 php.ini。宝塔会为每个 PHP 版本维护独立的配置文件，路径类似 /www/server/php/82/etc/php.ini（82 表示 PHP 8.2），但软件商店有时会错配到其他版本或漏写 extension=xxx.so 行。
- 用宝塔面板右上角「PHP 管理」→ 对应版本 → 「配置文件」，确认打开的是正在使用的那个
php.ini - 搜索
extension=，看是否已存在如extension=redis.so；若没有，手动追加（注意路径是否带绝对路径，宝塔通常用相对路径即可） - 改完必须点「重载配置」或重启对应 PHP 服务，光点「保存」不生效
软件商店安装失败提示 configure: error: not found？检查依赖包是否齐全
常见于安装 imagick、grpc、yaml 这类需要编译的扩展。宝塔调用的是系统级 ./configure，缺头文件或开发库就会报这个错，和 PHP 本身无关。
- 先 SSH 登录，运行
php -v确认当前 CLI 使用的 PHP 版本（避免和面板里选的不一致） - 根据扩展名装基础依赖：比如
imagick需要ImageMagick-devel（CentOS）或libmagickwand-dev（Ubuntu/Debian）；yaml需要libyaml-devel - 宝塔软件商店安装前，建议先执行
yum groupinstall "Development Tools"（CentOS）或apt install build-essential（Ubuntu），否则连 gcc 都可能缺失
同一个扩展在多个 PHP 版本间共用？别直接复制 .so 文件
看到 /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/ 下有 redis.so，就想拷到 82 目录下复用——不行。PHP 扩展是 ABI 兼容的，不同主版本（如 7.4 和 8.2）的 .so 二进制不通用，强行加载会导致 PHP 启动失败或 segfault。
- 每个 PHP 版本必须单独安装对应扩展：在宝塔「PHP 管理」里选中目标版本，再进「扩展管理」点击安装
- 如果某扩展软件商店不提供（如较新的
psr或mongodb），得用命令行 +pecl安装，且要指定 PHP 的phpize路径，例如：/www/server/php/82/bin/phpize - 装完记得检查生成的
.so文件权限是否为 644，且属主是root，否则 PHP Worker 可能读取失败
安装后 phpinfo() 显示扩展，但 Laravel 报 Class not found？确认 CLI 和 FPM 加载的是同一份配置
宝塔默认把 Web 请求走 PHP-FPM，而命令行（如 php artisan）走 CLI SAPI，两者可能加载不同的 php.ini。扩展装到了 FPM 的配置里，CLI 没开，就会出现网页正常、终端报错的情况。
立即学习“PHP免费学习笔记（深入）”；
- 分别运行
php --ini（查 CLI 配置）和php-fpm -i | grep "Loaded Configuration File"（查 FPM 配置），对比路径是否一致 - 如果不一致，要么统一改到同一份
php.ini，要么分别在两个配置里都加上extension=xxx.so - 特别注意：某些扩展（如
opcache）在 CLI 下默认关闭，即使写了extension=opcache.so，也得额外加opcache.enable_cli=1
