PHP添加扩展需先确认安装方式和运行模式，再匹配扩展类型与路径，修改对应php.ini并重启服务，否则易报错或不生效。
PHP 添加扩展模块不是改个配置就能生效的事，得看扩展类型（编译时内置、动态加载、PECL 安装）、PHP 运行模式（CLI / FPM / Apache 模块）以及你的环境是源码编译还是包管理器安装（如 apt / yum / brew）。直接改 php.ini 加 extension=xxx.so 很可能报错或不生效。
确认 PHP 安装方式和扩展路径
不同安装方式的扩展存放位置、启用机制完全不同：
- Ubuntu/Debian 用
apt install php-mysql：扩展已预编译，只需启用对应.ini文件（如/etc/php/8.2/cli/conf.d/20-mysql.ini），不用手动找.so -
macOS 用
brew install php：扩展默认装在/opt/homebrew/lib/php/pecl/，但需运行pecl install redis后手动加extension=redis.so到php.ini - 源码编译安装：必须用
./configure --with-xxx或后续make && make install编译扩展，生成的.so通常在modules/目录下 -
php -i | grep "extension_dir"和php --ini是你必须先跑的两条命令，否则你连扩展该放哪、配置从哪读都不知道
动态加载扩展（最常见场景）
适用于已存在 .so 文件、只需启用的情况。注意不是所有扩展都支持动态加载（比如某些 ZTS 线程安全版本限制）：
- 找到正确的
php.ini：CLI 和 Web（如 Nginx + PHP-FPM）可能用不同配置文件，php --ini显示的是 CLI 的，phpinfo()页面里看的是 Web 的 - 扩展名要写对：
extension=mysqli.so（Linux/macOS）或extension=php_mysqli.dll（Windows），少个php_前缀或后缀错误都会导致PHP Warning: Unable to load dynamic library 'xxx' - 顺序有影响：依赖其他扩展的（如
pdo_mysql依赖pdo），extension=pdo.so必须写在前面 - 改完后必须重启服务：CLI 不用重启，但 PHP-FPM 要
sudo systemctl restart php8.2-fpm，Apache 要sudo systemctl restart apache2
用 PECL 安装新扩展（如 redis、swoole）
PECL 是 PHP 官方扩展仓库，但不是所有扩展都能一键成功：
立即学习“PHP免费学习笔记（深入）”；
- 先确保
phpize可用且版本匹配：phpize --version应与php -v一致，否则编译出的.so会报undefined symbol: core_globals - 某些扩展需要系统依赖：
pecl install redis前可能要sudo apt install php-dev pkg-config（Ubuntu）或brew install autoconf（macOS） - 安装后 PECL 通常会提示你加哪行到
php.ini，但别盲目照抄——检查路径是否真实存在，比如它说extension=redis.so，你要用ls /usr/lib/php/20220829/redis.so确认文件在不在 -
pecl install swoole默认编译为异步模式，若项目不需要协程，可加--enable-sockets减少依赖，避免因缺少libuv报错
php -m | grep -E "(redis|mysqli|pdo)" # 查看已启用的扩展，确认是否真加载成功 # 注意：如果输出为空，说明没启用；如果报段错误，很可能是 .so 版本与 PHP 不兼容
最容易被忽略的是：Web 服务器用的 PHP 配置和你在终端里 php -m 看的不是同一套。哪怕 php -m 显示 redis 已加载，phpinfo() 里没有，那一定是 FPM 或 Apache 加载了另一个 php.ini。务必用 phpinfo() 页面里的 Loaded Configuration File 路径为准。
