命令行安装扩展更可控，面板安装省事但易出兼容问题；需先确认php版本、php.ini路径及权限，再按环境选择方式。
命令行装拓展更可控，面板装省事但容易出兼容问题——选哪个，取决于你能不能看到 php.ini 路径、会不会查 php -v 和 php -m，以及服务器有没有权限装系统依赖。
怎么看当前 PHP 版本和配置路径
装拓展前必须确认环境，否则装错版本或路径白忙活。用命令行最直接：
php -v php --ini php -m | grep curl
php --ini 输出的 “Loaded Configuration File” 那一行才是真实生效的 php.ini；如果显示 “Scan for additional .ini files in”，说明拓展可能通过独立 .ini 文件加载（比如 /etc/php/8.2/cli/conf.d/20-curl.ini）。
- 面板（如宝塔、AMH）通常会把 CLI 和 Web 的
php.ini分开，php -i显示的是 CLI 配置，浏览器里phpinfo()显示的是 FPM/Apache 模块配置 - 宝塔用户常踩的坑：在面板点“安装 curl”，结果 CLI 下
php -m看不到，因为只改了 FPM 的php.ini - Ubuntu/Debian 系统下，不同 PHP 版本的拓展包名带版本号，比如
php8.2-curl，装错版本号就加载失败
命令行装拓展的典型流程（以 Ubuntu + PHP 8.2 为例）
适用于有 root 权限、能连外网、需要精确控制的场景。核心是三步：装系统包 → 启用模块 → 重启服务。
立即学习“PHP免费学习笔记（深入）”；
- 查拓展是否已有系统包：
apt search php8.2-，看到php8.2-curl就不用编译 - 直接安装：
sudo apt install php8.2-curl，系统自动写好20-curl.ini并放进conf.d目录 - 验证：CLI 下运行
php -m | grep curl；Web 下刷新phpinfo()页面看 curl 模块是否在“Registered PHP Streams”里 - 如果拓展没现成包（比如
protobuf或自定义扩展），就得用pecl install protobuf，然后手动加extension=protobuf.so到php.ini
面板装拓展的隐患在哪
宝塔等面板封装了安装逻辑，表面点几下就行，但背后容易埋雷：
- 面板调用的其实是命令行脚本，但它可能固定用某个 PHP 版本的
pecl，而你当前站点用的是另一个版本（比如面板用 8.1 的 pecl 装包，站点跑在 8.2 上） - 部分拓展（如
redis、swoole）依赖特定编译参数或系统库，面板一键安装时没提示缺libssl-dev或gcc，装完报undefined symbol - 面板更新后可能重写
php.ini，把你手动加的extension=xxx.so给清掉，或者把extension_dir改成错误路径 - 有些面板“安装成功”只是把文件丢进目录，没检查
so文件权限（比如root:root但 fpm 进程是www-data，加载失败无提示）
实在不想碰命令行？至少做这三件事
哪怕全靠面板，也得守住底线，否则出问题连日志都看不懂：
- 装完立刻打开终端，执行
php -m和php -i | grep extension_dir，确认模块名和 so 文件路径对得上 - 在面板里找到“PHP 设置 → 配置文件”，搜索
extension=，看有没有重复加载同一拓展（比如既有extension=curl又有extension=/usr/lib/php/8.2/curl.so） - 修改任何配置后，不要只点“重载配置”，要明确重启对应服务：
sudo systemctl restart php8.2-fpm（FPM）或sudo systemctl restart apache2（Apache）
真正省心不是少敲命令，而是清楚每一步在改什么、改到哪一层。命令行暴露细节，面板隐藏细节——细节藏得越深，排查时挖得越苦。
