在小皮面板里给 PHP 装扩展，最稳妥的做法是走面板自带的图形界面：软件商店 → 对应 PHP 版本 → 设置 → 安装扩展，点选后一键编译安装，装完后重启该版本的 PHP-FPM 才会生效。面板扩展列表里没有的（比如部分版本下的 imagick），再用 pecl 或源码 phpize 编译，最后在 php.ini 里加一行 extension= 即可。
小皮面板给 PHP 装扩展的标准步骤是什么？
结论：能点选就不要手编，面板的扩展列表已经把编译依赖和 php.ini 写入一起做完了，成功率高出一个量级。
- 登录面板，进入「软件商店」，找到已安装的 PHP 版本（例如 PHP 8.0）。
- 点该版本右侧「设置」，切到「安装扩展」标签页。
- 在列表里勾选 fileinfo、redis、opcache、imagick 等目标扩展，点「安装」，面板会调用源码包编译并自动写入 php.ini。
- 安装完成后点「重启」，或在该页点 PHP-FPM 重启按钮。命令行重启可用
systemctl restart php-fpm-80（服务名以面板显示的版本号为准）。
- 验证：面板「设置 → 负载状态 / phpinfo」里搜索扩展名，或命令行
/www/server/php/80/bin/php -m | grep -i fileinfo。
注意：小皮面板支持多 PHP 版本并存，每个版本有独立目录和独立 php.ini。结论：在 PHP 7.4 装的扩展不会对 PHP 8.0 生效，站点切了 PHP 版本要重新装一遍。
fileinfo 扩展怎么开启？
结论：fileinfo 在多数面板编译参数里已经编进去了，缺的只是 php.ini 里那一行开关，先查再装。
先执行 php -m | grep -i fileinfo，如果没有任何输出，打开该 PHP 版本的 php.ini（面板「设置 → 配置文件」可直接编辑，路径形如 /www/server/php/80/etc/php.ini，以面板显示为准），确认 extension_dir 指向的目录里存在 fileinfo.so。存在就加一行：
extension=fileinfo
不存在再回面板扩展列表点安装。fileinfo 是 PHP 内置的 MIME 类型识别扩展，WordPress、ThinkPHP 等程序做上传文件类型校验时会调用 finfo_open()，缺失时报 Call to undefined function finfo_open()。
imagick 扩展怎么安装？
结论：imagick 不是「一个扩展」那么简单，它依赖 ImageMagick 的 C 库（MagickWand），必须先装系统库再编译扩展，顺序错了必然报错。
以 CentOS 为例：
yum install -y ImageMagick ImageMagick-devel gcc make autoconf
pecl install imagick
Debian/Ubuntu 换成 apt install libmagickwand-dev。编译过程中提示 Please provide the prefix of ImageMagick installation 时直接回车走默认路径。装完在 php.ini 加 extension=imagick.so 并重启 PHP-FPM。
如果 pecl 不可用，就下载对应 PHP 版本的 imagick 源码包，进入目录依次执行 phpize、./configure --with-php-config=/www/server/php/80/bin/php-config、make && make install。
版本匹配是最大的坑：imagick 3.7.x 对应 ImageMagick 7，imagick 3.4.x 对应 ImageMagick 6。结论：先 convert -version 看系统 ImageMagick 大版本，再决定装哪个 imagick，否则会出现「编译通过但加载失败」。
扩展装完不生效怎么排查？
结论：装完不生效 90% 出在「改了不是当前生效的那个 php.ini」或「没重启 FPM」这两件事上。
按顺序查四步：
php --ini 或页面 phpinfo() 看 Loaded Configuration File，确认改的文件和加载的文件是同一个。命令行 PHP 和 FPM 可能读不同 ini。- 看
extension_dir 的值，ls 一下目录里是否真有 xxx.so。
- 看 PHP 错误日志，出现
Unable to load dynamic library 说明路径错或 ABI 不匹配（比如拿 PHP 7.4 编译的 so 塞给 PHP 8.0）。
- 确认重启的是当前站点所用版本对应的 PHP-FPM 进程，不是别的版本。
装扩展前要不要备份？
要。结论：编译类扩展可能改动 php.ini 和依赖库，动手前把 php.ini 复制一份、给面板做一次快照，出问题 5 分钟能回滚，比排查一小时划算。
改 php.ini 优先用面板「设置 → 配置修改」，它会在保存前做语法检查；直接 vi 改错一个分号就会让整站 502。另外单个站点如果只需要某个扩展，尽量在面板里按版本装，不要为了一个站把全局环境搞乱。
小结：小皮面板装 PHP 扩展的路径就是「面板列表优先、系统库先行、php.ini 写开关、重启 FPM 生效、四步排查兜底」。fileinfo 属于开开关就能用，imagick 属于先装 ImageMagick 再编译，两者都不是手编越复杂越好，而是顺序对了就通。
