PHP 7.x多线程开发报错：Fatal error: Class 'Thread' not found 问题求助

嘿，这个问题我太熟了！你碰到的Fatal error: Class 'Thread' not found本质是因为Thread类根本不是PHP核心自带的，它属于PHP的多线程扩展，默认没安装。根据你用的PHP 7.x版本，分两种情况解决：

一、PHP 7.0 ~ 7.2版本：安装pthreads扩展 #

pthreads是早期PHP多线程的主流扩展，专门提供Thread类这类多线程相关API：

• 第一步：确认你的PHP是线程安全（TS）版本
  pthreads只支持线程安全版的PHP，执行命令php -v，输出里如果有Thread Safe字样就没问题；如果是Non Thread Safe，你得先换成对应版本的TS版PHP。

• 第二步：安装pthreads扩展

  • Linux环境：直接用pecl安装，注意对应版本（PHP 7.0-7.2对应pthreads 3.x）：

    pecl install pthreads-3.1.6
    

    安装完成后，系统会提示你在php.ini里添加extension=pthreads.so，记得重启PHP服务或者CLI环境。
  • Windows环境：去对应PHP版本的官方扩展下载站，找和你的PHP版本、系统架构（x86/x64）匹配的pthreads.dll，把它放到PHP的ext目录下，然后在php.ini里添加extension=pthreads.dll，重启web服务器或者CLI。

• 第三步：验证安装
  写个简单的测试脚本：

  <?php
  if (class_exists('Thread')) {
      echo "Thread类已成功加载！";
  } else {
      echo "扩展安装有问题，再检查下步骤哦";
  }
  ?>
  

  执行后如果输出成功提示，就可以正常用Thread类了。

二、PHP 7.2及以上版本：改用parallel扩展 #

从PHP 7.2开始，pthreads被官方废弃，推荐使用更稳定的parallel扩展，它的API和pthreads略有不同，但功能更完善：

• 第一步：同样确认是线程安全（TS）版本的PHP，parallel也依赖TS环境。

• 第二步：安装parallel扩展

  • Linux环境：

    pecl install parallel
    

    安装后在php.ini里添加extension=parallel.so，重启服务。
  • Windows环境：下载对应版本的parallel.dll放到ext目录，php.ini添加extension=parallel.dll，重启服务。

• 第三步：调整代码适配parallel的API
  parallel里的线程类是Parallel\Thread，需要先引入命名空间，比如：

  <?php
  use Parallel\Thread;
  
  class MyCustomThread extends Thread {
      public function run() {
          echo "我的线程正在运行！\n";
      }
  }
  
  $thread = new MyCustomThread();
  $thread->start();
  $thread->join(); // 等待线程执行完成
  ?>
  

常见踩坑点提醒 #

• 别搞混NTS和TS版本：不管用哪个扩展，都必须用线程安全版PHP，NTS版装了扩展也加载不起来。
• 扩展版本要完全匹配：PHP版本、系统架构（x86/x64）、TS/NTS都要对应，不然会出现扩展加载失败的情况。
• 注意php.ini的路径：CLI环境和web服务器（比如Apache/Nginx）用的可能是不同的php.ini，修改的时候别改错了，比如CLI下用php --ini可以查看当前生效的配置文件路径。

内容的提问来源于stack exchange，提问作者Kedar Adhangale