如何在CodeIgniter中使用Newman_CodeIgniterAPI测试自动化【测试】-php教程-PHP中文网

newman 与 codeigniter 无直接集成关系，仅用于测试后者提供的 api 接口；需确保 codeigniter 正确配置路由、禁用 csrf、返回 json 响应，并通过环境变量支持 newman 调用。

如何在codeigniter中使用newman_codeigniterapi测试自动化【测试】

Newman 和 CodeIgniter 是两类工具，**没有直接集成关系**。Newman 是 Postman 的命令行运行器，只负责执行 Postman 导出的集合（.json 格式），它不理解 PHP、不加载 CodeIgniter 框架、也不调用控制器或模型。你不能在 CodeIgniter 项目里“使用 Newman”——而是用 Newman **测试运行在 CodeIgniter 上的 API 接口**。真正要做的，是让 CodeIgniter 提供稳定、可访问的 HTTP 接口，再用 Newman 去调用它们。下面分几个实操关键点说明：

确保 CodeIgniter API 接口可被外部调用

Newman 本质是个 HTTP 客户端，它只认 URL。如果你的 CodeIgniter 接口返回 404、500 或 CORS 拒绝，Newman 就会失败，和 Newman 本身无关。

关闭 index.php 强制重写（如用 Apache，确认 .htaccess 正确且 mod_rewrite 已启用）；否则 Newman 请求 /api/users 会 404
API 路由必须显式定义（例如在 routes.php 中加 $route['api/users'] = 'api/Users::index';），不能依赖默认控制器隐式匹配
禁用 CSRF 验证（或为 API 路由单独跳过）：在 app/Config/Filters.php 中，把 API 路由从 'csrf' 过滤器中排除，否则 Newman POST 请求会因缺少 token 而 403
响应头设置：若 Newman 运行在 CI 环境（如 GitLab CI），建议在控制器中加 header('Content-Type: application/json');，避免框架自动输出 HTML 导致 JSON 解析失败

导出 Postman 集合时注意环境变量与动态值

你在 Postman 里测试 CodeIgniter 接口时，很可能用了 {{base_url}} 或 {{auth_token}} 这类变量。这些变量必须在 Newman 运行时通过 -e 参数传入对应环境文件，否则请求会发到 http://{{base_url}}/api/login 这种非法地址而报错。

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

环境文件（如 env-dev.json）内容必须是合法 JSON：

{
  "id": "dev-env",
  "name": "Development",
  "values": [
    {
      "key": "base_url",
      "value": "http://localhost:8080",
      "enabled": true
    },
    {
      "key": "auth_token",
      "value": "Bearer abc123",
      "enabled": true
    }
  ]
}

运行命令必须带 -e： newman run api-collection.json -e env-dev.json
不要在 Postman 集合中硬编码敏感值（如生产数据库密码），Newman 不做密钥管理——这类值应在 CI 系统中设为 secret 变量，再注入到环境文件生成步骤中

CI 流程中 Newman 与 CodeIgniter 启动需解耦

常见错误是把 Newman 当作“CodeIgniter 插件”来用，试图在 PHP 进程里启动它。正确做法是：CI 先启动一个临时 Web 服务（比如用 PHP 内置服务器），再让 Newman 并行发起请求。

在 GitLab CI / GitHub Actions 中，先用后台命令启动 CodeIgniter：php -S localhost:8080 -t public/ public/index.php &
加等待逻辑（如 sleep 2），确保服务就绪后再运行 newman，否则 Newman 会立即报 ECONNREFUSED
别用 phpunit 和 newman 混跑同一套断言：PHPUnit 测试的是 PHP 逻辑（如模型方法返回值），Newman 测试的是最终 HTTP 表现（如状态码、JSON 字段）。二者目标不同，不可替代
如果接口依赖数据库，CI 中需提前用 mysql -e "CREATE DATABASE..." 初始化 DB，并在 CodeIgniter database.php 中配置好 host/user/pass —— Newman 不管这些，它只管发请求

报告失败时优先排查 CodeIgniter 日志而非 Newman 输出

当 Newman 报 “Status code 500” 或 “Response body is empty”，问题几乎总在 CodeIgniter 侧。Newman 只是信使，它不会告诉你哪行 PHP 报了 Fatal error。

打开 CodeIgniter 的日志（writable/logs/），看最新 log-*.php 文件，里面通常有完整堆栈
临时在控制器开头加 error_log("API endpoint hit");，确认请求是否抵达 PHP 层；如果没日志，说明是 Web 服务器拦截（如 .htaccess 错误、路由未命中）
本地复现：用 curl -v http://localhost:8080/api/users 替代 Newman，能更快暴露是 404（路由问题）、500（PHP 错误）还是响应格式问题
避免在 Newman 测试中验证 HTML 响应体——CodeIgniter 默认可能返回视图页面，而不是 JSON。务必检查控制器是否明确写了 return $this->response->setJSON(...)（CI4）或 echo json_encode(...)（CI3）

Newman 对 CodeIgniter 来说只是个“黑盒 HTTP 客户端”，它的成败完全取决于 CodeIgniter 是否暴露了干净、稳定、无干扰的 API 端点。最容易被忽略的一点是：**CSRF 和路由配置这两个 PHP 层开关，比 Newman 任何参数都关键**。