Composer快速引入并配置单元测试框架PHPUnit（搭建流程）-composer-PHP中文网

正确做法是 composer require --dev phpunit/phpunit 并手动配置 phpunit.xml；composer install phpunit 命令不存在，因 install 不接受包名参数，且 phpunit.xml 必须位于根目录、bootstrap 路径正确、测试类须继承 phpunit\framework\testcase。

composer快速引入并配置单元测试框架phpunit（搭建流程）

直接结论：别用 composer install phpunit，这条命令根本不存在；正确做法是 composer require --dev phpunit/phpunit + 手动配好 phpunit.xml，否则跑不起来。

为什么 `composer install phpunit` 会报错

这是最常踩的第一个坑——composer install 只负责安装 composer.json 里已声明的依赖，它不接受任意包名作为参数。phpunit 不是命令，而是包名，必须用 require 引入。

composer install phpunit → 报错 Command "install" is not defined. 或类似提示
正确命令只有两个场景：
本地项目测试用：composer require --dev phpunit/phpunit
想全局调用（不推荐）：composer global require phpunit/phpunit
如果提示 Could not find package phpunit/phpunit，先检查 PHP 版本（PHPUnit 10 要求 PHP ≥ 8.1），再确认能否访问 Packagist（比如 curl -I https://packagist.org）

`phpunit.xml` 必须手写，且位置和内容都不能错

装完包不代表能跑测试——vendor/bin/phpunit 默认只扫描当前目录下以 *Test.php 结尾的文件，真实项目几乎不可能满足这个条件。必须靠 phpunit.xml 指定路径和加载逻辑。

文件必须放在项目根目录，名字只能是 phpunit.xml 或 phpunit.xml.dist（少一个字符都不认）
bootstrap 属性决定自动加载是否生效：
纯 PHP 项目用 bootstrap="vendor/autoload.php"
ThinkPHP 等框架需指向 bootstrap="tests/bootstrap.php"（该文件由 topthink/think-testing 提供）
最简可用配置（UTF-8 编码，无 BOM）：

<?xml version="1.0" encoding="UTF-8"?><phpunit bootstrap="vendor/autoload.php" colors="true"><testsuites><testsuite name="Unit"><directory>tests/</directory></testsuite></testsuites></phpunit>

注意：<directory>tests/</directory> 路径要和你实际建的测试目录一致；如果测试文件放在 tests/Unit/，这里就得写 tests/Unit。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

测试类继承和命名有硬性要求

即使配置全对，运行时仍可能报 Class 'PHPUnit\Framework\TestCase' not found，本质是自动加载没走通，或类写法过时。

测试类必须继承 PHPUnit\Framework\TestCase（PHP 7.4+），不是旧版的 PHPUnit_Framework_TestCase
文件名必须以 Test.php 结尾（如 CalculatorTest.php），类名去掉 Test.php 后缀后首字母大写（CalculatorTest → 类名 CalculatorTest）
方法名必须以 test 开头，或加 @test 注解；返回类型建议显式声明 : void
示例片段：

<?php use PHPUnit\Framework\TestCase;

class CalculatorTest extends TestCase
{
    public function testAddition(): void
    {
        $this->assertEquals(5, 2 + 3);
    }
}

运行测试前务必确认入口方式

很多人在 IDE 里右键“Run”失败，不是代码问题，而是没走 Composer 的启动流程。

必须用 ./vendor/bin/phpunit（Linux/macOS）或 php vendor\bin\phpunit（Windows）执行，它内部会 require vendor/autoload.php
如果用 PHPStorm 等 IDE 运行，检查运行配置中是否勾选 “Use alternative configuration file”，路径必须指向项目根目录下的 phpunit.xml
首次运行建议加 --verbose 参数看详细加载过程：./vendor/bin/phpunit --verbose
报 Class not found 时，优先检查 composer.json 的 autoload-dev 是否包含 tests/ 目录（尤其自定义命名空间时）