workerman 5.2.3 自定义进程需严格区分监听型（须调用listen()绑定端口，处理tcp/ws/http连接，自行管理粘包、心跳、状态）和非监听型（不调用listen()，仅在onworkerstart中用timer或消息队列驱动定时任务），均基于原生worker机制，不依赖config自动加载，启动时只执行一次worker::runall()。
Workerman 5.2.3 编写自定义进程任务，核心是区分“监听型”和“非监听型”两类进程，并严格遵循其生命周期与启动方式。它不依赖 config 文件自动加载类，也不走 Webman 的 process 管理层（除非你用的是 Webman 框架）。直接基于 Workerman 原生机制编写即可，简洁、可控、无封装干扰。
监听型进程：TCP/WS/HTTP 服务
适用于需要长期监听端口、处理连接的场景，比如 Modbus 网关、WebSocket 推送服务、私有协议服务器。
- 创建 Worker 实例时明确指定协议和端口，例如
new Worker('tcp://0.0.0.0:502')或new Worker('websocket://0.0.0.0:8888') - 必须调用
$worker->listen()，否则端口不会真正绑定，客户端 connect 会立刻失败 - 设置
$worker->count = N控制子进程数，多进程共享同一端口需开启reusePort（Linux） - 所有回调（
onConnect、onMessage、onClose）都作用于TcpConnection对象，无 Request/Response 封装 - 粘包、心跳、连接状态维护全由你负责，例如用前 4 字节解析包长，或定时检查
$connection->lastMessageTime
非监听型进程：定时任务 / 后台作业
适用于无需网络监听、只做周期性操作的后台任务，比如清理缓存、轮询数据库、消费消息队列。
- 创建空 Worker：
$worker = new Worker()，不传监听地址 - 不调用
listen()，避免无效绑定；仅在onWorkerStart中使用Timer::add()或Redis::blpop()驱动逻辑 - 可复用
support/Async工具类做异步 DNS 查询，但别指望它自动转同步 DB 查询——要用workerman/mysql这类事件驱动客户端 - 避免在回调中执行
sleep()、file_get_contents()、curl_exec()等阻塞操作，否则卡死整个进程 - 若需跨进程共享状态（如任务进度），统一走 Redis，不要用全局变量或文件锁
进程管理与部署要点
Workerman 5.2.3 默认以多进程模式运行，主进程负责监控子进程健康状态，支持平滑重启与信号管理。
- 启动入口脚本里只写一次
Worker::runAll()，放在文件末尾；切勿在控制器、中间件或循环中重复调用 - Windows 下需用
php start.php start -d（非start_for_win.bat）才能启用多进程，否则只起单个 worker - 守护模式下日志默认输出到
workerman.log，调试阶段建议先关闭-d，直连终端看输出 - 热更新需配合
php start.php reload，前提是进程未因致命错误退出，且未占用已被释放的端口 - 权限问题常见于低端口（如 80、443），非 root 用户请改用 1024 以上端口，或配置
setcap 'cap_net_bind_service=+ep' /usr/bin/php
常见陷阱与绕过方案
很多问题不是功能缺失，而是误用了上下文或加载时机。
- 报错 “Cannot declare class Worker”：说明你在一个已加载 Workerman 类的环境中（如 Webman）又 require autoload.php —— 删除重复加载，直接 new 即可
-
进程启动后 ps 看不到、端口没监听：检查是否漏了
listen()，或onWorkerStart里写了Worker::runAll()导致阻塞 - 连接能建但收不到 onMessage：确认协议匹配（如客户端用 ws:// 连，服务端却是 tcp://），并检查是否启用了 TLS 或反向代理透传
- 定时任务只执行一次就停：Timer::add 第二个参数必须是闭包或可调用对象，不能是普通函数名字符串
- Redis 连接报 “Connection refused”：非 Workerman 问题，检查 Redis 是否运行、bind 地址是否为 127.0.0.1、protected-mode 是否关闭
