网站备案号:蜀ICP备2026035467号-3

重启php服务|专业PHP服务重启指南

覆盖全平台、全环境、全框架的PHP服务重启技术方案,含命令详解、故障排查、配置调优与实战案例

PHP服务重启基础认知

什么是PHP服务?

PHP服务并非单一进程,而是一组协同工作的服务组件集合。在Web场景中,主要包含:

  • PHP-FPM:FastCGI进程管理器,负责处理PHP脚本执行请求
  • php-cgi:独立CGI进程,用于传统CGI模式
  • Apache mod_php:以Apache模块方式运行PHP
  • Swoole进程池:常驻内存应用中的PHP协程服务
  • PHP CLI守护进程:如队列消费者、定时任务

不同部署架构下,“重启PHP服务”所指代的具体对象存在显著差异,需根据实际环境精准操作。

为何需要重启PHP服务?

重启服务并非“万能药”,而是在特定场景下恢复服务稳定性的关键操作:

  • 配置变更生效:修改php.ini、php-fpm.conf后必须重启才能加载新配置
  • 内存泄漏修复:长期运行的服务可能积累未释放内存,重启可释放资源
  • 代码热更新:部署新版本代码后需重启以加载最新opcode
  • 扩展更新:安装/升级PHP扩展(如Redis、OPcache)后需重启服务
  • 进程异常:FPM主进程僵死、worker进程崩溃等异常状态

需注意:频繁重启可能掩盖根本问题(如配置错误、代码缺陷),应结合日志分析定位根因。

重启方式分类

根据服务类型与运行模式,重启可分为以下类别:

类别 重启方式 适用场景 影响范围
平滑重启 reload(平滑重载) 配置变更、代码热更新 仅worker进程重启,主进程不中断
强制重启 restart(完全重启) 服务崩溃、内存溢出 主进程与worker进程全部重启
进程级操作 kill -USR2(平滑重启主进程) 主进程异常但需保持连接 仅主进程重启,worker继承
服务管理 systemctl restart php-fpm 系统服务管理(主流Linux) 完整服务生命周期重置

推荐优先使用平滑重启方式(reload),减少对用户请求的影响。

Linux系统重启方案

CentOS 7+/RHEL 7+(systemd管理)

主流版本采用systemd服务管理器,操作方式如下:

# 查看服务状态
systemctl status php-fpm

# 平滑重载配置
systemctl reload php-fpm

# 完全重启服务
systemctl restart php-fpm

# 设置开机自启
systemctl enable php-fpm

注意:服务名可能为php74-fpm、php81-fpm等版本化命名,需根据实际安装版本确认。

CentOS 6(init.d管理)

旧版系统使用SysVinit,操作方式如下:

# 启动服务
service php-fpm start

# 重启服务
service php-fpm restart

# 平滑重载
service php-fpm reload

服务脚本位于/etc/init.d/php-fpm,若缺失需通过源码编译或包管理器重装。

Ubuntu 16.04+/Debian 9+(systemd)

与CentOS 7+基本一致,服务名可能不同:

# 查看可用服务
systemctl list-units --type=service | grep php

# 重启PHP 8.1 FPM
systemctl restart php8.1-fpm

# 平滑重载
systemctl reload php8.1-fpm

常用版本号映射:
• PHP 7.4 → php7.4-fpm
• PHP 8.0 → php8.0-fpm
• PHP 8.1 → php8.1-fpm

Ubuntu 14.04(Upstart)

早期Ubuntu使用Upstart,命令如下:

# 重启服务
sudo restart php-fpm

# 停止服务
sudo stop php-fpm

建议升级至Ubuntu 16.04+以获得systemd支持与长期安全更新。

手动重启方式(不依赖服务管理器)

当服务脚本损坏或需紧急操作时,可直接操作进程:

# 1. 查找php-fpm主进程PID
pgrep -f php-fpm
# 输出示例:12345(主进程PID)

# 2. 平滑重启主进程(不中断连接)
kill -USR2 12345

# 3. 强制重启(先杀worker再杀master)
kill -TERM 12345
# 等待worker退出后重启
/usr/sbin/php-fpm

⚠️ 警告:直接操作进程需确保PID准确,误操作可能导致服务中断。建议优先使用systemctl/service命令。

环境变量与路径问题

手动重启时常见问题:命令未找到(command not found)

# 解决方案:检查PATH或使用绝对路径
which php-fpm
# 输出:/usr/sbin/php-fpm

# 使用绝对路径重启
/usr/sbin/php-fpm -y /etc/php-fpm.conf

生产环境建议将PHP二进制路径加入系统PATH:

# 编辑/etc/profile.d/php.sh
export PATH=$PATH:/usr/sbin:/usr/bin

Windows系统重启方案

IIS集成PHP(FastCGI模式)

Windows下IIS通过FastCGI扩展管理PHP,重启方式如下:

# 1. 重启IIS服务(影响所有站点)
iisreset /restart

# 2. 仅重启FastCGI进程
appcmd recycle apppool /apppool.name:DefaultAppPool

若使用非默认应用池,需替换为实际名称(如PHPAppPool)。

配置验证与日志查看

IIS日志路径:
C:\inetpub\logs\LogFiles\W3SVC1

PHP错误日志路径(php.ini中指定):

error_log = C:\php\logs\php_errors.log

重启后建议检查:

  • 事件查看器(eventvwr.msc)→ Windows日志→应用
  • FastCGI配置是否正确加载
  • PHP扩展是否正常加载

Nginx+PHP-CGI(Windows环境)

常见组合:Nginx for Windows + PHP-CGI,需分别管理服务:

# 1. 重启Nginx
nginx -s reload

# 2. 重启PHP-CGI(需提前注册为服务)
net stop php-cgi
net start php-cgi

若未注册服务,可通过任务管理器结束php-cgi.exe进程后重新启动:

start /b C:\php\php-cgi.exe -b 127.0.0.1:9000

建议使用NSSM(Non-Sucking Service Manager)将PHP-CGI注册为Windows服务:

nssm install PHP-CGI C:\php\php-cgi.exe nssm set PHP-CGI AppParameters "-b 127.0.0.1:9000"

命令行快速重启(PowerShell)

PowerShell提供更灵活的服务管理方式:

# 查看PHP相关服务
Get-Service | Where-Object {$_.DisplayName -like "*PHP*"}

# 重启服务(需管理员权限)
Restart-Service -Name "php-fpm" -Force

# 重启IIS应用池
Import-Module WebAdministration
Restart-WebAppPool -Name "DefaultAppPool"

提示:首次使用PowerShell管理IIS需安装WebAdministration模块。

Docker容器环境重启方案

Docker Compose部署(php-fpm容器)

典型docker-compose.yml配置:

services:
  php:
    image: php:8.1-fpm-alpine
    volumes:
      - ./src:/var/www/html

# 重启容器
docker-compose restart php

# 平滑重载(需容器内支持)
docker-compose exec php php-fpm -t && php-fpm -y /usr/local/etc/php-fpm.conf -R

注意:Alpine镜像中php-fpm配置路径为/usr/local/etc/php-fpm.conf。

挂载配置文件的热更新

推荐将php.ini与php-fpm.conf挂载为卷,实现配置热更新:

services:
  php:
    volumes:
      - ./config/php.ini:/usr/local/etc/php/php.ini
      - ./config/php-fpm.conf:/usr/local/etc/php-fpm.conf

修改配置后,可通过以下方式生效:

# 1. 发送HUP信号到主进程
docker kill -s HUP container_name

# 2. 容器内执行reload
docker exec container_name php-fpm -t && kill -USR2 $(cat /run/php-fpm/php-fpm.pid)

Kubernetes部署(StatefulSet)

典型部署配置:

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: php-fpm
spec:
  replicas: 3
  template:
    spec:
      containers:
        - name: php
          image: php:8.1-fpm

重启方式:

# 滚动重启Pod(逐个重启)
kubectl rollout restart statefulset/php-fpm

# 强制重建Pod
kubectl delete pod -l app=php-fpm

建议配合 readinessProbe 确保服务可用性:

readinessProbe:
  exec:
    command: ["php-fpm", "-t"]
  initialDelaySeconds: 5
  periodSeconds: 10

容器内直接重启服务

进入容器执行重启操作:

# 进入容器
docker exec -it container_name sh

# 平滑重载
php-fpm -t && kill -USR2 $(cat /run/php-fpm/php-fpm.pid)

# 完全重启
pkill php-fpm
php-fpm

注意:容器内重启不会影响宿主机,但可能中断当前请求处理,建议在业务低峰期操作。

Nginx环境下的PHP服务重启

Nginx与PHP-FPM协作机制

Nginx作为反向代理,将PHP请求转发至PHP-FPM监听端口(如127.0.0.1:9000),二者独立运行。

重启PHP-FPM后,需确保Nginx配置的upstream地址正确:

location ~ \.php$ {
  fastcgi_pass 127.0.0.1:9000;
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  include fastcgi_params;
}

常见问题:重启PHP-FPM后Nginx返回502 Bad Gateway

  • 检查PHP-FPM是否监听正确端口(netstat -tuln | grep 9000)
  • 检查SELinux是否阻止连接(setsebool -P httpd_can_network_connect 1)
  • 检查防火墙规则(firewall-cmd --list-all)

平滑重启Nginx与PHP-FPM

推荐顺序:先重启PHP-FPM,再重载Nginx

# 1. 重启PHP-FPM
systemctl reload php-fpm

# 2. 重载Nginx配置
nginx -s reload

若Nginx与PHP-FPM在同一服务器,可合并操作:

systemctl reload php-fpm && nginx -s reload

Nginx+PHP-CGI配置

PHP-CGI作为独立进程,需手动管理生命周期:

# 启动PHP-CGI
php-cgi -b 127.0.0.1:9000 &

# 重启脚本(需先停止旧进程)
pkill php-cgi
sleep 1
php-cgi -b 127.0.0.1:9000 &

建议使用supervisord管理PHP-CGI进程:

[program:php-cgi]
command=/usr/bin/php-cgi -b 127.0.0.1:9000
autostart=true
autorestart=true

Nginx配置热更新检查

重载Nginx前必须验证配置语法:

nginx -t
# 输出:nginx: configuration file /etc/nginx/nginx.conf test is successful

若输出错误,需定位具体行号:

nginx -t 2>&1 | grep -A2 "configuration file"

Apache环境下的PHP服务重启

Apache mod_php模式

PHP以Apache模块方式运行,无需单独重启PHP服务,重启Apache即生效:

# 重启Apache
systemctl restart httpd

# 重载配置(不中断连接)
systemctl reload httpd

mod_php配置示例(/etc/httpd/conf.d/php.conf):

<IfModule prefork.c>
  LoadModule php_module modules/libphp.so
</IfModule>

适用场景:单机部署、低并发环境

缺点:内存占用高、无法隔离用户权限

性能调优建议

优化Apache prefork MPM配置(/etc/httpd/conf/httpd.conf):

<IfModule mpm_prefork_module>
  StartServers 5
  MinSpareServers 5
  MaxSpareServers 10
  MaxRequestWorkers 150
  MaxConnectionsPerChild 1000
</IfModule>

重启后验证配置:

apachectl -t
systemctl status httpd

Apache+PHP-FPM(ProxyPassMatch)

现代Apache推荐使用PHP-FPM代理模式:

# 启用代理模块
LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_fcgi_module modules/mod_proxy_fcgi.so

# 配置PHP代理
<FilesMatch \\.php$>
  SetHandler "proxy:fcgi://127.0.0.1:9000"
</FilesMatch>

重启命令:systemctl restart httpd

混合模式对比

特性 mod_php PHP-FPM
性能 高(无额外进程) 中(需FastCGI通信)
内存占用 高(每个Apache进程加载PHP) 低(独立FPM进程池)
隔离性 差(所有用户共享) 好(可按用户配置池)
配置复杂度 低 中

Apache配置热更新

重载配置前验证语法:

apachectl configtest
# 或
httpd -t

常见错误及修复:

  • Invalid command 'php_admin_value':未加载php模块
  • Permission denied:SELinux阻止访问(setsebool -P httpd_can_network_connect 1)
  • File does not exist:DocumentRoot路径错误

PHP-FPM深度配置与重启

核心配置项说明

php-fpm.conf关键配置:

[global]
pid = /run/php-fpm/php-fpm.pid
error_log = /var/log/php-fpm/error.log
log_level = notice
emergency_restart_threshold = 10
emergency_restart_interval = 1m
process_control_timeout = 10s
daemonize = yes

参数详解:

  • emergency_restart_threshold:在emergency_restart_interval内,若子进程异常退出数超过此值,则触发平滑重启
  • process_control_timeout:子进程接收信号的超时时间,避免卡死

进程池配置示例

池配置位于/etc/php-fpm.d/www.conf:

[www]
user = nginx
group = nginx
listen = 127.0.0.1:9000
listen.allowed_clients = 127.0.0.1
pm = dynamic
pm.max_children = 50
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 35
pm.max_requests = 500
request_terminate_timeout = 60s
request_slowlog_timeout = 10s
slowlog = /var/log/php-fpm/slow.log

pm模式对比:

  • static:固定子进程数,适合高负载稳定环境
  • dynamic:动态调整子进程数,适合波动负载
  • ondemand:按需启动,适合低流量环境

多进程池管理

为不同站点创建独立池(/etc/php-fpm.d/site1.conf):

[site1]
listen = /run/php-fpm/site1.sock
pm = dynamic
pm.max_children = 20

[site2]
listen = /run/php-fpm/site2.sock
pm = ondemand
pm.max_children = 10

重启后验证池状态:

systemctl status php-fpm
# 查看所有池的活动进程
ps aux | grep php-fpm

平滑重载多池配置

重载时仅重启指定池的worker:

# 1. 重启所有池
systemctl reload php-fpm

# 2. 手动重载单池
kill -USR2 $(cat /run/php-fpm/php-fpm.pid)

注意:/run/php-fpm/php-fpm.pid仅主进程PID,需结合pool配置获取各池master PID。

调试技巧

启用详细日志定位问题:

# 编辑php-fpm.conf
log_level = debug

# 重启服务
systemctl restart php-fpm

# 实时查看日志
tail -f /var/log/php-fpm/error.log

常见日志问题:

  • ERROR: unable to bind listening socket:端口被占用
  • ERROR: failed to open configuration file:配置文件路径错误
  • ERROR: unable to set php.ini:PHP配置路径错误

性能监控

启用状态页(/etc/php-fpm.d/www.conf):

[www]
pm.status_path = /status
ping.path = /ping
ping.response = pong

配置Nginx代理状态页:

location /fpm-status {
  fastcgi_pass 127.0.0.1:9000;
  include fastcgi_params;
  fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

访问:http://example.com/fpm-status?json 获取JSON格式状态

重启失败排查指南

常见错误代码解析

# 重启命令示例
systemctl restart php-fpm

# 查看错误输出
systemctl status php-fpm -l

典型错误:

  • Job for php-fpm.service failed:配置语法错误或权限问题
  • Failed at step EXEC spawning:二进制文件缺失或权限不足
  • Address already in use:端口被占用(检查netstat -tuln | grep 9000)

权限问题排查

检查文件权限:

ls -l /etc/php-fpm.conf
ls -l /etc/php-fpm.d/

修复权限(示例):

chown root:root /etc/php-fpm.conf
chmod 644 /etc/php-fpm.conf
chown nginx:nginx /var/lib/php/session
chmod 700 /var/lib/php/session

注意:www-data用户需对session目录有读写权限。

端口占用检测

检查端口占用情况:

# 查看9000端口占用
netstat -tuln | grep :9000
# 或
ss -tuln | grep :9000

若端口被占用,终止进程:

lsof -i :9000
kill -9 PID

推荐使用Unix Socket替代TCP端口避免端口冲突:

listen = /run/php-fpm/php-fpm.sock
listen.mode = 0660

SELinux与防火墙限制

SELinux阻止连接:

# 检查SELinux状态
getenforce

# 允许HTTP连接
setsebool -P httpd_can_network_connect 1

防火墙规则:

firewall-cmd --list-all
firewall-cmd --add-port=9000/tcp --permanent
firewall-cmd --reload

日志文件位置

PHP-FPM日志路径(/etc/php-fpm.conf):

error_log = /var/log/php-fpm/error.log
access.log = /var/log/php-fpm/access.log

PHP错误日志(/etc/php.ini):

error_log = /var/log/php/php_errors.log

实时监控日志:

tail -f /var/log/php-fpm/error.log /var/log/php/php_errors.log

日志关键字解析

错误日志示例:

[2023-10-05 14:23:18] [pool www] child 12345 exited on signal 11 (SIGSEGV) after 123.4567 seconds from start
[2023-10-05 14:23:18] [pool www] child 12346 started

关键信息:

  • signal 11:段错误(内存访问违规),常见于扩展缺陷
  • exited on signal 9:被强制终止(OOM Killer)
  • max_requests exceeded:子进程处理请求数超限

主流框架服务重启方案

Laravel队列服务重启

Laravel队列依赖Supervisor管理进程:

[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/artisan queue:work redis --sleep=3 --tries=3
autostart=true
autorestart=true
numprocs=8

重启队列进程:

# 重启Supervisor管理的队列
supervisorctl reread
supervisorctl update
supervisorctl restart laravel-worker:*

注意:修改代码后需重启队列进程以加载新代码。

Laravel服务缓存刷新

部署后清除缓存:

php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear

若使用OPcache,需额外刷新:

php artisan opcache:clear

建议集成到部署脚本中:

# deploy.sh
git pull origin main
composer install --optimize-autoloader --no-dev
php artisan migrate --force
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan opcache:clear
supervisorctl restart laravel-worker:*

ThinkPHP 6服务管理

TP6支持常驻内存模式(swoole):

# 启动服务
php think run -H 0.0.0.0 -p 9501

# 平滑重启(Swoole特有)
php think reload

传统模式(非Swoole)需重启PHP-FPM:

systemctl reload php-fpm

注意:TP6的Swoole服务重启需在swoole_server启动后执行reload命令。

ThinkPHP 5任务队列

ThinkPHP 5使用Workerman或Swoole实现队列:

# 启动队列
php think worker:start

# 重启队列(需先停止)
php think worker:stop
php think worker:start

推荐使用Supervisor管理:

[program:tp5-worker]
command=php /var/www/think worker:start
autostart=true
autorestart=true

Yii 2队列管理

Yii 2使用yii2-queue扩展:

[program:yii-queue]
command=php /var/www/yii queue/run
autostart=true
autorestart=true

重启命令:

supervisorctl restart yii-queue

若使用数据库队列,需确保数据库连接配置正确。

OPcache缓存刷新方案

OPcache核心配置

php.ini关键配置:

[opcache]
opcache.enable=1
opcache.enable_cli=0
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=4000
opcache.validate_timestamps=1
opcache.revalidate_freq=60
opcache.fast_shutdown=1

参数说明:

  • validate_timestamps:是否检查脚本时间戳(开发环境建议设为1)
  • revalidate_freq:检查频率(秒),0表示每次请求都检查
  • memory_consumption:OPcache内存大小(MB)

开发与生产环境配置对比

配置项 开发环境 生产环境
opcache.enable 1 1
opcache.validate_timestamps 1 0
opcache.revalidate_freq 2 0
opcache.max_accelerated_files 2000 10000

生产环境关闭时间戳检查可提升性能,但需在部署后手动刷新OPcache。

手动刷新OPcache

方式一:重启PHP-FPM(最通用)

systemctl reload php-fpm

方式二:使用PHP脚本刷新

<?php
opcache_reset();
echo "OPcache cleared";

方式三:命令行刷新(PHP 7.4+)

php -r "opcache_reset();"

方式四:Nginx代理刷新(需配置)

location /opcache-clear {
  fastcgi_pass 127.0.0.1:9000;
  fastcgi_param SCRIPT_FILENAME /var/www/opcache-clear.php;
  include fastcgi_params;
}

框架集成OPcache刷新

Laravel(laravel-opcache包):

php artisan opcache:clear

ThinkPHP 6:

php think opcache:clear

自定义刷新脚本(/usr/local/bin/opcache-flush):

#!/bin/bash
curl -s http://localhost/opcache-clear.php > /dev/null
echo "OPcache cleared at $(date)"

状态监控

创建状态页(opcache-status.php):

<?php
header('Content-Type: text/plain');
print_r(opcache_get_status());

访问:http://localhost/opcache-status.php

关键指标:

  • used_memory:当前使用内存(MB)
  • free_memory:可用内存
  • num_cached_scripts:缓存脚本数
  • opcache_hit_rate:缓存命中率(应>95%)

自动监控告警

使用Zabbix监控OPcache状态:

UserParameter=opcache.hit_rate,curl -s http://localhost/opcache-status.php | grep -o '"opcache_hit_rate":[0-9.]*' | cut -d: -f2

创建告警规则:当缓存命中率低于90%时触发通知。

Swoole常驻内存服务重启

Swoole平滑重启原理

Swoole支持两种平滑重启方式:

# 1. 重启Worker进程(保留Master)
kill -USR2 PID

# 2. 重启所有进程(Master + Worker)
kill -TERM PID
php server.php

方式1适用于代码更新,方式2适用于配置变更。

代码示例

<?php
$server = new Swoole\Http\Server("0.0.0.0", 9501);

$server->on('WorkerStart', function($server, $workerId) {
  echo "Worker#$workerId started\n";
});

$server->on('Request', function($request, $response) {
  $response->end("Hello Swoole ".time());
});

$server->start();

启动服务后,修改代码文件,执行:

kill -USR2 $(cat server.pid)

Worker进程动态管理

动态调整Worker数量:

# 1. 增加Worker进程
kill -USR1 PID

# 2. 减少Worker进程
kill -USR2 PID

注意:需在swoole_config中设置worker_num_max参数。

Worker状态监控

通过Server->stats()获取Worker状态:

$server->on('WorkerStart', function($server, $workerId) {
  $server->stats(function($stats) use ($server, $workerId) {
    echo "Worker#$workerId: " . json_encode($stats) . "\n";
  });
});

Task进程管理

Task进程用于处理耗时任务:

$server->on('Task', function($server, $task) {
  echo "Task[$task->id] running\n";
  sleep(1);
  return "task result";
});

$server->on('Finish', function($server, $taskId, $data) {
  echo "Task[$taskId] finished: $data\n";
});

重启Task进程:

kill -TSTP PID # 暂停Task进程
kill -CONT PID # 恢复Task进程

PHP版本升级与服务兼容

版本升级步骤

1. 备份当前环境

cp -r /etc/php /etc/php.bak
cp -r /etc/php-fpm.d /etc/php-fpm.d.bak
cp /usr/bin/php /usr/bin/php.bak

2. 安装新版本PHP

# CentOS/RHEL
yum install php81-php-fpm

# Ubuntu/Debian
apt install php8.1-fpm

3. 迁移配置

diff /etc/php.bak/php.ini /etc/php/php.ini
diff /etc/php-fpm.d.bak/www.conf /etc/php-fpm.d/www.conf

配置迁移要点

常见配置差异:

  • php-fpm.conf:PHP 8.0+默认使用systemd socket activation
  • session.save_path:路径权限需重新设置
  • extension=xxx:部分扩展需单独安装(如redis、mysqli)

验证配置:

php -m
php-fpm -t

兼容性检查清单

检查项 检查命令 通过标准
扩展加载 php -m 无Missing扩展警告
配置语法 php-fpm -t Configuration OK
权限检查 ls -l /var/lib/php/session 权限与nginx/www-data匹配
端口占用 netstat -tuln | grep 9000 端口未被占用

代码兼容性测试

使用PHP Compatibility工具:

composer require --dev squizlabs/php_codesniffer
composer require --devPHPCompatibility/PHPCompatibility

vendor/bin/phpcs --standard=PHPCompatibility --runtime-set testVersion 8.0- .

重点检查废弃特性:

  • PHP 7.4 → 8.0:移除filter.default
  • PHP 8.0 → 8.1:移除json_decode的assoc参数默认值
  • PHP 8.2:移除${}字符串插值

回滚方案

1. 停止新版本服务

systemctl stop php81-fpm

2. 恢复备份配置

rm -rf /etc/php /etc/php-fpm.d
mv /etc/php.bak /etc/php
mv /etc/php-fpm.d.bak /etc/php-fpm.d

3. 启动旧版本服务

systemctl start php-fpm

4. 验证服务状态

systemctl status php-fpm
curl http://localhost/info.php

自动化重启脚本

通用重启脚本

#!/bin/bash

SERVICE_NAME="php-fpm"
CONFIG_DIR="/etc/php-fpm.d"
BACKUP_DIR="/etc/php-fpm.d.bak$(date +%Y%m%d%H%M%S)"

# 备份配置
cp -r $CONFIG_DIR $BACKUP_DIR
echo "Backup created at $BACKUP_DIR"

# 重载服务
if systemctl list-unit-files | grep -q $SERVICE_NAME; then
  systemctl reload $SERVICE_NAME
  echo "$SERVICE_NAME reloaded successfully"
else
  echo "Service $SERVICE_NAME not found"
  exit 1
fi

使用方法:chmod +x restart-php.sh && ./restart-php.sh

带回滚的部署脚本

#!/bin/bash

DEPLOY_DIR="/var/www/html"
BACKUP_DIR="/var/www/html.bak$(date +%Y%m%d%H%M%S)"
SERVICE_NAME="php-fpm"

# 1. 备份当前代码
cp -r $DEPLOY_DIR $BACKUP_DIR

# 2. 部署新代码
git pull origin main
composer install --optimize-autoloader

# 3. 清除缓存
php artisan config:clear
php artisan cache:clear

# 4. 平滑重启服务
systemctl reload $SERVICE_NAME

# 5. 验证服务
sleep 2
if curl -s http://localhost | grep -q "Hello"; then
  echo "Deployment successful"
else
  echo "Deployment failed, rolling back..."
  rm -rf $DEPLOY_DIR
  mv $BACKUP_DIR $DEPLOY_DIR
  systemctl restart $SERVICE_NAME
  exit 1
fi

Ansible自动化部署

---
- hosts: php_servers
  become: yes
  tasks:
    - name: Backup current config
      copy:
        src: /etc/php-fpm.d/
        dest: /etc/php-fpm.d.bak
        remote_src: yes
        backup: yes

    - name: Deploy new code
      git:
        repo: git@github.com:company/app.git
        dest: /var/www/html
        version: main

    - name: Install dependencies
      composer:
        working_dir: /var/www/html
        optimize_autoloader: yes

    - name: Reload PHP-FPM
      service:
        name: php-fpm
        state: reloaded

运行:ansible-playbook deploy.yml

GitLab CI/CD集成

deploy:
  stage: deploy
  script:
    - echo "Deploying application..."
    - ssh user@server "cd /var/www/html && git pull origin main"
    - ssh user@server "cd /var/www/html && composer install --optimize-autoloader"
    - ssh user@server "cd /var/www/html && php artisan config:clear"
    - ssh user@server "systemctl reload php-fpm"
  only:
    - main

注意:需配置SSH密钥实现免密登录。

网友常见问题解答

Q1:重启PHP服务后网站仍无法访问,怎么办?

请按以下步骤排查:

  • 检查Nginx/Apache是否正常运行:systemctl status nginx/httpd
  • 检查PHP-FPM是否监听正确端口:netstat -tuln | grep 9000
  • 查看Nginx错误日志:/var/log/nginx/error.log
  • 检查SELinux状态:getenforce
  • 验证PHP配置:php -m | grep -i mysqli

Q2:平滑重启后旧代码仍被缓存,如何彻底清除?

可能原因及解决方案:

  • OPcache缓存:执行opcache_reset()或重启PHP-FPM
  • APC缓存:重启Apache
  • 文件系统缓存:清除/var/cache目录
  • CDN缓存:刷新CDN缓存

Q3:PHP-FPM重启后Worker进程数不变,如何强制调整?

检查配置文件中的pm参数:

pm = dynamic
pm.max_children = 100
pm.start_servers = 20
pm.min_spare_servers = 10
pm.max_spare_servers = 30

修改后重启服务:

systemctl restart php-fpm

验证进程数:

ps aux | grep php-fpm | grep -v grep | wc -l

Q4:Docker容器内重启PHP-FPM后容器退出,如何解决?

原因:容器主进程为PHP-FPM,重启后主进程退出导致容器终止。

解决方案:

# 方案1:使用supervisord管理PHP-FPM
FROM php:8.1-fpm
RUN apt-get update && apt-get install -y supervisor
COPY supervisord.conf /etc/supervisor/supervisord.conf
CMD ["supervisord", "-c", "/etc/supervisor/supervisord.conf"]

supervisord.conf:

[program:php-fpm]
command=/usr/local/sbin/php-fpm
autorestart=true

Q5:PHP 8.0升级后旧项目报错,如何快速回退?

回滚步骤:

  1. 停止新版本服务:systemctl stop php80-fpm
  2. 恢复旧版本二进制文件:cp /usr/bin/php.bak /usr/bin/php
  3. 恢复配置文件:cp -r /etc/php.bak/* /etc/php/
  4. 启动旧版本服务:systemctl start php-fpm
  5. 验证版本:php -v

建议:升级前使用docker容器隔离测试环境。

扩展阅读

相关技术栈

  • Composer:PHP依赖管理,重启服务前需执行composer dump-autoload
  • Redis:常用于PHP Session存储,检查redis-server服务状态
  • MySQL:确保数据库连接池配置与PHP-FPM Worker数匹配
  • Nginx:配置upstream时注意keepalive连接数
  • Supervisor:管理长期运行的PHP进程(如队列消费者)

性能调优建议

  • 根据服务器CPU核心数设置worker_num(Swoole)或pm.max_children(FPM)
  • 启用OPcache并合理设置memory_consumption(建议128-256MB)
  • 使用Unix Socket替代TCP端口减少网络开销
  • 配置request_terminate_timeout防止脚本无限执行
  • 定期监控opcache_hit_rate,低于95%需优化