最稳妥的PHP扩展安装方式是先确认PHP版本、安装方式及仓库支持情况；查看php --ini和php-config --extension-dir定位配置与扩展路径；优先用apt/yum安装对应版本的扩展包，其次才考虑pecl。
Linux 下装 PHP 扩展，最稳妥的方式不是“一键命令”，而是先确认 PHP 版本、安装方式（系统包管理器 or 源码编译）、以及扩展是否已打包进发行版仓库——跳过这步，pecl install 很可能装上却加载失败。
怎么看当前 PHP 是怎么装的、用的哪个配置文件
很多人装完扩展发现 php -m 里没有，根本原因是 PHP 有多个配置目录（CLI / FPM / Apache 模块可能各用一套），而扩展只写进了其中一份 php.ini。
- 运行
php --ini查看加载的主配置路径和扫描目录（重点关注Scan for additional .ini files in:后面那个路径） - 运行
php-config --extension-dir确认扩展实际存放位置（比如/usr/lib/php/20220829），后续手动启用时要确保.so文件放对地方 - 如果用的是 Ubuntu/Debian 的
apt install php，绝大多数常用扩展都有对应包名，如php-mysql、php-redis、php-gd—— 直接apt install最省事，也自动处理了ini加载
用 apt/yum 安装扩展（推荐优先尝试）
Debian/Ubuntu 和 RHEL/CentOS 的包命名规则不同，但逻辑一致：PHP 主版本号会体现在包名中，必须匹配。
- Ubuntu 22.04 + PHP 8.1：
sudo apt install php8.1-mysql php8.1-curl php8.1-xml - CentOS 7 + PHP 7.4（来自 remi 仓库）：
sudo yum install php-mysqlnd php-xml php-gd（注意：remi 默认启用后，php-前缀即对应当前默认 PHP 版本） - 装完别忘了重启服务：
sudo systemctl restart php8.1-fpm或sudo systemctl restart apache2
用 pecl 装扩展（适合没打包或需自定义编译参数）
pecl 是 PHP 官方的扩展分发工具，但它不解决依赖和路径问题，出错率高。仅在以下情况考虑：
立即学习“PHP免费学习笔记（深入）”；
- 扩展尚未被主流发行版收录（如新发布的
psr、uopz） - 需要启用特定编译选项（如
--with-openssl-dir=/opt/openssl） - 执行前先确认：
which phpize和which php-config是否可用；若不可用，需先装php-dev（Debian）或php-devel（RHEL） - 典型流程：
pecl install redis→ 自动编译并输出.so路径 → 手动在正确php.ini里加extension=redis.so→ 重启服务
常见失败点：extension_dir 不匹配、模块 ABI 版本错
最隐蔽的问题是：扩展编译时用的 PHP 头文件版本和当前运行的 PHP 不一致，导致 php -m 报错 undefined symbol: core_globals 或直接段错误。
- 检查方法：
php -v和phpize -v输出的版本号必须完全一致（包括小版本，如 8.1.27） - 若不一致，删掉
~/.pecl缓存，重装php-dev包，再运行pecl install - 手动复制
.so文件时，别抄错目录：不是/usr/lib/php/modules/就是/usr/lib/php/20220829/（后者是 PHP 8.1 的标准 extension_dir）
真正卡住人的往往不是命令记不住，而是没意识到 PHP 可能有多个二进制、多个配置、多个 extension_dir —— 在执行任何安装命令前，先跑一遍 php --ini 和 php-config --extension-dir，比反复重装快得多。
