Webman自动化测试指南使用PHPUnit提升代码质量-php教程-PHP中文网

Webman PHPUnit测试失败主因是tests/bootstrap.php未显式引入support/bootstrap.php，导致app()、config()等函数不可用；必须先加载vendor/autoload.php，再引入support/bootstrap.php，并在phpunit.xml中正确配置bootstrap路径为./tests/bootstrap.php。

webman自动化测试指南使用phpunit提升代码质量

Webman 的 PHPUnit 测试跑不起来，90% 是因为 bootstrap.php 没加载框架上下文，导致 app()、config()、容器全不可用——这不是 PHPUnit 配置问题，是 Webman 启动链没接上。

tests/bootstrap.php 必须桥接 support/bootstrap.php

只写 require_once __DIR__ . '/../vendor/autoload.php' 不够，app() 会报 Call to undefined function app()。Webman 的初始化逻辑在 support/bootstrap.php，必须显式引入：

require_once __DIR__ . '/../vendor/autoload.php' 放第一行，确保自动加载就绪
紧跟着 require_once __DIR__ . '/../support/bootstrap.php'，触发 Config 加载、容器注册、Bootstrap 类 ::start()
可选但推荐：加 $_ENV['APP_ENV'] = 'testing'，避免开发环境配置干扰测试行为
别在 tests/bootstrap.php 里重复调用 Webman\Config::load() 或遍历 config('bootstrap')——support/bootstrap.php 已做完这些

phpunit.xml 的 bootstrap 和 directory 路径必须精确

路径错一个字符，PHPUnit 就找不到引导文件或误扫 bootstrap.php 自身，报 Cannot declare class Bootstrap：

bootstrap 值是相对路径，从 phpunit.xml 所在位置（项目根目录）算起，正确写法是 ./tests/bootstrap.php，不是 tests/bootstrap.php（少 ./）或 ../tests/bootstrap.php（多 ../）
别写成 ./tests，否则会把 bootstrap.php 当测试类加载；应限定为 ./tests/unit 或 ./tests/http，按类型分目录
backupGlobals 和 processIsolation 务必设为 false，否则 Webman 容器单例状态被重置，后续测试全挂

Controller 测试不能 new，必须抽离 Service 或 mock Request

直接 new YourController 会崩在 Call to a member function input() on null，因为 Controller 依赖 Request、Response 和容器注入：

btpanel phpsite 宝塔面板PHP网站

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

下载

优先方案：把业务逻辑从 Controller 移到独立 Service 类，对 Service 写纯单元测试——这才是可维护、可复用的测试
若必须测 Controller 行为：用 $this->createMock(Webman\Http\Request::class) 构造请求对象，再通过 app()->make(YourController::class) 获取容器托管实例（确保 bootstrap 已执行）
绝对避免在测试中调用 Route::dispatch()，它会启动完整 HTTP 生命周期，引入路由、中间件、响应输出等不可控副作用
测试数据库操作时，用 DatabaseTransactions trait 或手动 DB::beginTransaction()/rollback()，防止测试污染数据

Docker + PHPStorm 调试时 Remote Path 别乱填

在 Docker 容器里跑测试总报 Class not found，大概率是 PHPStorm 的 Path mappings 配置反向搞错了：

CLI Interpreter → Path mappings 中，Remote path 栏位**必须留空**（不是填 /var/www 或项目路径）
只填 Local path 指向宿主机项目根目录，且确认容器内 WORKDIR 与之完全一致（如都是 /var/www）
填了 Remote path 会导致 PhpStorm 把本地路径错误映射成容器内不存在的路径，自动加载失败
PHP 8.5.5 对路径解析更严格，这类映射错误在该版本下更容易暴露

最常被忽略的是：Webman 的测试不是“写完 Test 类就能跑”，而是整个初始化链要手工接通。哪怕只漏掉 support/bootstrap.php 这一行，后面所有 app()、db()、event() 调用都会静默失效——错误不报在测试里，而报在你调用它们的那一行。