优先用系统包管理器安装PHP拓展,如apt或yum/dnf;源码编译仅在必要时进行且须严格匹配PHP版本;装完必须重启对应服务并验证生效,同时检查日志与权限配置。

PHP 拓展怎么装?直接用包管理器最稳
线上服务器装 PHP 拓展,别手写 phpize + ./configure + make + make install —— 容易漏依赖、版本错位、路径混乱。优先走系统包管理器,比如 Ubuntu/Debian 用 apt,CentOS/RHEL 用 yum 或 dnf。
-
apt install php-mysql(Ubuntu 22.04+ 默认装的是 PHP 8.1,拓展名统一为php-xxx) -
yum install php-gd(CentOS 7 需确认启用了 EPEL;CentOS 8+ 推荐dnf install php-gd) - 装完必须重启 PHP-FPM 或 Apache:
systemctl restart php8.1-fpm(注意版本号要匹配当前php -v输出) - 验证是否生效:
php -m | grep gd或php -i | grep "gd support"
源码编译装拓展?只在没包时才考虑,且必须锁定 PHP 版本
有些拓展(如 redis、swoole、protobuf)官方更新快,系统仓库滞后,这时才需源码装。但风险高:PHP 主版本不一致会导致 undefined symbol 错误,常见于 php -v 正常但 php-fpm 启动失败。
- 先查清楚当前 PHP 是怎么装的:
php-config --version和php-config --prefix必须和你准备编译的拓展对齐 - 下载对应 PHP 版本的拓展源码(例如 PHP 8.2 要用
redis5.3.7+,老版redis5.3.4 在 PHP 8.2 下会 segfault) -
phpize命令必须来自目标 PHP 安装路径,比如/usr/bin/phpize或/opt/php/bin/phpize,别用系统默认的 - 编译后生成的
.so文件路径,要和php.ini中extension_dir严格一致;否则extension=redis.so会报unable to load dynamic library
线上装拓展最怕什么?不是装不上,是装上后服务挂了
生产环境最常踩的坑不是“不会装”,而是“装完没验证就上线”,导致接口 502、图片无法生成、数据库连不上。安全底线不是“能装”,而是“不影响现有请求”。
- 禁止在高峰期操作:改
php.ini或重启php-fpm会清空所有 worker 进程,瞬间并发高的站点可能触发雪崩 - 拓展之间有冲突:比如
opcache和xdebug不能共存;apcu和apc会报Cannot redeclare class - 某些拓展强制开启全局配置:比如
mbstring.func_overload已废弃,但在旧版mbstring中启用会导致 JSON 解析异常 - 装完务必检查错误日志:
tail -f /var/log/php8.1-fpm.log和journalctl -u php8.1-fpm -n 50 -f,重点看WARNING和FATAL级别
权限与路径细节,90% 的人会忽略
线上服务器通常多 PHP 版本共存或自定义安装路径,extension_dir 和 ini 加载顺序稍错一点,拓展就等于没装。
立即学习“PHP免费学习笔记(深入)”;
-
php --ini显示的是 CLI 模式加载的php.ini,而 PHP-FPM 用的是另一份(通常是/etc/php/8.1/fpm/php.ini或/usr/local/etc/php/8.1/php-fpm.d/www.conf里指定的) -
extension_dir路径末尾不能带斜杠,extension_dir = "/usr/lib/php/20220829/"是错的,应为"/usr/lib/php/20220829" - 拓展文件权限必须是
root:root且不可写(chmod 644 xxx.so),否则 PHP-FPM worker 进程因权限不足拒绝加载 - 如果用容器或 chroot 环境,确保
.so依赖的系统库(如libjpeg、libsodium)已提前安装,否则dlopen失败无提示
phpinfo() 里的 Loaded Configuration File 和 Scan this dir for additional .ini files,再动手。











