需先运行php -i | grep -E "(PHP Version|Thread Safety|Configure Command)"确认PHP版本、ZTS模式及编译参数，再据此选择匹配的扩展包；Linux推荐用包管理器（如apt install php8.1-redis），Windows须按DLL文件名中的版本/ZTS/架构信息配置php.ini。
怎么看当前 PHP 版本和编译参数
装拓展前必须确认 php -v 输出的版本号（如 8.1.27），但光看这个不够——关键要看是否为 zts（线程安全）模式、debug 构建、以及用的什么 SAPI（如 fpm 还是 cli）。这些直接决定拓展.so文件能否加载。
运行以下命令获取完整信息：
php -i | grep -E "(PHP Version|Configure Command|Thread Safety|Debug Build|Server API)"
重点关注三处：
-
PHP Version：取主版本号，如8.1.27→ 对应php81或php-8.1命名的拓展包 -
Thread Safety：显示enabled表示需要带zts后缀的拓展；disabled则选非 zts 版本 -
Configure Command中若有--enable-debug，则需 debug 版拓展（极少见，一般跳过）
Linux 下用包管理器装拓展（推荐）
Ubuntu/Debian 用 apt，CentOS/RHEL 用 yum 或 dnf，它们会自动匹配当前 PHP 版本和 ABI 兼容性，省去手动找包的麻烦。
立即学习“PHP免费学习笔记（深入）”；
例如 Ubuntu 22.04 上装 redis 拓展：
sudo apt update<br>sudo apt install php8.1-redis
注意命名规律：
-
php8.1-redis→ 绑定 PHP 8.1，自动适配非 zts + production 模式 -
php8.1-zip、php8.1-mbstring同理 - 若系统装了多个 PHP 版本（如同时有 8.1 和 8.2），必须指定版本前缀，否则可能装到默认版本（通常是低版本）
装完别忘了重启对应服务：sudo systemctl restart php8.1-fpm 或 sudo systemctl restart apache2。
手动编译安装时怎么选 .so 文件
从官网或第三方源（如 pecl.php.net）下载拓展源码后，phpize 和 ./configure 阶段必须指向正确的 PHP 配置路径，否则生成的 .so 会 ABI 不兼容，加载时报 undefined symbol 或 cannot open shared object file。
执行前先确认：
- 用
which php-config查路径，确保它属于目标 PHP 版本（比如输出/usr/bin/php-config8.1） - 运行
php-config --version和php-config --extension-dir核对版本与拓展目录 -
./configure --with-php-config=/usr/bin/php-config8.1（路径按实际调整）
编译完成后，检查生成的 .so 是否能被识别：
file modules/redis.so | grep "ELF.*x86-64"
如果提示 not a dynamic executable 或架构不匹配，说明 phpize 用错了版本。
Windows 下 DLL 文件名和 php.ini 配置要点
Windows 用户容易卡在 DLL 名字和 extension= 写法上。PECL 页面下载的 DLL 文件名通常含版本和 ZTS 标识，例如：
-
php_redis-5.3.7-8.1-ts-vc15-x64.zip→ 8.1 版本、ts（ZTS）、VC15 编译器、64 位 -
php_redis-5.3.7-8.1-nts-vc15-x64.zip→nts即非线程安全，对应 Apache + mod_php 或 Nginx + PHP-FPM 场景
解压后把 php_redis.dll 放进 ext/ 目录，然后在 php.ini 中写：
extension=php_redis.dll
⚠️ 注意：不能写成 extension=redis（旧写法已弃用），也不能漏掉 .dll 后缀；若用的是 php.ini-development 而不是 php.ini-production，记得改对文件。
改完运行 php --ini 确认加载的是你编辑的那个 php.ini，再用 php -m | grep redis 验证是否启用成功。
ABI 兼容性是硬门槛，版本、ZTS、编译器、位数四者错一个，拓展就加载失败——宁可多跑一遍 php -i，也别凭印象选包。
