装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免费学习笔记(深入)”;