装PHP扩展前须确认php.ini路径与加载模式，区分CLI与Web环境配置；检查extension_dir权限、扩展名拼写及启用状态；PECL安装需预装编译工具与PHP开发包，并注意版本兼容性；依赖扩展需按顺序集中写入php.ini底部；验证须用测试脚本而非仅php -m。
装 PHP 扩展前必须确认 php.ini 路径和加载模式
很多人直接改错配置文件，装完扩展却没生效——根本原因是用了 CLI 的 php.ini，而 Web 服务器（如 Apache/Nginx）跑的是另一个。先执行：
php --ini看 Loaded Configuration File；再在 Web 环境里建个
info.php，写 <?php phpinfo(); ?>，浏览器打开查 “Loaded Configuration File” 行。两个路径不一致，就得分别处理。
还要确认扩展是否启用：检查 extension_dir 指向的目录是否存在、权限是否可读；确认 extension=xxx.so（Linux/macOS）或 extension=php_xxx.dll（Windows）这一行没被注释，且拼写与实际文件名完全一致（注意大小写、下划线、版本后缀）。
用 pecl install 装扩展时得先配好编译环境
PECL 是源码安装，不是下载即用。常见失败原因：缺 phpize、gcc、autoconf、make，或 PHP 开发头文件（如 Debian/Ubuntu 要 apt install php-dev，CentOS/RHEL 是 php-devel）。装之前运行：
which phpize && phpize --version确保命令可用。
另外注意 PECL 包版本兼容性：pecl install redis 默认装最新版，但 PHP 7.4 不支持 redis 6.0+ 的某些 API；建议显式指定版本，比如：
pecl install redis-5.3.7再对照 PECL 页面 查对应 PHP 版本支持范围。
立即学习“PHP免费学习笔记（深入）”；
在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……
extension= 加载顺序影响依赖关系
如果扩展 A 依赖扩展 B（比如 igbinary 要在 redis 之前加载），顺序错了会报：PHP Warning: Module 'redis' already loaded in Unknown on line 0 或更隐蔽的段错误。解决方法是统一把扩展加载语句集中写在 php.ini 底部，按依赖关系从上到下排列：
extension=igbinary.so<br>extension=redis.so<br>extension=memcached.so
别把部分扩展写进 conf.d/ 子配置（如 /etc/php/8.2/cli/conf.d/20-redis.ini），部分写进主 php.ini——混合管理极易导致顺序失控。
验证扩展是否真生效不能只靠 php -m
php -m | grep redis 只说明模块已注册，不代表能用。真实场景中常遇到：扩展加载成功，但调用时报 Class 'Redis' not found，原因是扩展虽加载，但类未注册（比如 redis.so 编译时禁用了 redis.session_handler 选项，或启用了 --enable-redis-igbinary 却没装 igbinary）。务必写测试脚本验证核心功能：
<?php<br>$r = new Redis();<br>var_dump($r->connect('127.0.0.1', 6379));<br>?>
Web 和 CLI 两个 SAPI 都要测；若用 Docker，还要确认容器内 php -v 和宿主机看到的不是同一个 PHP 实例。
最容易被忽略的是：扩展的 .so/.dll 文件权限（尤其 SELinux 强制策略下）、extension_dir 路径含中文或空格、以及某些扩展（如 swoole）要求关闭 opcache.enable_cli 才能在 CLI 下调试。这些细节不排查，光重装十遍也没用。
