php怎么使用Amp Websocket_php如何构建高性能异步实时通信服务-php教程-PHP中文网

WebSocket服务启动失败主因是端口被占，需用lsof或netstat查杀；路由须用Amp\Http\Server\Router显式配置；大消息需分片发送；生产环境需调优心跳间隔并配置Nginx WebSocket支持。

php怎么使用amp websocket_php如何构建高性能异步实时通信服务

WebSocket 服务启动失败：`Amp\Socket\Server` 绑定端口报错 `Address already in use`

常见于本地调试时，8080 或 8000 端口被 PHP 内置服务器、Node 进程或上一次未退出的 Amp\Socket\Server 占用。Amp 的 WebSocket 服务不是靠 php -S 启动的，它自己就是完整服务器，必须确保端口干净。

实操建议：

先执行 lsof -i :8080（macOS/Linux）或 netstat -ano | findstr :8080（Windows）查占用进程，再 kill -9 [PID] 干掉
别在 index.php 里直接跑 Server::start() 后就刷新浏览器——Amp 是长生命周期进程，应通过终端命令启动：php server.php，且运行后不退出
开发时加 set_error_handler 捕获底层 socket 错误，否则 Address already in use 可能静默失败，只看到进程闪退

客户端连不上 `Amp\WebSocket\Server`：握手 400 或连接立即关闭

Amp 的 WebSocket 服务默认不处理 HTTP 升级请求以外的路径，也不自带静态文件服务。如果你用 ws://localhost:8080/ 能连，但 ws://localhost:8080/api/ws 报 400，大概率是路由没配对。

实操建议：

Amp\WebSocket\Server 本身不解析 URL path，它只监听 upgrade 请求；你得用 Amp\Http\Server\Router 做前置路由，把 /api/ws 路径显式指向 WebSocket 处理器
别漏掉 Origin 校验逻辑——浏览器强制发送 Origin 头，若服务端没响应 Access-Control-Allow-Origin，握手会失败（Chrome 控制台显示 Unexpected response code: 400）
客户端用 new WebSocket('ws://...') 时，确保协议是 ws://（非 http://），且服务端监听的是 TCP 端口，不是 HTTP 代理后的路径

`Amp\WebSocket\Connection::send()` 发送大消息卡死或断连

Amp 默认使用内存缓冲区传输帧，如果一次性 send() 超过几 MB 的 JSON 字符串，会触发底层 BufferException 或导致连接被对方主动关闭（尤其浏览器端）。这不是 bug，是流控机制生效。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

实操建议：

单次 send() 数据建议控制在 128KB 以内；超过则手动分片，用 array_chunk() 切成小块，每块间隔 yield new Delayed(1) 防爆
避免在 onOpen 回调里直接 yield $connection->send($hugeData) —— 这会阻塞整个 Event Loop；改用 Loop::defer() 推迟执行
注意 Connection::isClosed() 必须在 send 前检查，Amp 不自动重连，已关闭连接上调用 send() 会抛 InvalidStateException

生产环境部署：为什么 `supervisord` 管理的 Amp 进程总在 30 秒后意外退出

Amp 默认启用心跳检测（Ping/Pong），但某些负载均衡器（如 Nginx 默认配置）会在 60 秒无数据时主动断开空闲连接；而 Amp 若未收到客户端 pong，30 秒超时后会关掉连接。两者叠加，导致看似“稳定运行”实则连接频繁重建。

实操建议：

在 Amp\WebSocket\Server 初始化时传入自定义 Settings：new Settings(['max_ping_interval' => 45])，让服务端 ping 间隔小于 LB 超时
Nginx 前置时，必须加 WebSocket 支持配置：proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
别用 pm.max_children 类 FPM 思维管理 Amp 进程——它是单进程全异步，一个实例撑万级连接，supervisord 只需保活 1 个主进程，无需多 worker

真正的难点不在写几行 yield $server->onOpen(...)，而在理解 Amp 的事件循环如何与操作系统 socket 缓冲区、TCP Keepalive、反向代理超时层层咬合。少配一个 proxy_read_timeout，线上就收不到心跳 pong；多套一层 Swoole 兼容层，反而破坏 Amp 的原生协程调度。这些地方没日志，只在凌晨三点掉连接时才露头。