如何用 PHP 函数 stream_socket_server搭建一个简易长连接服务？

先说句实在话：stream_socket_server 本身并不是为长连接场景设计的。它只负责创建一个监听 socket，至于连接的维护、数据的收发、粘包处理、心跳检测、超时断开——这些长连接必备的“家务活”，它一概不管。如果你指望用它直接搭建一个稳定的长连接服务，那基本上等于自己从零开始造轮子，而且还得把轮子的每一个细节都打磨到位。

为什么它不适合直接做长连接服务

简单来说，stream_socket_server 只给你一个监听 socket，后续所有客户端连接的管理、读写操作、状态维护，都需要你手动实现。它不会帮你维护连接池，不会自动处理粘包，更不会在客户端超时时自动断开。所以，如果你只是想在本地跑一个简单的测试服务，它勉强能用；但一旦涉及真实场景，比如多个客户端同时在线、需要保持长连接、处理心跳，那你就得自己搞定 I/O 多路复用、连接管理、超时检测等一系列逻辑。

必须搭配 stream_select 才能真正收发数据

默认情况下，stream_socket_server 是阻塞的。这意味着，如果你不加控制，程序会卡在 stream_socket_accept 或 fread 上，直到有数据到来或新连接建立。这对单连接场景或许还能接受，但一旦有多个客户端，就会导致整个服务被一个连接拖死。

真正的解决方案是使用 stream_select 来实现 I/O 多路复用。它的核心价值在于：可以同时监听多个 socket（包括 server socket 和已建立的 client socket），从而避免单个连接阻塞整个服务。具体操作时，需要注意几点：

• 必须把 server socket 也加入 $read 数组，否则新连接永远不会被接受
• 每次 stream_select 返回后，需要遍历所有就绪的 socket：如果是新连接，就调用 stream_socket_accept；如果是已有连接，就用 fread 读取数据，并判断是否已经 EOF（客户端断开）
• stream_select 的第二个参数（写就绪）和第三个参数（异常就绪）通常不需要，但传参时不能直接给 null，必须引用一个变量

客户端断开时，fread 返回空字符串不是 bug

这是一个很容易踩的坑。当客户端关闭连接后，fread($client, 1024) 会返回空字符串 ''，而不是 false，也不会抛出异常。很多人误以为这是“没数据”，继续循环读取，结果导致 CPU 100% 空转，程序看起来还在跑，实际上已经死循环了。

正确的做法是：必须显式检查 fread 的返回值是否等于 ''，如果是，就调用 fclose($client) 关闭连接，并从管理数组中移除该 socket。另外，feof($client) 在有些网络条件下并不靠谱，特别是有缓冲或半关闭状态时，所以不建议依赖它来判断连接是否断开。

如果你需要支持心跳检测，那就得自己实现定时机制：记录每个客户端的最后通信时间，每次 fread 后更新这个时间戳，并在 stream_select 超时后遍历所有连接，清理掉超时的 socket。

bind 失败、Address already in use 怎么快速排障

这个问题在反复启停调试时特别常见——端口没释放干净，或者上一次进程还没退出。错误信息一般长这样：Unable to bind to address [tcp://0.0.0.0:8080]: Address already in use。

快速排查步骤如下：

• 先用 lsof -i :8080（macOS/Linux）或 netstat -ano | findstr :8080（Windows）查出占用端口的 PID
• 确认不是其他服务占用了端口；如果是自己的残留进程，直接 kill 掉
• 启动前加上 stream_context_set_option($context, 'socket', 'so_reuseaddr', 1)，允许端口快速复用（仅限开发环境，生产环境慎用）
• 别用 root 启动监听 1024 以下的端口，PHP 进程权限不足时可能静默失败，连错误提示都没有

说到底，实际跑起来最容易被忽略的，其实是连接的生命周期管理。没人帮你 close，没人帮你超时，没人帮你区分消息边界。哪怕你只支持 10 个并发连接，也得手写连接池、心跳计时器、读缓冲切包逻辑。如果真要搭建一个可靠的长连接服务，与其自己用 stream_socket_server 硬扛，不如直接上 Swoole 或 Workerman——这些工具已经帮你把底层这些麻烦事都处理好了。