优先用系统包管理器安装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、图片无法生成、数据库连不上。安全底线不是“能装”,而是“不影响现有请求”。