Workerman实现自动重启需分层次处理:代码更新可通过内置Monitor组件监听文件变化并触发平滑重启;进程崩溃则依赖Supervisor或systemd等外部工具实现主进程级的自动恢复。

Workerman要实现自动重启,通常不是一个单一的命令就能解决的,它更像是一个系统性的考量。简单来说,如果你指的是代码更新后的服务重载,Workerman有其内置的机制和一些辅助工具;但如果指的是整个Workerman应用崩溃后的自动恢复,那我们往往需要借助外部的进程守护工具。至于进程监控,Workerman自身提供了一些基础状态查询,但更全面的监控则需要结合操作系统工具和专业的监控方案来构建。这事儿,得看你具体想解决什么层面的“自动”和“监控”了。
当我刚接触Workerman时,也曾纠结于“如何让它自己重启?”这个问题。后来才明白,这背后其实分了好几个层次。最基础的,Workerman在守护进程模式下(也就是
start -d),如果某个子进程因为代码错误或者资源耗尽而意外退出,主进程是会尝试重新拉起它的。这算是最原始的“自动重启”,针对的是内部单个子进程的健壮性。
但很多时候,我们说的“自动重启”是指代码更新后,服务能在不中断或尽量少中断的情况下加载新代码。Workerman提供了
reload命令(
php your_start.php reload),它会平滑地重启所有子进程,新连接会分配给新进程,旧进程处理完当前请求后退出。这本身不是“自动”的,需要我们手动触发。
要让这个
reload变得“自动”,一种常见的做法是结合Workerman自带的
Monitor组件。这个组件能够监控指定目录下的文件变化,一旦检测到有文件更新,就会自动发送
SIGUSR1信号给Workerman主进程,从而触发子进程的平滑重启。这对于开发环境或者小型部署来说非常方便。
// 假设你的start.php
use Workerman\Worker;
use Workerman\Monitor; // 引入Monitor
// ... 其他Worker配置
if (!Worker::$daemonize) { // 仅在非守护进程模式下启动Monitor,避免生产环境频繁重启
$monitor_worker = new Monitor('你的项目根目录', [
'file_mtime_limit' => 2, // 检查文件修改时间间隔,单位秒
'exts' => ['php'], // 监控的文件扩展名
'exclude_dirs' => ['vendor', 'runtime'], // 排除的目录
]);
$monitor_worker->name = 'Monitor';
$monitor_worker->count = 1; // Monitor自身只需要一个进程
$monitor_worker->onWorkerStart = function() use ($monitor_worker) {
echo "Monitor started, watching: " . implode(', ', $monitor_worker->monitor_dirs) . "\n";
};
}
// ... 你的Worker::run()而更高级的“自动重启”,尤其是当整个Workerman主进程都崩溃了(比如服务器内存耗尽、Workerman自身出现未捕获的严重错误),这时候就需要外部的进程守护工具出马了。
Supervisor、
systemd都是非常成熟的选择。它们会监控你Workerman的启动脚本,一旦发现Workerman进程不再运行,就会立即尝试重新启动它。这才是确保服务高可用的最终防线。我个人倾向于在生产环境用
systemd,因为它与操作系统结合得更紧密,管理起来也更规范。
Workerman代码更新后,如何实现服务的平滑重载?
说实话,每次部署新代码,手动去敲个
reload命令,或者先
stop再
start,对于我这种“懒惰”的开发者来说,是有点烦的。所以,让Workerman在代码更新后自动加载新逻辑,是提高开发效率和部署体验的关键一步。
前面提到了Workerman自带的
Monitor组件,这确实是一个非常直接且有效的方案。它的原理很简单:就是周期性地扫描你指定的目录,检查PHP文件的修改时间。一旦发现文件有变动,它就会给Workerman的主进程发送一个
SIGUSR1信号。Workerman收到这个信号后,会优雅地关闭旧的子进程,并启动新的子进程来加载最新的代码。这个过程是“平滑”的,意味着正在处理的请求不会中断,新的请求会由新的子进程来处理。
使用时,你需要确保
Monitor在Workerman的启动脚本中被正确引入和配置。比如,你可以指定只监控
app目录下的
.php文件,同时排除
vendor或者
runtime这些频繁变动但又不需要触发重载的目录。
// 简化示例,通常Monitor会集成在你的启动脚本中
// 确保在Worker::run()之前定义
if (!Worker::$daemonize) { // 通常只在开发或特定场景下启用
$monitor = new Monitor(__DIR__ . '/app', [
'file_mtime_limit' => 1, // 每秒检查一次
'exts' => ['php', 'json'], // 监控php和json文件
'exclude_dirs' => ['vendor', 'storage/logs'], // 排除目录
]);










