Swoole安装时启用sockets模块支持

在编译安装 Swoole 时，有一个参数经常被新手忽略，但它恰恰决定了协程 Socket 等核心功能能否正常使用——--enable-sockets。很多人以为只要系统里装了 PHP 的 sockets 扩展就够了，但实际上，Swoole 需要你在 configure 阶段明确告诉它“我要用 sockets”，否则后续一切基于协程 Socket 的代码都会直接报错。下面把这个问题拆开说清楚。

为什么必须显式启用 --enable-sockets

Swoole 的协程 Socket（如 Swoole\Coroutine\Socket）、异步事件监听（swoole_event_add）以及底层 I/O 多路复用都依赖 PHP 的 sockets 扩展提供的基础能力。但注意：sockets 扩展本身是可选的，很多 PHP 发行版（尤其是 phpEnv、LNMP 一键包、Docker 镜像）默认不编译它。如果 configure 阶段没加 --enable-sockets，即使系统装了 php-sockets，Swoole 编译时仍会跳过 socket 相关功能模块，运行时直接报 Class 'Swoole\Coroutine\Socket' not found 或 Segmentation fault。

./configure 中 --enable-sockets 的实际影响

这个参数不是“开关”，而是强制 Swoole 在构建时链接并调用 sockets 扩展的 C API。它不安装 sockets 扩展本身，但要求该扩展已存在且可用：

• 若 PHP 未启用 sockets 扩展（php -m | grep sockets 无输出），configure 会静默跳过，后续任何基于协程 socket 的代码都会失败
• 若已启用 sockets 但 configure 没加该参数，Swoole 将完全忽略 socket 功能，Swoole\Coroutine\Socket 类根本不会被定义
• 在 macOS Homebrew 环境下，还需确保 sockets 是用相同 OpenSSL 版本编译的，否则可能触发 TLS 握手崩溃

常见错误与对应检查项

遇到 socket 相关功能异常时，按顺序确认以下三点：

• 运行 php -m | grep sockets —— 必须有输出，否则先启用 PHP 自带的 sockets 扩展（Ubuntu：安装 php-dev 后重编 PHP；macOS：brew install php 默认含 sockets）
• 检查 Swoole 编译日志中是否出现 checking for sockets support... yes，没有则说明 configure 漏了 --enable-sockets
• 运行 php --ri swoole，输出里应包含 sockets => enabled，否则即使扩展加载成功，socket 功能也处于禁用状态

PECL 安装时如何正确响应交互提示

使用 pecl install swoole 时，终端会逐项询问支持选项，其中这一项必须明确输入 yes：

enable sockets supports? [no] : yes

注意：pecl 不会自动探测系统是否装了 sockets，它只读取你的输入。输错或直接回车（默认 no）就等于主动关闭 socket 支持。其他如 openssl、mysqlnd 等同理——每个 yes 都是硬依赖开关，不能靠“默认”蒙混过关。