必须使用ZTS版PHP才能启用parallel扩展，pthreads已废弃；php -i | grep "Thread Safety"输出enabled是前提，否则扩展加载失败且无明确报错。
pthreads 在 PHP 8.0+ 环境下根本无法加载，不是配置问题，而是扩展已彻底废弃且不兼容 —— 必须改用 parallel 扩展，但前提是 PHP 必须是 ZTS（Thread Safe）构建版本。
确认 PHP 是否为 ZTS 版本
这是所有后续操作的前提，parallel 和 pthreads 都强制要求 ZTS，而绝大多数预编译的 PHP（尤其是 Windows 下的非 TS 版、Linux 上的主流包管理安装版）默认是 NTS（Non-Thread-Safe）。
运行以下命令检查：
php -i | grep "Thread Safety"
输出必须是 enabled；若为 disabled，则说明当前 PHP 不支持任何线程扩展，extension=parallel 即使写进 php.ini 也会静默失败或报“undefined symbol”类错误。
立即学习“PHP免费学习笔记（深入）”；
常见误区：
- 以为加了
extension=parallel就算启用成功 —— 实际上加载失败时php -m不会列出parallel，且无明确报错 - 在 Apache/Nginx 的 FPM 模式下尝试启用 ——
parallel仅支持 CLI 或 embed SAPI，Web SAPI 下直接拒绝初始化 - 用
php -v看版本号就认为环境 OK —— 版本号不体现 ZTS/NTS，必须查Thread Safety行
Windows 下安装 parallel 扩展的完整路径
PHP 8.x 官方 Windows 构建中，ZTS 版本极少公开提供，所以你大概率需要手动下载匹配的 TS 版 PHP（如从 windows.php.net/downloads/releases/ 找带 Thread Safe 字样的 ZIP 包），再配 parallel。
关键步骤和易错点：
- 从 PECL 页面 下载与你的 PHP 主版本、TS/NTS 类型、VC 编译器版本（VC15/VC16/VC17）、架构（x64/x86）**完全一致**的
php_parallel.dll - 解压后你会看到另一个文件：
pthreadVC2.dll或pthreadVC3.dll—— 它**不能放在ext/目录里**，必须复制到 PHP 根目录（如C:\php\），并把该目录加进系统PATH环境变量 -
php.ini中只写extension=parallel，不要加.dll后缀，也不要写绝对路径 - 验证方式：在 CMD 中进入 PHP 目录，执行
php -m | findstr parallel；若无输出，再执行php --ri parallel，报 “Extension 'parallel' not present” 就说明 ZTS 缺失或 DLL 路径未生效
Linux/macOS 下启用 parallel 的实际约束
多数 Linux 发行版（如 Ubuntu/Debian/CentOS）的包管理器提供的 PHP 默认是 NTS，且不提供 ZTS 构建选项。你几乎必须自己编译 PHP。
典型流程要点：
- 下载 PHP 源码后，
./configure必须包含--enable-zts（PHP 8.0+）或--enable-maintainer-zts（PHP 7.x） - 编译完成后，生成的
php可执行文件路径通常为./sapi/cli/php，它才是真正的 ZTS 版 CLI —— 别误用系统 PATH 里的旧版php - 用
pecl install parallel时，需指定对应 ZTS 版本的php-config，例如：pecl install -f parallel && echo "extension=parallel.so" >> $(php --ini | grep "Loaded Configuration File" | cut -d' ' -f4) - 运行脚本时，必须显式调用 ZTS 版本的 PHP：
./sapi/cli/php script.php，否则即使扩展已编译好，也会因 SAPI 不匹配而失败
parallel 的基本用法与陷阱
parallel 不是“开线程”，而是基于 fork + shared memory 的轻量级并行运行时，它对代码结构有硬性限制。
最简可用示例：
$future = \parallel\run(function () {
return str_repeat("x", 1000000);
});
$result = $future->value(); // 阻塞等待
但以下写法会直接报 Fatal error: Uncaught parallel\RuntimeError: Illegal instruction：
- 闭包内使用
yield、&$var引用传参、declare(ticks=1) - 闭包内定义新类或命名函数（
function helper() {}） - 试图在
\parallel\run()外部访问$future->value()—— 它只能被调用一次，重复调用抛异常 - 在 Web 请求上下文中调用（如 Apache mod_php 或 PHP-FPM）—— 这会导致进程崩溃，只能用于 CLI 场景
真正容易被忽略的是：parallel 的“并行”本质是多进程而非多线程，它不共享内存空间，所有数据传递靠序列化/反序列化完成，因此不适合高频小数据交互场景；若任务间需频繁通信，应退回到消息队列 + pcntl_fork 的组合方案。
