如何设置ThinkPHP项目中Mock数据存放的规范目录？

本文共计875个文字，预计阅读时间需要4分钟。

ThinkPHP 框架本身没有约定测试数据目录，可以使用 phpunit 进行测试，但需要手动加载数据路径。若将 JSON 或 YAML 文件丢失到 tests/fixtures 或 tests/data 目录，框架将无法读取逻辑，导致错误：

推荐统一放在 tests/_data（下划线前缀避免被 PSR-4 扫描到），但必须显式构造路径：

• __DIR__ . '/_data/user_mock.json' 是安全写法；用 base_path('tests/_data/...') 会报错，因为 base_path() 默认只认 app、public 等核心目录
• 别依赖 getcwd()，CI 环境下工作目录可能是 / 或 /tmp，路径直接失效
• 如果用 think-orm 的 MockConnection，SQL 模拟数据建议直接写在测试方法里，而不是从文件读——省去 I/O 开销，也避开路径问题

tests/Feature 和 tests/Unit 下的 Mock 数据要不要分开？

要分，但不是按“功能”或“单元”分，而是按「数据复用粒度」分：共享结构用 tests/_data/shared/，单测独占用 tests/Unit/SomeTest/_data/。

• tests/_data/shared/order_status.php 存通用状态映射，多个测试类 require_once 即可
• tests/Unit/UserServiceTest/_data/create_user_payload.php 只服务于这个测试类，重构时删它不波及其他
• 切忌把所有 mock 数组塞进 TestCase 基类的 protected $mockData = [] —— 类一多，内存占用涨，且无法做类型提示

JSON/YAML/PHP 数组，哪种格式更适合 ThinkPHP 测试数据？

优先用 .php 文件返回数组，其次 .json，避开 .yaml。

立即学习“PHP免费学习笔记（深入）”；

• .php 支持注释、条件分支、调用 fake() 构造器，比如：

  return [ 'name' => fake()->name(), 'created_at' => now()->subDays(rand(1, 30))->toDateTimeString(), ];

• .json 不能动态生成，但利于前端同学核对结构；注意 UTF-8 BOM 会导致 json_decode() 返回 null
• .yaml 需额外装 symfony/yaml，而 ThinkPHP 8.0+ 默认不带，CI 构建容易卡在 Class "Symfony\Component\Yaml\Yaml" not found

数据库 Seed 数据和 Mock 数据混着用，会出什么问题？

会污染测试隔离性。Seed 是面向迁移的初始化数据，Mock 是面向单次断言的可控输入——两者生命周期、作用域、清理方式完全不同。

• 用 Db::table('users')->insert() 在测试里插数据，没配事务回滚的话，下次测试可能查到上一轮残留
• 想验证「创建用户失败时返回 422」，却用 Seed 插了一条邮箱已存在的记录，错误其实是 500（唯一索引冲突），而非预期的业务校验逻辑
• 真正需要 DB 状态时，用 DatabaseTransactions trait 或 RefreshDatabase，而不是靠 Seed 文件“凑出”某个中间态

Mock 数据的本质是控制变量，不是模拟真实业务流。越早意识到这点，越少在 CI 上花时间排查“为什么本地过、线上挂”。