如何用 PHP 函数 stream_socket_server搭建一个简易长连接服务？
stream_socket_server不适合构建长连接服务，需手动处理连接管理、粘包、心跳及超时断开，必须搭配stream_select实现I/O多路复用。客户端断开时fread返回空字符串，需显式关闭连接。端口占用可通过lsof排查并启用SO_REUSEADDR。生产环境建议使用Swoole或Workerman。
先说句实在话：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——这些工具已经帮你把底层这些麻烦事都处理好了。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
