Windows环境下PHP 8.1.1出现PHPUnit_Framework_Assert类未找到错误的求助

嘿，我来帮你搞定这个问题！你遇到的错误根源在于你用的是老旧的PEAR安装版PHPUnit，它和PHP 8.1完全不兼容，而且你的代码写法还是PHPUnit 5及更早版本的旧风格，和新版的命名空间、加载机制不匹配。

错误原因拆解 #

1. PEAR版的PHPUnit（比如PHPUnit 5.x及以下）是为PHP 7.2及更早版本设计的，PHP 8.1的语法和类加载机制已经发生了变化，导致旧版的PHPUnit_Framework_Assert这类类无法被正确加载。
2. 你手动引入TestCase.php的方式是错误的——新版PHPUnit依赖Composer的自动加载机制，手动引入单个文件会缺失依赖类。
3. 你代码里用的PHPUnit_Framework_TestCase是旧版的类名，新版PHPUnit已经改用命名空间PHPUnit\Framework\TestCase。

分步解决方案 #

1. 卸载不兼容的PEAR版PHPUnit #

打开命令提示符（CMD），执行以下命令卸载旧版本：

pear uninstall phpunit/PHPUnit

2. 用Composer安装兼容PHP 8.1的PHPUnit #

首先确保你的系统已经安装了Composer，然后：

• 进入你的项目目录（比如C:\xampp\htdocs\calculator）
• 执行命令安装PHPUnit 9.5版本（这个版本完美兼容PHP 8.1）：

composer require --dev phpunit/phpunit ^9.5

3. 重构你的代码 #

第一步：拆分业务代码和测试代码

把业务类和测试类分开成两个文件，这是PHPUnit的最佳实践：

• Calculator.php（业务文件）：

<?php
class Calculator {
    public function add($a, $b) {
        return $a + $b;
    }
}
?>

• CalculatorTest.php（测试文件，注意命名要以Test结尾）：

<?php
require __DIR__ . '/Calculator.php';

use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase {
    private $calculator;

    protected function setUp(): void {
        $this->calculator = new Calculator();
    }

    protected function tearDown(): void {
        $this->calculator = null;
    }

    public function testAdd() {
        $result = $this->calculator->add(1, 2);
        $this->assertEquals(3, $result);
    }
}
?>

关键修改点：

• 不再手动引入TestCase.php，Composer会自动处理类加载（如果需要全局加载，可在测试文件顶部添加require __DIR__ . '/vendor/autoload.php';）
• 测试类继承PHPUnit\Framework\TestCase（新版命名空间）
• setUp和tearDown方法添加了: void返回类型声明，符合PHP 8的语法规范

4. 运行测试 #

在项目目录的命令提示符中，执行以下命令运行测试：

./vendor/bin/phpunit CalculatorTest.php

如果一切正常，你会看到测试通过的绿色提示。

额外提示 #

• 尽量不要把测试文件放在htdocs根目录直接通过浏览器访问，PHPUnit是命令行工具，应该通过命令行运行测试。
• 可以在项目根目录创建phpunit.xml配置文件，自定义测试的运行规则，比如自动扫描测试文件等。

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