PHP 7.4 安全修复版源码编译安装及维护手册
|
1 2 3 4 5 |
适用系统: 麒麟 V10、RPM 系 Linux,部分操作适用于 Debian 升级目标: PHP 7.4.33 安全修复版 修复漏洞: CVE-2026-109618、CVE-2026-109619 部署方式: Apache + PHP-FPM 安装方式: 源码编译,独立目录安装 |
一、安装说明
本次使用 PHP 官方提供的 PHP 7.4 安全补丁源码分支,编译安装 PHP 7.4,修复 CVE-2026-109618 和 CVE-2026-109619。
采用独立目录安装,不覆盖原 PHP ,升级成功后再切换 Apache 和 PHP-FPM 服务。
1.1 目录规划
| 用途 | 路径 |
| PHP 源码 | /usr/local/src/php-7.4-fixed |
| PHP 7.4 安装目录 | /usr/local/lib/php/7.4-CVE-2026-109618-109619 |
| PHP 配置目录 | 安装目录/etc |
| php.ini 扫描目录 | 安装目录/etc/php.d |
| PHP-FPM 主配置 | 安装目录/etc/php-fpm.conf |
| PHP-FPM 进程池配置 | 安装目录/etc/php-fpm.d/www.conf |
| 新 systemd 服务 | /etc/systemd/system/php-fpm-7.4-CVE-2026-109618-109619.service |
| 新 PHP-FPM 测试端口 | 127.0.0.1:9001(测试完成之后可以改为默认的9000) |
| 旧 PHP-FPM 端口(如果有) | 通常为 127.0.0.1:9000,以实际为准 |
1.2 操作注意事项
- 编译前备份原 PHP 配置及 systemd 服务。
- 新 PHP 使用独立安装目录。
- 新旧 PHP-FPM 先分别监听不同端口。
- 验证新 PHP 正常后再修改 Apache。
- 升级完成后保留 PHP 7.3,以便出现问题时回滚。
二、升级前检查与备份
2.1 查看系统和 PHP 环境
|
1 2 3 4 5 6 7 8 |
cat /etc/os-release uname -m php -v php --ini php -i | grep 'Configure Command' which php |
查看 PHP-FPM 服务:
|
1 2 3 |
systemctl list-unit-files | grep -i php systemctl status php-fpm-7.3.service systemctl cat php-fpm-7.3.service |
查看监听端口:
|
1 |
ss -lntp | grep -E '9000|9001' |
检查 Apache 使用 PHP-FPM 还是 mod_php:
|
1 |
apachectl -M 2>/dev/null | grep -Ei 'php|proxy|fcgi' |
本手册的服务切换步骤适用于 PHP-FPM;如果现场使用 mod_php,需要另行调整 Apache 模块配置。
2.2 备份配置
|
1 2 3 4 5 |
mkdir -p /root/php-upgrade-backup cp -a /usr/local/lib/php/7.3/etc /root/php-upgrade-backup/php73-etc cp -a /etc/systemd/system/php-fpm-7.3.service /root/php-upgrade-backup/ |
原路径及服务名称应根据实际环境调整。
同时备份 Apache 虚拟主机配置,并保存旧 PHP-FPM 的监听地址、运行用户和进程参数。
三、下载 PHP 7.4 安全修复源码
3.1 源码地址
PHP 官方原始 PHP 7.4.33 源码:
|
1 |
https://www.php.net/distributions/php-7.4.33.tar.gz |
注意:这是 2022 年发布的原始源码,不包含 2026 年这两个 CVE 的安全修复。
本次使用 PHP 官方安全修复分支:
|
1 |
https://github.com/php/php-src/tree/PHP-7.4-CVE-2026-109618-109619 |
GitHub 源码压缩包:
|
1 |
https://github.com/php/php-src/archive/refs/heads/PHP-7.4-CVE-2026-109618-109619.tar.gz |
3.2 下载源码
方式一:wget 下载。
|
1 2 3 4 5 6 7 8 9 10 |
mkdir -p /usr/local/src cd /usr/local/src wget -O php-7.4-fixed.tar.gz "https://github.com/php/php-src/archive/refs/heads/PHP-7.4-CVE-2026-109618-109619.tar.gz" tar -xzf php-7.4-fixed.tar.gz mv php-src-PHP-7.4-CVE-2026-109618-109619 php-7.4-fixed cd php-7.4-fixed |
方式二:Git 下载(推荐,便于记录提交版本)。
|
1 2 3 4 5 6 7 8 |
cd /usr/local/src git clone --branch PHP-7.4-CVE-2026-109618-109619 https://github.com/php/php-src.git php-7.4-fixed cd php-7.4-fixed git rev-parse HEAD git log -5 --oneline |
建议保存源码提交 ID 和下载文件的 SHA256 值,方便以后审计。
3.3 检查源码
|
1 2 3 4 |
ls -ld Zend ext sapi main ls -l buildconf ls -l configure.ac |
以上目录和文件存在,说明取得了 PHP 源码树。
如果使用 Git 下载,还应确认:
|
1 2 3 |
git status git branch --show-current git log -1 --format='%H %s' |
安全补丁核验应以该分支的实际修复提交及代码差异为依据,而不能仅依赖源码目录名称。
四、安装 PHP 编译环境
4.1 安装基础编译工具
麒麟、RPM 系 Linux:
|
1 |
yum groupinstall "Development Tools" |
|
1 2 3 4 5 6 |
yum install gcc gcc-c++ make autoconf automake libtool bison re2c sqlite-devel oniguruma \ oniguruma-devel pkgconfig libxml2-devel openssl-devel bzip2-devel libcurl-devel \ git libzip-devel freetype-devel libpng-devel libjpeg-devel \ gettext-devel libXpm-devel gmp-devel mariadb-devel aspell-devel \ zlib-devel tar xz recode-devel autoconf213 libicu-devel \ wget readline-devel libxslt-devel libjpeg-turbo-devel libwebp-devel |
对于 imagick 扩展,你还需要安装 ImageMagick 开发库:
|
1 |
yum install ImageMagick-devel |
不同麒麟版本的软件源可能不存在某些软件包,需要根据实际情况分别安装,不能跨系统强行安装不兼容的 RPM。
3.2 检查工具
|
1 2 3 4 5 |
gcc --version autoconf --version bison --version pkg-config --version re2c --version |
PHP 7.4 GitHub 源码需要生成构建文件,所以对编译工具的要求与普通 PHP 发布版源码包略有区别。
五、生成 configure 并配置 PHP
5.1 生成 configure
GitHub 源码需要先生成 configure 文件:
|
1 2 |
cd /usr/local/src/php-7.4-fixed ./buildconf --force |
验证:
|
1 |
ls -lh configure |
5.2 检查依赖
|
1 2 3 4 |
re2c --version bison --version pkg-config --modversion oniguruma |
如果 Oniguruma 使用源码安装,且安装在 /usr/local/oniguruma:
|
1 |
export PKG_CONFIG_PATH=/usr/local/oniguruma/lib/pkgconfig:${PKG_CONFIG_PATH:-} |
如果库位于 lib64,需相应调整路径。
5.3 PHP 7.4 完整 configure 命令
|
1 2 3 4 5 6 7 8 |
./configure --prefix=/usr/local/lib/php/7.4-CVE-2026-109618-109619 \ --with-config-file-path=/usr/local/lib/php/7.4-CVE-2026-109618-109619/etc \ --with-config-file-scan-dir=/usr/local/lib/php/7.4-CVE-2026-109618-109619/etc/php.d \ --enable-calendar --enable-sysvshm --enable-sysvsem --enable-shmop --enable-sockets \ --enable-bcmath --enable-mbstring --enable-intl --enable-soap --with-zip --enable-pdo \ --enable-fpm --enable-mysqlnd --with-openssl --with-zlib --with-bz2 --with-curl \ --with-readline --with-iconv --with-gettext --with-mysqli=mysqlnd --with-pdo-mysql=mysqlnd \ --with-xsl --with-xmlrpc --enable-gd --with-jpeg --with-freetype --with-webp --with-xpm |
5.4 确认配置完成
正常完成后会显示:
|
1 2 |
config.status: creating main/php_config.h Thank you for using PHP. |
确认没有 configure: error,并检查是否出现 unrecognized options。
如有错误,参考第十一章。
六、编译及安装 PHP 7.4
6.1 编译
|
1 |
make -j4 |
根据服务器 CPU 和可用内存调整并行数量。
6.2 编译后检查
|
1 |
./sapi/cli/php -v |
检查扩展:
|
1 |
./sapi/cli/php -m |
重点确认:
|
1 |
./sapi/cli/php -m | grep -Ei 'gd|zip|intl|soap|mysqli|pdo_mysql|mbstring|openssl' |
可运行 PHP 自带测试:
|
1 |
make test |
如果存在失败的测试,需要分析原因,不应直接忽略。
6.3 安装
|
1 |
make install |
注: 如果需要重新编译php, 清理旧编译环境
|
1 2 |
make clean make distclean |
添加环境变量
|
1 2 |
echo 'export PATH=/usr/local/lib/php/7.4-CVE-2026-109618-109619/bin:$PATH' >> /etc/profile source /etc/profile |
七、配置 PHP 7.4
7.1 配置 php.ini
源码目录复制 PHP 配置文件模板
|
1 2 |
cd /usr/local/src/php-7.4-fixed cp php.ini-development /usr/local/lib/php/7.4-CVE-2026-109618-109619/etc/php.ini |
修改php.ini
|
1 2 3 4 5 6 7 |
date.timezone = Asia/Shanghai max_execution_time = 300 max_input_time = 300 max_input_vars = 50000 memory_limit = 2048M post_max_size = 256M upload_max_filesize = 200M |
如果是金仓数据库的话,需要在文件最后引入金仓的PHP扩展,扩展目录以实际为准。
|
1 2 |
# 引入金仓的PHP扩展 extension=/home/data/Kingbase/V009R003C015B0004/php_pdo/KingbaseES_V009R001C010B0004_X64_Linux_PHP/KingbaseES_V9_X64_Linux_PHP_NTS_7.4/pdo_kdb.so |
以上为参考值,正式部署应优先保留客户原有业务参数。
7.2 修改php-fpm(如果使用)
php配置文件目录 /usr/local/lib/php/7.4-CVE-2026-109618-109619/etc/
配置php-fpm.conf
php配置文件目录复制php-fpm.conf配置文件模板
|
1 |
cp php-fpm.conf.default php-fpm.conf |
修改php-fpm.conf
|
1 2 3 |
pid = run/php-fpm.pid // 取消注释 error_log = /usr/local/lib/php/7.4-CVE-2026-109618-109619/var/log/php-fpm-error.log // 取消注释 daemonize = no // 取消注释, 并改为 no |
配置www.conf
php配置文件目录复制php-fpm.conf配置文件模板
|
1 2 |
cd php-fpm.d/ cp www.conf.default www.conf |
修改www.conf
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
;; 开启慢日志 ; 动态模式 可以根据服务器的性能调整当前配置适合8核16G pm = dynamic ; 最多同时有 20 个 PHP 子进程处理请求 pm.max_children = 20 ; php-fpm 启动时,先创建 6 个子进程。 pm.start_servers = 6 ; 最少保留 5 个空闲进程。 pm.min_spare_servers = 5 ; 最多保留 20 个空闲进程。 pm.max_spare_servers = 10 ; 每个 PHP 子进程处理 500 个请求后自动重启。 pm.max_requests = 500 ; 开启access.log日志 access.log = /usr/local/lib/php/7.4-CVE-2026-109618-109619/var/log/access.log ; 开启slow.log日志 request_slowlog_timeout = 5s slowlog = /usr/local/lib/php/7.4-CVE-2026-109618-109619/var/log/php-fpm-slow.log request_terminate_timeout = 60s |
|
1 2 3 4 5 6 7 8 9 10 11 |
# 开启报错日志 有些操作系统 #注释 会报错 需要改成 ; 进行注释 php_admin_value[error_log] = /usr/local/lib/php/7.4-CVE-2026-109618-109619/var/log/php-fpm/www-error.log php_admin_flag[log_errors] = on # 添加以下内容 有些操作系统 #注释 会报错 需要改成 ; 进行注释 php_admin_value[memory_limit] = 2048M php_admin_value[post_max_size] = 256M php_admin_value[upload_max_filesize] = 200M php_admin_value[max_execution_time] = 300 php_admin_value[max_input_time] = 300 php_admin_value[max_input_vars] = 50000 |
7.3 设置.log 日志轮转
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 |
# 1.新建 logrotate 配置文件 vim /etc/logrotate.d/php-fpm-log # 2. 增加配置 /usr/local/lib/php/7.4-CVE-2026-109618-109619/var/log/*.log { daily rotate 99 missingok notifempty dateext dateformat -%Y-%m-%d compress delaycompress copytruncate } /var/log/php-fpm/*.log { daily rotate 99 missingok notifempty dateext dateformat -%Y-%m-%d compress delaycompress copytruncate } # 验证配置文件语法是否正确: logrotate -d /etc/logrotate.d/php-fpm-log # 手动触发一次日志轮转(可选): # 按正常条件轮转(即:仅在满足配置条件时才执行) logrotate /etc/logrotate.d/php-fpm-log # 强制轮转(即:无论是否满足条件都立即执行) logrotate -f /etc/logrotate.d/php-fpm-log |
每一项含义
| 配置 | 含义 |
| daily | 每天轮转 |
| rotate 99 | 保留 99 份 |
| compress | 压缩旧日志 |
| delaycompress | 延迟一轮再压缩 |
| copytruncate | 不中断 php-fpm |
| create | 自动创建新日志 |
| missingok | 文件不存在不报错 |
| notifempty | 空文件不轮转 |
八、创建 PHP 7.4 systemd 服务
8.1 新建服务
|
1 |
vim /etc/systemd/system/php-fpm-7.4-CVE-2026-109618-109619.service |
添加以下内容
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 |
[Unit] Description=The PHP 7.4 FastCGI Process Manager After=network.target #[Service] #Type=simple #ExecStart=/usr/local/lib/php/7.4-CVE-2026-109618-109619/sbin/php-fpm -y /usr/local/lib/php/7.4-CVE-2026-109618-109619/etc/php-fpm.conf #ExecReload=/bin/kill -USR2 $MAINPID #PIDFile=/usr/local/lib/php/7.4-CVE-2026-109618-109619/var/run/php-fpm.pid #Environment=PHPRC=/usr/local/lib/php/7.4-CVE-2026-109618-109619/etc #Restart=always #RestartSec=3 [Service] Type=simple ExecStart=/usr/local/lib/php/7.4-CVE-2026-109618-109619/sbin/php-fpm --nodaemonize --fpm-config /usr/local/lib/php/7.4-CVE-2026-109618-109619/etc/php-fpm.conf ExecReload=/bin/kill -USR2 $MAINPID PIDFile=/usr/local/lib/php/7.4-CVE-2026-109618-109619/var/run/php-fpm.pid Restart=always RestartSec=3 # 如果是达梦数据库的话 需要用下面的Service # /home/dmdba/dmdbms 达梦的安装目录 #[Service] #Type=simple #User=root #Group=root #WorkingDirectory=/root #Environment="DM_HOME=/home/dmdba/dmdbms" #Environment="LD_LIBRARY_PATH=/home/dmdba/dmdbms/bin:/home/dmdba/dmdbms/lib:/usr/local/lib" #Environment="PHPRC=/usr/local/lib/php/7.4-CVE-2026-109618-109619/etc" #Environment="HOME=/root" #Environment="PATH=/home/dmdba/dmdbms/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin" #ExecStart=/usr/local/lib/php/7.4-CVE-2026-109618-109619/sbin/php-fpm --nodaemonize --fpm-config /usr/local/lib/php/7.4-CVE-2026-109618-109619/etc/php-fpm.conf #ExecReload=/bin/kill -USR2 $MAINPID #Restart=on-failure #RestartSec=3 [Install] WantedBy=multi-user.target |
8.2 重新加载 systemd 配置,使新服务生效:
|
1 |
systemctl daemon-reload |
8.3 启动并启用服务
|
1 |
systemctl start php-fpm-7.4-CVE-2026-109618-109619.service |
8.4 设置服务为开机自启动:
|
1 |
systemctl enable php-fpm-7.4-CVE-2026-109618-109619.service |
8.5 管理服务
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
# 启动服务 systemctl start php-fpm-7.4-CVE-2026-109618-109619.service # 停止服务 systemctl stop php-fpm-7.4-CVE-2026-109618-109619.service # 重启服务 systemctl restart php-fpm-7.4-CVE-2026-109618-109619.service # 查看服务状态 systemctl status php-fpm-7.4-CVE-2026-109618-109619.service # 禁用开机自启动 systemctl disable php-fpm-7.4-CVE-2026-109618-109619.service # 查看服务是否开机启动 # 返回 enabled 是开机启动状态 返回 disable 是开机不启动 systemctl is-enabled php-fpm-7.4-CVE-2026-109618-109619.service |
8.6 查看日志:
|
1 |
journalctl -u php-fpm-7.4-CVE-2026-109618-109619.service -n 100 --no-pager |
8.7 检查监听:
|
1 |
ss -lntp | grep -E '9000|9001' |
九、Apache 切换及 旧PHP 清理
9.1 修改 Apache
查找原 PHP-FPM 配置:
|
1 |
grep -RnE '127\.0\.0\.1:9000|proxy:fcgi|SetHandler|ProxyPassMatch' /etc/httpd /etc/apache2 /usr/local/lib/apache2/conf 2>/dev/null |
原配置示例:
|
1 2 3 |
<FilesMatch "\.php$"> SetHandler "proxy:fcgi://127.0.0.1:9000" </FilesMatch> |
改为:
|
1 2 3 |
<FilesMatch "\.php$"> SetHandler "proxy:fcgi://127.0.0.1:9001" </FilesMatch> |
如果现场使用 Unix Socket,应按照实际配置修改。
测试 Apache:
|
1 |
apachectl -t |
无错误后重载(服务名称以实际为准):
|
1 |
systemctl reload apache2.service |
源码编译 Apache 应使用对应的 apachectl -k graceful 或现场 systemd 服务。
9.2 停止 PHP 7.3 服务
确认 PHP 7.4 正常后:
|
1 2 |
systemctl stop php-fpm-7.3.service systemctl disable php-fpm-7.3.service |
查看旧服务路径:
|
1 |
systemctl show -p FragmentPath php-fpm-7.3.service |
如果确认是自己创建的 systemd 服务文件,可以备份后移除:
|
1 |
mv /etc/systemd/system/php-fpm-7.3.service /root/php-upgrade-backup/ |
刷新:
|
1 2 |
systemctl daemon-reload systemctl reset-failed |
不要立即删除旧 PHP 安装目录。
9.3 回滚方案
若 PHP 7.4 导致业务异常:
- 恢复 PHP 7.3 的 systemd 服务文件(如已移走)。
- 将 Apache PHP-FPM 转发地址改回原来的 9000。
- 检查 Apache 配置。
- 启动旧 PHP 7.3。
- 重载 Apache 并重新验证 。
参考命令:
|
1 2 3 4 5 6 |
systemctl daemon-reload systemctl enable --now php-fpm-7.3.service apachectl -t systemctl reload apache2.service |
实际操作时以现场的 Apache 服务名及原 PHP-FPM 端口为准。
十、常见问题及处理
本章节集中记录 PHP 7.4 编译、安装及运行过程中遇到的故障,后续可以持续添加新的问题。
10.1 缺少 configure 文件
报错:
|
1 |
-bash: ./configure: 没有那个文件或目录 |
原因: GitHub 下载的 PHP 源码需要生成 configure。
处理:
|
1 2 3 |
cd /usr/local/src/php-7.4-fixed ./buildconf --force ls -lh configure |
10.2 缺少 re2c
报错:
|
1 2 |
checking for re2c... no configure: error: re2c 0.13.4 is required |
原因: 服务器缺少 re2c 编译工具。
处理:
优先:
|
1 |
yum install re2c |
如果软件源没有,源码安装。
下载地址:
|
1 2 3 4 5 6 7 8 |
cd /usr/local/src wget https://github.com/skvadrik/re2c/releases/download/3.1/re2c-3.1.tar.xz tar -xJf re2c-3.1.tar.xz cd re2c-3.1 ./configure --prefix=/usr/local make -j4 make install |
验证:
|
1 |
/usr/local/bin/re2c --version |
必要时:
|
1 |
export PATH=/usr/local/bin:$PATH |
安装后返回 PHP 源码目录,重新配置 PHP。
10.3 缺少 Oniguruma
报错:
|
1 2 |
configure: error: Package requirements (oniguruma) were not met |
原因: PHP 7.4 的 mbstring 扩展需要 Oniguruma 开发库。
处理方式一:yum 安装
|
1 |
yum install oniguruma oniguruma-devel |
验证:
|
1 |
pkg-config --modversion oniguruma |
处理方式二:源码安装
|
1 2 3 4 5 6 7 8 |
cd /usr/local/src wget https://github.com/kkos/oniguruma/releases/download/v6.9.10/onig-6.9.10.tar.gz tar -xzf onig-6.9.10.tar.gz cd onig-6.9.10 ./configure --prefix=/usr/local/oniguruma make -j4 make install |
设置路径:
|
1 |
export PKG_CONFIG_PATH=/usr/local/oniguruma/lib/pkgconfig:${PKG_CONFIG_PATH:-} |
验证:
|
1 |
pkg-config --modversion oniguruma |
如果运行时找不到动态库,检查实际安装路径:
|
1 |
find /usr/local/oniguruma -name 'libonig.so*' |
如果库位于 /usr/local/oniguruma/lib,可以配置:
|
1 2 3 |
echo /usr/local/oniguruma/lib > /etc/ld.so.conf.d/oniguruma.conf ldconfig |
实际为 lib64 时,需要调整路径。