环境变量
Test::Nginx 支持的所有 TEST_NGINX_* 环境变量参考。
核心变量
| 变量 | 默认值 | 说明 |
|---|---|---|
TEST_NGINX_BINARY | nginx | Nginx 可执行文件路径 |
TEST_NGINX_SERVROOT | t/servroot | Nginx 运行目录 |
TEST_NGINX_PORT | 随机 | 测试服务器监听端口 |
TEST_NGINX_SERVER_PORT | 同上 | 服务器端口的别名 |
TEST_NGINX_GLOBALS | 空 | 追加到 http 块的全局配置 |
TEST_NGINX_GLOBALS_HTTP | 空 | 同上（别名） |
执行控制
| 变量 | 默认值 | 说明 |
|---|---|---|
TEST_NGINX_NO_SHUFFLE | 0 | 禁止随机打乱测试顺序 |
TEST_NGINX_NO_ONLY | 0 | 禁用 ONLY 段（用于 CI） |
TEST_NGINX_VERBOSE | 0 | 启用详细输出 |
TEST_NGINX_RANDOMIZE | 1 | 是否随机化测试顺序 |
TEST_NGINX_FIRST_BLOCK_ONLY | 0 | 只运行第一个测试块 |
TEST_NGINX_REUSE_PORT | 0 | 复用端口 |
调试工具
| 变量 | 默认值 | 说明 |
|---|---|---|
TEST_NGINX_USE_VALGRIND | 0 | 使用 Valgrind 运行 |
TEST_NGINX_CHECK_LEAK | 0 | 检查内存泄漏 |
TEST_NGINX_USE_STAP | 0 | 启用 SystemTap |
TEST_NGINX_BENCHMARK | 0 | 进入基准测试模式 |
TEST_NGINX_EVENT_TYPE | 空 | 指定事件模型（epoll 等） |
HTTP/2 和 HTTP/3
| 变量 | 默认值 | 说明 |
|---|---|---|
TEST_NGINX_USE_HTTP2 | 0 | 启用 HTTP/2 测试 |
TEST_NGINX_USE_HTTP3 | 0 | 启用 HTTP/3 (QUIC) 测试 |