swoole的PHP热重启,2.9 热重启

# 热重启

---

[TOC=2,3]

## 1.服务器热重启

所谓热重启，就是当服务器相关代码有所变动之后，无需停止服务，而是在服务器仍然运行的状态下更新文件。Swoole通过内置的reload函数以及两个自定义信号量实现了这一功能。

Swoole可用的三个信号：SIGTERM，SIGUSR1，SIGUSR2。

* SIGTERM用于停止服务器

* SIGUSR1用于重启全部的Worker进程

* SIGUSR2用于重启全部的Task Worker进程。

那要如何实现热更新代码文件呢？

Swoole的回调函数中有这个一个回调onWorkerStart,该回调会在Worker进程启动时被调用。因此，当swoole_server收到SIGUSR1信号并重启全部Worker进程后，onWorkerStart就会被调用。如果在onWorkerStart中require全部的代码文件，每次onWorkerStart后都会重新require一次php文件，这样就能实现代码文件的热更新。

* Reload操作只能重新载入Worker进程启动后加载的PHP文件，建议使用get_included_files函数来列出哪些文件是在WorkerStart之前就加载的PHP文件，在此列表中的PHP文件，即使进行了reload操作也无法重新载入。比如要关闭服务器重新启动才能生效。

* 对于Server的配置即$serv->set()中传入的参数设置，必须关闭/重启整个Server才可以重新加载

来看下代码实现：

```php

public function onStart( $serv ) {

cli_set_process_title("reload_master");

}

public function onWorkerStart( $serv , $worker_id) {

require_once "reload_page.php";

Test(); // reload_page.php中定义的一个函数

}

```

首先，在onStart回调函数中通过php的cli_set_process_title函数设置进程名。

在onWorkerStart中，require相关的php文件。

然后，新建一个reload.sh文件，输入如下内容：

```shell

echo "Reloading..."

cmd=$(pidof reload_master)

kill -USR1 "$cmd"

echo "Reloaded"

```

这样，就可以通过执行这个脚本重启服务器了。[点此查看完整源码](https://github.com/LinkedDestiny/swoole-doc/tree/master/src/04/reload)

* SIGUSR1: 向主进程/管理进程发送SIGUSR1信号，将平稳地restart所有worker进程

* 在PHP代码中可以调用$serv->reload()完成此操作

* swoole的reload有保护机制，当一次reload正在进行时，收到新的重启信号会丢弃

* 如果设置了user/group，Worker进程可能没有权限向master进程发送信息，这种情况下必须使用root账户，在shell中执行kill指令进行重启

* reload指令对addProcess添加的用户进程无效

## 2.停止服务

* SIGTERM: 向主进程/管理进程发送此信号服务器将安全终止

* 在PHP代码中可以调用$serv->shutdown()完成此操作

## 3.停止task worker

1.7.7版本增加了仅重启task_worker的功能。只需向服务器发送SIGUSR2即可。