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 肯定结束了。
