run.php 6.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162
  1. <?php
  2. /**
  3. * api-test 入口:装配配置 → 加载用例 → 运行 → 报告。
  4. *
  5. * 用法:
  6. * php run.php [--server=<alias|URL>] [--token=<bearer>] [--username=<u> --password=<p>]
  7. * [--admin-token=<bearer>] [--admin-username=<u> --admin-password=<p>] [--filter=<子串>] [--list]
  8. *
  9. * 例:
  10. * php run.php # 默认 local
  11. * php run.php --server=staging
  12. * php run.php --server=https://foo/api
  13. * php run.php --filter=search
  14. * php run.php --list # 列出可用服务器
  15. * php run.php --username=alice --password=secret # 调 /v3/sessions 换 token
  16. *
  17. * 退出码:0 全绿;1 有失败/错误;2 参数或加载错误。
  18. */
  19. error_reporting(E_ALL & ~E_DEPRECATED);
  20. $opts = [];
  21. foreach (array_slice($argv, 1) as $arg) {
  22. if (preg_match('/^--([^=]+)(?:=(.*))?$/', $arg, $m)) {
  23. $opts[$m[1]] = $m[2] ?? true;
  24. }
  25. }
  26. // --list:只打印服务器清单
  27. if (isset($opts['list'])) {
  28. $cfg = require __DIR__ . '/config.php';
  29. echo "可用服务器(--server=alias,默认 {$cfg['default_server']}):\n";
  30. foreach ($cfg['servers'] as $alias => $url) {
  31. printf(" %-8s %s\n", $alias, $url);
  32. }
  33. echo "\n也可直接 --server=<完整 base URL>。\n";
  34. exit(0);
  35. }
  36. // 解析服务器
  37. $config = require __DIR__ . '/config.php';
  38. $servers = $config['servers'];
  39. $serverArg = is_string($opts['server'] ?? null) ? $opts['server'] : null;
  40. $envBase = getenv('API_TEST_BASE') ?: null;
  41. // 除了 base_url,还要记下对应的 alias($serverKey),好去 config.local.php 的
  42. // servers[alias] 里选账号 / token / 种子数据。完整 URL 会反查 alias。
  43. $serverKey = null;
  44. if ($envBase !== null) {
  45. $config['base_url'] = rtrim($envBase, '/');
  46. $serverKey = array_search($config['base_url'], $servers, true) ?: null;
  47. } elseif ($serverArg !== null && isset($servers[$serverArg])) {
  48. $config['base_url'] = $servers[$serverArg];
  49. $serverKey = $serverArg;
  50. } elseif ($serverArg !== null && preg_match('#^https?://#', $serverArg)) {
  51. $config['base_url'] = rtrim($serverArg, '/');
  52. $serverKey = array_search($config['base_url'], $servers, true) ?: null;
  53. } elseif (isset($servers[$config['default_server']])) {
  54. $config['base_url'] = $servers[$config['default_server']];
  55. $serverKey = $config['default_server'];
  56. } else {
  57. // config.local.php 的 default_server 也可以直接写完整 base URL
  58. $config['base_url'] = rtrim($config['default_server'], '/');
  59. $serverKey = array_search($config['base_url'], $servers, true) ?: null;
  60. }
  61. // 按实际 server 选 config.local.php 的 per-server 块(账号 / token / 种子数据跟着 server 走)
  62. $localServers = $config['local_servers'] ?? null;
  63. if (is_array($localServers) && $serverKey !== null && isset($localServers[$serverKey])) {
  64. $block = $localServers[$serverKey];
  65. $config['token'] = $block['token'] ?? $config['token'];
  66. $config['username'] = $block['username'] ?? $config['username'];
  67. $config['password'] = $block['password'] ?? $config['password'];
  68. $config['fixtures'] = $block['fixtures'] ?? $config['fixtures'];
  69. foreach (['admin_token', 'admin_username', 'admin_password'] as $key) {
  70. $config[$key] = $block[$key] ?? $config[$key];
  71. }
  72. }
  73. $config['server_key'] = $serverKey;
  74. // 环境变量覆盖(高于 config.local.php,低于命令行)
  75. $config['token'] = getenv('API_TEST_TOKEN') ?: $config['token'];
  76. $config['username'] = getenv('API_TEST_USERNAME') ?: $config['username'];
  77. $config['password'] = getenv('API_TEST_PASSWORD') ?: $config['password'];
  78. $config['admin_token'] = getenv('API_TEST_ADMIN_TOKEN') ?: $config['admin_token'];
  79. $config['admin_username'] = getenv('API_TEST_ADMIN_USERNAME') ?: $config['admin_username'];
  80. $config['admin_password'] = getenv('API_TEST_ADMIN_PASSWORD') ?: $config['admin_password'];
  81. // 命令行覆盖(最高优先级)
  82. if (is_string($opts['token'] ?? null) && $opts['token'] !== '') {
  83. $config['token'] = $opts['token'];
  84. }
  85. if (is_string($opts['username'] ?? null) && $opts['username'] !== '') {
  86. $config['username'] = $opts['username'];
  87. }
  88. if (is_string($opts['password'] ?? null) && $opts['password'] !== '') {
  89. $config['password'] = $opts['password'];
  90. }
  91. foreach (['admin_token', 'admin_username', 'admin_password'] as $key) {
  92. $flag = str_replace('_', '-', $key);
  93. if (is_string($opts[$flag] ?? null) && $opts[$flag] !== '') {
  94. $config[$key] = $opts[$flag];
  95. }
  96. }
  97. $GLOBALS['config'] = $config;
  98. $GLOBALS['fixtures'] = array_replace(require __DIR__ . '/fixtures.php', $config['fixtures']);
  99. require __DIR__ . '/src/bootstrap.php';
  100. // 没给 token 但给了账号密码 → 调 /v3/sessions 现换一个
  101. if (empty($config['token']) && $config['username'] && $config['password']) {
  102. try {
  103. $config['token'] = login($config['username'], $config['password']);
  104. $GLOBALS['config']['token'] = $config['token'];
  105. echo "已用 {$config['username']} 登录(/v3/sessions)换取 token\n\n";
  106. } catch (Fail $e) {
  107. echo "登录失败:{$e->getMessage()}(需登录的用例将 FAIL)\n\n";
  108. }
  109. }
  110. // 加载用例
  111. $caseFiles = glob(__DIR__ . '/cases/*.php') ?: [];
  112. sort($caseFiles);
  113. foreach ($caseFiles as $file) {
  114. require $file;
  115. }
  116. $tests = $GLOBALS['__tests'];
  117. $filter = is_string($opts['filter'] ?? null) ? $opts['filter'] : null;
  118. $pass = $fail = $skip = $error = 0;
  119. $start = microtime(true);
  120. printf("目标服务器: %s\n\n", $config['base_url']);
  121. foreach ($tests as [$name, $fn]) {
  122. if ($filter !== null && ! str_contains($name, $filter)) {
  123. continue;
  124. }
  125. try {
  126. $fn();
  127. $pass++;
  128. echo " ✅ PASS {$name}\n";
  129. } catch (Skip $e) {
  130. $skip++;
  131. echo " ⏭️ SKIP {$name} ({$e->getMessage()})\n";
  132. } catch (Fail $e) {
  133. $fail++;
  134. echo " ❌ FAIL {$name}\n {$e->getMessage()}\n";
  135. } catch (Throwable $e) {
  136. $error++;
  137. echo " 💥 ERROR {$name}\n " . get_class($e) . ': ' . $e->getMessage() . "\n";
  138. }
  139. }
  140. $total = $pass + $fail + $skip + $error;
  141. $elapsed = round(microtime(true) - $start, 2);
  142. printf("\n%d 用例:%d 通过 / %d 失败 / %d 跳过 / %d 错误(%.2fs)\n", $total, $pass, $fail, $skip, $error, $elapsed);
  143. exit($fail === 0 && $error === 0 ? 0 : 1);