composer集成phpunit需确保autoload-dev生效、phpunit.xml路径正确、测试类可自动加载三者缺一不可；必须用--dev安装，配置psr-4映射tests目录，运行dump-autoload，并将phpunit.xml置于根目录。
Composer 集成 PHPUnit 不是“装上就行”，关键在于 autoload-dev 是否生效、phpunit.xml 路径是否被识别、以及测试类能否被自动加载——三者缺一不可。
如何用 Composer 正确安装 PHPUnit 并区分开发/生产环境
PHPUnit 必须作为开发依赖安装，否则上线打包（composer install --no-dev）会直接缺失，导致 CI 失败或本地测试无法运行。
执行以下命令：
composer require --dev phpunit/phpunit ^10
注意：--dev 会把依赖写入 require-dev，且默认启用 autoload-dev 自动加载规则。如果项目已有 "autoload-dev" 段但未包含测试目录，需手动补全：
"autoload-dev": { "psr-4": { "Tests\": "tests/" } }- 改完后必须运行
composer dump-autoload才生效 - 别把
phpunit放进require—— 它不是运行时依赖
phpunit.xml 配置文件不生效的常见原因
PHPUnit 默认只读当前目录下的 phpunit.xml 或 phpunit.xml.dist。名字错一个字符、放错位置、或者被 IDE 缓存都会导致配置被忽略。
典型问题包括：
- 文件名为
phpunit.xml.dist，但运行时加了--no-configuration参数（某些 IDE 插件默认加） -
<testsuites></testsuites>中的directory路径写成相对路径如./tests，而实际应为tests（PHPUnit 解析时以配置文件所在目录为基准） -
<filter></filter>下的<whitelist></whitelist>已废弃（PHPUnit ≥9.3），改用<coverage></coverage>+<include></include>，否则覆盖率报告为空
最小可用配置示例（放在项目根目录）：
<?xml version="1.0" encoding="UTF-8"?><phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nonamespaceschemalocation="https://schema.phpunit.de/10.5/phpunit.xsd" bootstrap="vendor/autoload.php"><testsuites><testsuite name="default"><directory>tests</directory></testsuite></testsuites><coverage></coverage></phpunit>
测试类无法自动加载：命名空间与文件路径不匹配
即使 autoload-dev 配置正确，只要类名和路径对不上，Class 'TestsUnitExampleTest' not found 就会报错。
必须同时满足：
- 文件路径为
tests/Unit/ExampleTest.php - 文件内声明
namespace TestsUnit; - 类名为
class ExampleTest extends TestCase -
TestCase来自use PHPUnitFrameworkTestCase;（不是旧版PHPUnit_Framework_TestCase）
别在 tests/ 下建 src/ 子目录——这会让 PSR-4 映射失效；也别把测试类放在 src/ 里然后靠 autoload 加载，那会污染生产 autoload 映射。
运行测试时提示 “Could not find driver” 或 “Class not found”
这类错误往往不是 PHPUnit 本身的问题，而是测试启动时加载了业务代码，触发了未安装的扩展或未声明的依赖。
常见诱因：
-
bootstrap指向的文件（如tests/bootstrap.php）里提前require了需要 PDO 的服务类，但本地没开pdo_sqlite扩展 - 测试中用了 Laravel 的
TestCase，但没装orchestra/testbench或没调TestCase::setUp() -
phpunit.xml中bootstrap路径写错，导致vendor/autoload.php没加载，所有类都找不到
排查建议：先用 phpunit --version 确认能执行；再运行 phpunit --debug tests/Unit/ExampleTest.php 看卡在哪一行；最后检查 bootstrap 文件是否真的执行了 require 'vendor/autoload.php'。
最常被跳过的细节是：改完 composer.json 的 autoload-dev 后忘记 dump-autoload，以及把 phpunit.xml 放进了子目录却没用 --configuration 指定路径。这两处一错，整个测试环境就处于“看似装了，实则瘫痪”的状态。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
