php-fpm.conf
process_control_timeout 里面有这个参数,默认是0,这个参数跟reload有极大关系
php-fpm reload 简介
php-fpm 通过接受用户发送的SIGUSR2信号实现自身服务的reload
kill -USR2 `cat /tmp/php-fpm.pid`
以下代码均来自 php-src-PHP-7.1.0 版本
主进程信号处理
主进程收到reload信号调用信号回掉函数:
fpm/fpm_signals.c
static void sig_handler(int signo) /* {{{ */
{
static const char sig_chars[NSIG + 1] = {
[SIGTERM] = 'T',
[SIGINT] = 'I',
[SIGUSR1] = '1',
[SIGUSR2] = '2',
[SIGQUIT] = 'Q',
[SIGCHLD] = 'C'
};
char s;
int saved_errno;
if (fpm_globals.parent_pid != getpid()) {
/* prevent a signal race condition when child process
have not set up it's own signal handler yet */
return;
}
saved_errno = errno;
s = sig_chars[signo];
write(sp[1], &s, sizeof(s));
errno = saved_errno;
}
信号处理函数的主要作用是向套接字 sp[1] 中写入信号 2 。在sp[0]上注册了事件回掉函数fpm_got_signal
fpm/fpm_events.c
函数fpm_got_signal 从sp[0] 读取信号值,执行相应的操作
case '2' : /* SIGUSR2 */
zlog(ZLOG_DEBUG, "received SIGUSR2");
zlog(ZLOG_NOTICE, "Reloading in progress ...");
//下面这掉语句进行重启操纵
fpm_pctl(FPM_PCTL_STATE_RELOADING, FPM_PCTL_ACTION_SET);
break;
fpm/fpm_process_ctl.c
void fpm_pctl(int new_state, int action) /* {{{ */
{
switch (action) {
case FPM_PCTL_ACTION_SET :
if (fpm_state == new_state) { /* already in progress - just ignore duplicate signal */
return;
}
switch (fpm_state) { /* check which states can be overridden */
case FPM_PCTL_STATE_NORMAL :
/* 'normal' can be overridden by any other state */
break;
case FPM_PCTL_STATE_RELOADING :
/* 'reloading' can be overridden by 'finishing' */
if (new_state == FPM_PCTL_STATE_FINISHING) break;
case FPM_PCTL_STATE_FINISHING :
/* 'reloading' and 'finishing' can be overridden by 'terminating' */
if (new_state == FPM_PCTL_STATE_TERMINATING) break;
case FPM_PCTL_STATE_TERMINATING :
/* nothing can override 'terminating' state */
zlog(ZLOG_DEBUG, "not switching to '%s' state, because already in '%s' state",
fpm_state_names[new_state], fpm_state_names[fpm_state]);
return;
}
fpm_signal_sent = 0;
fpm_state = new_state;
zlog(ZLOG_DEBUG, "switching to '%s' state", fpm_state_names[fpm_state]);
/* fall down */
case FPM_PCTL_ACTION_TIMEOUT :
fpm_pctl_action_next();
break;
case FPM_PCTL_ACTION_LAST_CHILD_EXITED :
fpm_pctl_action_last();
break;
}
}
case FPM_PCTL_ACTION_SET 没有break,所以会接着向下执行
case FPM_PCTL_ACTION_TIMEOUT:
//下面这个函数会向所有的子进程发送结束信号
fpm_pctl_action_next();
fpm_pctl_action_next 函数实现:
static void fpm_pctl_action_next() /* {{{ */
{
int sig, timeout;
if (!fpm_globals.running_children) {
fpm_pctl_action_last();
}
if (fpm_signal_sent == 0) {
if (fpm_state == FPM_PCTL_STATE_TERMINATING) {
sig = SIGTERM;
} else {
sig = SIGQUIT;
}
timeout = fpm_global_config.process_control_timeout;
} else {
if (fpm_signal_sent == SIGQUIT) {
sig = SIGTERM;
} else {
sig = SIGKILL;
}
timeout = 1;
}
fpm_pctl_kill_all(sig);
fpm_signal_sent = sig;
//设置定时器
fpm_pctl_timeout_set(timeout);
}
第一次向子进程发送 SIGQUIT ,同时注册定时器时间,timeout的值为'fpm_global_config.process_control_timeout'。在规定时间之内子进程还没有结束,则再向子进程发送SIGTERM信号,再次设置定时器,timeout 值设为1秒。如果在1秒之内还没有结束,则直接向子进程发送SIGKILL信号,强制杀死。
子进程信号处理
子进程只对SIGQUIT 信号做了捕获,其他信号使用默认处理方式
fpm/fpm_signals.c
int fpm_signals_init_child() /* {{{ */
{
struct sigaction act, act_dfl;
memset(&act, 0, sizeof(act));
memset(&act_dfl, 0, sizeof(act_dfl));
act.sa_handler = &sig_soft_quit;
act.sa_flags |= SA_RESTART;
act_dfl.sa_handler = SIG_DFL;//默认信号处理程序
close(sp[0]);
close(sp[1]);
if (0 > sigaction(SIGTERM, &act_dfl, 0) ||
0 > sigaction(SIGINT, &act_dfl, 0) ||
0 > sigaction(SIGUSR1, &act_dfl, 0) ||
0 > sigaction(SIGUSR2, &act_dfl, 0) ||
0 > sigaction(SIGCHLD, &act_dfl, 0) ||
0 > sigaction(SIGQUIT, &act, 0)) {
zlog(ZLOG_SYSERROR, "failed to init child signals: sigaction()");
return -1;
}
zend_signal_init();
return 0;
}
SIGQUIT 信号处理函数 sig_soft_quit 最终会调用 fcgi_terminate 将 in_shutdown 设置为1,不在接受任何请求处理。
主进程等待子进程结束之后
最后master 等待所有的子进程结束,执行 execvp(saved_argv[0], saved_argv); 根据之前保存的启动参数重新启动一个进程,然后调用exit(FPM_EXIT_SOFTWARE); 退出。另外在处理socket的时候,新的进程会继承 socket fds. (on PARENT EXEC we want socket fds to be inherited through environment variable)
总结
php-fpm 收到reload信号,会向所有子进程发送SIGGUIT信号,同时注册一个定时器,在规定的时间之内子进程没有退出,接着在发送SIGTERM信号,结束子进程。如果在一秒之内子进程还是没结束 直接发送SIGKILL 强制杀死。子进程收到SIGQUIT信号,停止接受请求,继续完成正在执行的请求,如果没有在父进程规定的时间结束,会收到SIGTERM信号(自己行对SIGTERM 信号采取的是默认处理程序),结束生命。理论上子进程在收到SIGKILL 肯定结束了。
------------------------------------------------------------------------------------------------------------------------------------------------------------------
通常修改了 PHP 的配置后,为了让修改生效会执行 reload,而不是 restart,但最近在使用Reload操作的时候发现了502错误,想着还是要重新思考这个问题。所以这篇文章主要给大家介绍了关于PHP中Reload操作的内容,有需要的朋友们可以参考借鉴,下面来一起看看吧。
前言
有很多前辈告诫过我们,reload 能保证整个过程的平滑性,所谓平滑性指的是在 reload 的过程中,旧的进程在处理完当前请求前不会提前终止。很多年来,我从来没有质疑过这种说法,直到有一天,当我 reload 的时候,出现了 502 错误,让我不得不重新思考。
如何重现问题呢?让我们写一个简单的脚本来模拟:
1 2 3 4 5 6 |
|
此时用浏览器浏览这个网址,接着立刻执行 reload 操作,就能看到 502 错误了。
难道 PHP 这么弱?连 reload 基本的平滑性都无法保证?答案当然是否定的,实际上通过 process_control_timeout
参数可以实现我们的目标。可惜这个参数缺省是 0,也就是不生效,本文把它设置成 10s。重新执行之前的实验步骤,这一次正常输出了结果。不过如果你多做几次实验的话,可能会发现当我们 reload 的时候,sleep 立刻就结束了,这是因为 sleep 收到 reload 发出的信号后直接返回了,下面让我们再改写一下脚本:
1 2 3 4 5 6 7 8 |
|
重新执行之前的实验步骤,你会发现 502 错误又出现了。这是因为 reload 虽然让第一个 sleep 立刻结束了,但是第二个 sleep 还是有效的,而且超过了 process_control_timeout
的时间限制。如果我们把 process_control_timeout
设置为 12s,那么就又好了。
如此说来,我们只要给 process_control_timeout
设置一个合理的数值就能保证 reload 操作的平滑性,不过到底多大是合理的数值呢?太小的话可能起不到作用,太大的话会不会有副作用?让我们带着疑问重复上一次实验,不过这次我们再加一个监控:
1 |
|
此监控的目的是为了观察 reload 过程中 PHP-FPM 进程数的变化情况,为了让效果更明显些,建议把 PHP-FPM 的启动方式改成 static 模式,同时进程数不要太多。
当我们重复上一次实验的时候,结果发现除了正在执行请求的进程,其它进程直接就被干掉了,而新进程又没有立刻启动,就这样一直卡到最后一个旧进程执行完后新进程才完成启动过程。在此期间,如果有别的请求进来,那么无疑它无法立刻得到响应。
根据我们的实验可以得出结论:缺省情况下,PHP-FPM 无法保证平滑的执行 reload 操作,必须设置一个合理的 process_control_timeout
才行,同时需要注意的是其值不能设置的过大,否则系统可能出现更为严重的请求堵塞问题。