常见问题

http 无法访问,ws 无法连接?

  • 请首先排除端口问题,端口未开放占此类问题的80%以上,服务器面板开放端口,同时服务商的安全组、负载均衡、CDN等服务若有使用也需要同步开放对应端口,开放端口文档

创建 https,wss 服务?

旧 API 的灰度迁移?

  • 本模块的 http 服务支持单独指定端口号,您可以对前端进行改造(或使用 Nginx 转发),先将部分API请求转到本服务完成逐步迁移,除非经过完整的测试,或您对常驻内存开发非常熟悉,否则我们不推荐您直接全量使用本服务来处理旧API的请求。

菜单规则数据异常?

  • 菜单规则的数据通过静态变量进行缓存(以组为单位),这是为了提升性能而做出的设计,若您的菜单规则发生了变动而页面上显示的菜单并未更新,请重启 Workerman 服务即可

自定义协议/服务?

  • 请先检查config/worker_*.php中的配置能否满足您的需求,然后您可以参考已有的httpws服务创建您自己的定制化服务,模块作者也可以以相同的方式添加新的服务。

模块如何监听 onWorkerStart 等事件?

  • 在模块开发中,您只需要于模块核心控制器中直接定义onWorkerStartonWorkerStoponWebSocketConnectonWebSocketClose方法,即可监听对应的事件(http服务不支持,仅ws),若不能满足您的需求,请参考已有的wshttp服务自定义您的专属服务,并告知用户如何启动该服务即可。

自定义后台入口后无法访问?

  • 请于 config/app.php 内,设置好应用映射 app_map 即可,key 为随机入口名(不含.php),value为固定的admin,可参考下方示例,系统新版本已对此进行优化,无需手动配置
php 复制代码
return [
    // ...
    // 应用映射(自动多应用模式有效)
    'app_map'          => ['New entrance name' => 'admin'],
];