Swoole自v6.0起支持SWOOLE_THREAD多线程Worker模式，基于pthread，共享内存需手动同步；启用需Server构造时传SWOOLE_THREAD标志、worker_num表示线程数、PHP启用ZTS，禁用pthreads扩展。

Swoole 本身**不提供传统意义上的 PHP 多线程（如 pthreads 那种共享内存线程）**，但自 **v6.0 Alpha 起，Swoole 正式支持 `SWOOLE_THREAD` 模式**——它是在 Server 启动时启用的**多线程 Worker 模式**，底层基于 POSIX 线程（`pthread`），每个 Worker 是一个独立线程，共享进程内存（需手动同步），**不是多进程**。 注意：这和 `swoole_process` 创建子进程、或用 `Thread` 类（pthreads 扩展）写 CLI 多线程，是三类完全不同的机制。别混用。

如何启用 SWOOLE_THREAD 模式？

只需在 Server 构造时传入 SWOOLE_THREAD 标志，并确保配置中未禁用线程支持：

$http = new Swoole\Http\Server('0.0.0.0', 9501, SWOOLE_THREAD);
$http->set([
    'worker_num' => 4, // 线程数，不是进程数
]);

• SWOOLE_THREAD 是启动标志，必须显式传入，SWOOLE_BASE 或 SWOOLE_PROCESS（默认）都不行
• worker_num 此时代表「工作线程数」，不是进程数；线程间共享内存，但 global、静态变量、static 属性等**默认不安全**，需加锁或改用 Swoole\Thread\Map
• PHP 必须启用 ZTS（Zend Thread Safety）编译模式，可通过 php -i | grep "Thread Safety" 确认输出为 enabled；否则会直接报错：Fatal error: Swoole extension is not compiled with thread safety support
• 扩展依赖：Swoole ≥ v6.0.0-alpha，且不能同时加载 pthreads 扩展（冲突）

为什么不能直接 new Thread()？

你可能看到过类似 new Swoole\Thread(...) 的写法——那是 v6 之前废弃的实验性 API，已在 v6 正式版中移除。当前唯一受支持的线程模型，就是 SWOOLE_THREAD 模式下的 Server Worker 线程。

Swoole 6.1.1

Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。

下载

• 旧文档里出现的 Swoole\Thread 类、Thread::getArguments() 等，仅适用于 v5.x 及更早的非稳定分支，生产环境请勿使用
• 试图在 SWOOLE_PROCESS 模式下手动调用线程类，会触发 Segmentation fault 或静默崩溃
• 如果你真需要 CLI 下的子线程（比如后台任务调度），应改用 swoole_process + useQueue 做进程间通信，而非强行上线程

启用后哪些地方最容易出错？

线程模式下最典型的陷阱，不是性能问题，而是**内存可见性与竞态条件**——PHP 的弱类型 + 共享内存让 bug 难复现、难调试。

• 不要在回调中直接读写全局数组或静态属性，例如：$GLOBALS['counter']++ 或 MyClass::$count++ —— 这是未定义行为，结果不可预测
• 避免用 file_get_contents、cURL 等阻塞 I/O；虽在线程中不会卡住整个 Server，但仍浪费线程资源；应优先改用协程客户端（Swoole\Coroutine\Http\Client）
• onWorkerStart 中初始化的资源（如数据库连接、Redis 实例）**不能跨线程复用**；每个线程需独立创建，或改用连接池
• 日志写入若共用同一文件句柄（如 fopen('app.log', 'a')），需加 flock，否则内容会错乱或丢失

Swoole 的线程支持是务实演进的结果，不是为了对标 Java；它的价值在于高并发场景下比多进程更轻量，但代价是要求开发者对共享状态有明确意识——没加锁的“共享”，基本等于“随机”。