# 热重启 --- [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即可。