PHP Webman编写Unit测试_Webman单元测试与接口测试教程【规范】-php教程-PHP中文网

webman单元测试失败主因是bootstrap.php未正确加载框架上下文，导致容器未初始化、app()函数不可用；必须在tests/bootstrap.php中显式引入support/bootstrap.php以桥接框架启动逻辑。

php webman编写unit测试_webman单元测试与接口测试教程【规范】

Webman 的单元测试不是“配好 PhpStorm 就能跑”，核心在于 bootstrap.php 是否正确加载框架上下文，否则 TestCase 一调用 app() 或访问容器就报错 —— 这是 90% 新手卡住的第一步。

为什么 Webman 的测试总提示 Class 'app' not found 或 Container not initialized

Webman 不像 Laravel 自带测试环境引导，它的 tests/bootstrap.php 必须手动桥接框架启动逻辑。官方默认不加载 support/bootstrap.php，导致测试时容器、配置、路由等全不可用。

错误现象：Call to undefined function app()、Attempt to access property "xxx" on null（因 Container 未初始化）
根本原因：PhpStorm 或命令行运行 phpunit 时，只执行了 vendor/autoload.php，没触发 Webman 的框架初始化流程
正确做法：在 tests/bootstrap.php 中显式引入 support/bootstrap.php，并确保它在 autoload.php 之后执行

示例 tests/bootstrap.php：

<?php require __DIR__ . '/../vendor/autoload.php';
// 必须加这行，否则 app()、config()、db() 全失效
require __DIR__ . '/../support/bootstrap.php';
// 可选：强制设为测试环境
$_ENV['APP_ENV'] = 'testing';

phpunit.xml 配置里 directory 和 bootstrap 的路径陷阱

Webman 项目中 tests/ 下常分 unit/、feature/、http/，但 phpunit.xml 的 <directory></directory> 如果写成 tests，会把 bootstrap.php 也当测试文件扫进去，报 Cannot declare class Bootstrap, because the name is already in use。

推荐结构：tests/unit/ 存单元测试，tests/http/ 存接口测试，tests/bootstrap.php 单独放顶层
<directory></directory> 值必须精确到测试类目录，例如 tests/unit，不能写 tests
bootstrap 属性值要写相对路径（从 phpunit.xml 所在位置算起），常见错写成 ./tests/bootstrap.php（多一个点）或 tests/bootstrap.php（少 ./）

正确 phpunit.xml 片段：

btpanel phpsite 宝塔面板PHP网站

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

下载

<phpunit bootstrap="tests/bootstrap.php" colors="true"><testsuites><testsuite name="Unit Tests"><directory suffix="Test.php">tests/unit</directory></testsuite></testsuites><php><env name="APP_ENV" value="testing"></env></php></phpunit>

PhpStorm 配置 PHPUnit 时 Remote Path 和 Container Path 别填

用 Docker + PhpStorm 跑 Webman 测试时，很多人在 Cli Interpreter → Path mappings 里乱填 Remote Path，或在 Docker Container → Container Path 填路径，结果测试跑起来找不到文件、include 失败、甚至 PhpStorm 直接卡死。

关键事实：Remote Path 是旧版 PhpStorm 用于远程服务器映射的字段，Docker 场景下**完全不需要填**（留空）
Container Path 是容器内 PHP 解释器所在路径（如 /usr/local/bin/php），不是项目路径，填项目路径会导致解释器启动失败
真正要配的是 Interpreter path（指向容器内 php 可执行文件）和 Configuration file（指向项目根目录的 phpunit.xml）

接口测试写法：别直接 new Controller，要用 HttpServer 模拟请求

Webman 的控制器依赖 Request、Response、中间件链，手工构造对象做单元测试极易漏掉逻辑；真要测 HTTP 行为，得走 HttpServer 模拟完整请求生命周期。

错误写法：$controller = new UserController(); $controller->login(...) —— 绕过中间件、无 session、无 csrf 校验
正确姿势：在 tests/http/LoginTest.php 中用 Webman\Http\Response + Webman\Http\Request 构造请求，再调用 Webman\Server::getInstance()->handle($request)（需提前启动服务或用内存模式）
更稳妥方案：用 GuzzleHttp\Client 对本地 127.0.0.1:8787 发真实请求（需先 php start.php start -d），适合集成验证

最小化接口断言示例（使用 Guzzle）：

$client = new \GuzzleHttp\Client();
$response = $client->post('http://127.0.0.1:8787/api/login', [
    'json' => ['username' => 'test', 'password' => '123456']
]);
$this->assertEquals(200, $response->getStatusCode());
$data = json_decode($response->getBody(), true);
$this->assertArrayHasKey('token', $data);

Webman 单元测试最易被忽略的点，是 support/bootstrap.php 在测试环境里的加载时机 —— 它必须在所有测试类 require 之前执行，且不能被 PHPUnit 的自动扫描机制误当作测试类加载。一旦漏掉或顺序错，后面所有 app()、config()、db() 调用都会静默失败，只留下模糊的 “null” 或 “undefined function” 错误。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！