先查 php.ini 实际加载路径，执行 php --ini 看 “Loaded Configuration File”；若为 (none) 需手动指定或放至默认路径；extension_dir 必须为绝对路径，扩展名需匹配系统（Linux/macOS 用 .so，Windows 用 .dll）；优先用系统包管理器安装常用扩展；注意 CLI 与 Web 环境配置分离，需分别验证。
扩展没加载成功？先查 php.ini 里写的是哪个路径
PHP 加载扩展靠的是 extension_dir 和 extension=xxx.so（Linux/macOS）或 extension=xxx.dll（Windows）这两行配置，但很多人改了配置却没生效，根本原因是 PHP 实际读的不是你编辑的那个 php.ini 文件。
执行 php --ini 看加载顺序，重点看 “Loaded Configuration File” 这一行；如果显示 “(none)”，说明 PHP 根本没读任何 php.ini，得手动指定或把配置文件放到默认搜索路径里（比如 /etc/php/8.2/cli/php.ini 或 C:\xampp\php\php.ini）。
- 用
php -m | grep curl快速验证模块是否已启用（替换curl为你想查的扩展名） -
extension_dir值必须是绝对路径，相对路径（如./ext）在 CLI 模式下大概率失效 - Windows 下扩展名必须是
.dll，且文件得真存在于extension_dir指向的目录中——别只复制配置就以为完事了
pecl install 失败？优先考虑系统包管理器
pecl install 看似方便，但实际容易卡在编译环节：缺 phpize、找不到 autoconf、头文件路径不对、或者扩展本身不兼容当前 PHP 版本。对绝大多数常用扩展（如 redis、memcached、igbinary），直接用系统包管理器更稳。
- Ubuntu/Debian：
sudo apt install php-redis php-memcached—— 安装后自动写好extension=行，不用手改php.ini - CentOS/RHEL：
sudo yum install php-pecl-redis（注意 PHP 版本仓库要匹配，比如php82-php-pecl-redis） - macOS + Homebrew：
brew install php@8.2默认带常用扩展；额外装brew install php-redis会自动链接到对应 PHP 的extension_dir
只有当你需要某个 PECL 上的新版、或非标准扩展（比如 xlswriter），才值得折腾 pecl install，并且务必加 -f 强制重装，避免缓存旧构建产物。
立即学习“PHP免费学习笔记（深入）”；
extension= 写法不对？动态加载和静态编译有区别
有些扩展（如 opcache、mbstring）在编译 PHP 时就被静态链接进去了，这时写 extension=opcache 不仅多余，还可能报错 “Cannot load module … it’s already loaded”。而像 redis、grpc 这类必须走动态加载，漏写或拼错名字就直接不工作。
- 查扩展是否内置：
php -i | grep "Registered PHP Streams"（看有没有https、phar这类）；或翻php -m输出里有没有它 - Linux 下扩展名通常是
redis.so，但某些发行版打包后叫redis.so或module_redis.so，得去extension_dir目录里ls确认真实文件名 - Windows 下必须用
.dll，且不能写成extension=php_redis.dll（除非你手动改过文件名），默认就是extension=redis—— PHP 会自动补.dll
CLI 和 Web 用的不是同一份配置？两个环境都要测
你在终端跑 php -m 看到 redis 已加载，但浏览器打开 phpinfo() 却没有，十有八九是 CLI 和 Apache/Nginx-FPM 用的不是同一个 php.ini。尤其在 Docker 或多版本共存环境下，这个问题高频出现。
- CLI 模式下查配置：
php --ini - Web 模式下查配置：新建一个
info.php，内容为<?php phpinfo(); ?>，浏览器访问，搜 “Loaded Configuration File” - Apache 用户注意：
php_admin_value extension_dir这类指令如果写在.htaccess或虚拟主机配置里，会覆盖php.ini中的设置，且只对当前 vhost 生效
最保险的做法：改完配置后，分别用 php -m 和 phpinfo() 验证，别只信一个。
