pthreads已废弃，仅限php 7.2–7.4 zts cli环境使用，需php -i确认thread safety为enabled，且不可用于web sapi；共享数据须用threaded封装，异常需手动捕获，现推荐parallel或swoole协程替代。
PHP 本身不支持多线程，pthreads 是唯一能实现真正 POSIX 线程并发的扩展，但它只在 PHP 7.0–7.4 的 ZTS（Zend Thread Safety）CLI 环境下可用，且已于 PHP 8.0 起彻底废弃——现在强行启用会直接报错或崩溃。
确认 PHP 是否支持 pthreads（关键第一步）
很多人卡在这步就失败了，不是代码问题，而是环境根本不达标。
- 执行
php -i | grep "Thread Safety"，输出必须是enabled；若为disabled，ZTS 未启用，pthreads无法加载 - 执行
php -m | grep pthreads，无输出说明扩展未安装或被禁用 -
php -r "echo PHP_ZTS;"应输出1；输出0表示非 ZTS 版本，哪怕装了pthreads.so也会被忽略 - Web SAPI（如
php-fpm、apache2handler）下强制加载pthreads会导致进程 segfault，仅限 CLI
启动线程前必须重写 run() 方法
继承 Thread 或 Worker 类后，run() 是唯一被线程上下文执行的入口，其他方法（包括构造函数）仍在主线程中运行。
- 不能在
__construct()里做耗时操作，它不在线程内执行 -
run()内不可访问$this->以外的全局变量或静态变量，除非显式传入或使用Threaded对象 - 所有 I/O 操作（如
file_get_contents、curl_exec）在线程中是阻塞的，不会自动异步化 - 示例中常见错误：
echo输出可能乱序或丢失，因多个线程共用 stdout 缓冲区，建议加锁或改用日志文件
共享数据必须用 Threaded 类封装
普通数组、对象、资源在线程间不可安全共享。直接传递或修改会触发 Fatal error: Uncaught Error: Cannot synchronize a non-threaded object。
- 需要跨线程读写的数据，必须包装成
Threaded实例，例如：$shared = new \Threaded(); $shared['result'] = []; - 向
Thread子类传参时，避免传入mysqli、PDO、cURL resource等不可序列化/不可复制的资源，会直接报Serialization of 'mysqli' is not allowed - 线程内异常不会自动抛给主线程，必须在
run()中手动捕获并写入Threaded容器，否则静默失败 -
Pool类虽简化了任务分发，但提交的 worker 必须是Collectable实现，且run()返回值无法直接获取，需靠共享容器中转
替代方案比硬上 pthreads 更实际
2026 年还在生产环境用 pthreads 属于高风险操作：PHP 7.4 已 EOL，官方不再维护，主流 Docker 镜像默认不带 ZTS，且调试工具链完全缺失。
- IO 密集型任务（如批量 HTTP 请求）优先用
swoole协程：Swoole\Coroutine\Http\Client并发 100+ 连接毫无压力，无共享内存陷阱 - CPU 密集型任务用
pcntl_fork+shmop或消息队列（Redis/RabbitMQ），进程隔离更稳定 - 简单并行可考虑
parallel扩展（PHP 8.1+），基于 FFI 实现轻量级并行，无需 ZTS，但暂不支持线程间通信 - 任何 Web 场景都应放弃
pthreads，FPM 下启用它等于主动制造崩溃点
真正难的从来不是怎么写 start() 和 join()，而是确保线程退出时没有残留资源、共享状态没被破坏、异常没被吞掉——而这些，在 pthreads 的废弃生态里，基本靠手写防御性代码硬扛。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
