phpstorm如何配置Codeception测试框架（全栈测试）-phpstorm-PHP中文网

phpstorm 正确支持 codeception 全栈测试的关键是：先执行 codecept build 生成 actor 类，再将项目根目录和 _support 目录标记为 sources root，重载项目索引；运行配置必须用 vendor/bin/codecept 脚本而非 phpunit；测试目录需按 codeception.yml 中 paths.tests 配置精确标记为 tests。

phpstorm如何配置codeception测试框架（全栈测试）

PhpStorm 要真正支持 Codeception 全栈测试（acceptance/functional/unit），关键不是“加插件”或“选框架类型”，而是让 IDE 正确识别动态生成的 Actor 类、走对 autoloader、并用对执行入口——否则补全失效、断点不进、报 Class 'Codeception\PHPUnit\TestCase' not found 都是常态。

为什么 `AcceptanceTester` 红标、`$I->amOnPage()` 没补全

根本原因：PhpStorm 没索引 _support/Actor/AcceptanceTester.php 这类文件。它们由 codecept build 生成，不在初始项目结构里，IDE 不会自动重载。

必须先在终端执行 codecept build（确保 _support/Actor/ 下已生成 AcceptanceTester.php 等文件）
右键点击项目根目录 → Mark Directory as → Sources Root（如果还没标）
右键点击 _support 目录 → Mark Directory as → Sources Root（这步不可跳过，否则 _support/Actor/ 不被解析）
执行 File → Reload project from Disk，等右下角 “Indexing…” 提示消失

常见错觉：测试命令行能跑通，但 PhpStorm 里写 $I-> 没提示——这就是纯索引问题，不是代码写错了。

运行配置必须用 `vendor/bin/codecept`，别碰 PHPUnit 配置项

PhpStorm 内置的 “PHPUnit” 运行配置会强行加载旧版 PHPUnit autoloader，和 Codeception 4+ 的依赖结构冲突，直接触发 Class 'Codeception\PHPUnit\TestCase' not found。

在 Run → Edit Configurations 中新建一个 PHP Script（不是 PHPUnit！）
Script path 填 vendor/bin/codecept（Linux/macOS）或 vendor\bin\codecept.bat（Windows）
Script arguments 填类似 run acceptance LoginCest.php --debug
Working directory 设为项目根目录（含 codeception.yml）

这样启动的进程完全走 Composer autoloader，Actor 类、Helper、模块都能正确加载，断点也能进到 AcceptanceTester 方法内部。

btpanel phpsite 宝塔面板PHP网站

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

下载

测试目录标记和 `codeception.yml` 必须对齐

PhpStorm 的 “Tests” 标记只是给编辑器看的，而 Codeception 运行时只认 codeception.yml 里的 paths: tests: 配置。两者不一致会导致“点运行没反应”或“找不到测试文件”。

检查 codeception.yml 中的 paths: tests: 值（例如 tests/acceptance）
在 PhpStorm 中右键对应目录 → Mark Directory as → Tests（变成绿色图标）
如果用了自定义路径（如 tests/codecept_unit），必须用 codecept bootstrap tests/codecept_unit 初始化，不能只改 yml
避免把 tests 整体标为 Tests；应按 suite 拆分标记（tests/acceptance、tests/functional 各自标）

标记错目录的典型表现：右键某个 *Cest.php 文件 → “Run” 菜单灰掉，或者运行后提示 “No tests executed”。

调试验收测试时，`WebDriver` 模块需额外注意

Acceptance 测试依赖 WebDriver 模块，但 PhpStorm 调试器默认不捕获浏览器进程输出，容易误判为“卡死”或“超时”。

确保 acceptance.suite.yml 中启用了 restart: true 和 clear_cookies: true，避免 session 污染干扰调试
在 Script arguments 里加上 --debug --steps，能看到每步执行日志
如果用 ChromeDriver，确认 chromedriver 在 PATH 中，或在 yml 里显式指定 port 和 url
首次调试前手动跑一次 codecept run acceptance --debug 看终端输出是否正常，再进 PhpStorm 断点