lolly/internal/converter/nginx/AGENTS.md

nginx

Purpose

nginx 配置转换器，将 nginx.conf 格式转换为 lolly YAML 配置。支持 server、location、upstream、proxy_pass 等核心指令。

Key Files

File	Description
parser.go	nginx 配置解析器：词法分析、语法树构建
converter.go	配置转换器：nginx AST → lolly Config
parser_test.go	解析器测试：各种 nginx 配置格式
converter_test.go	转换器测试：指令映射、警告生成

For AI Agents

Working In This Directory

• 解析器将 nginx 配置文本解析为 NginxConfig AST
• 转换器遍历 AST 生成 config.Config 结构体
• 不支持的指令会生成 Warning 而非错误，允许部分转换
• location 匹配类型映射：= → exact，^~ → prefix_priority，~ → regex，~* → regex_caseless

Testing Requirements

• 运行测试：go test ./internal/converter/nginx/...
• 测试覆盖：完整配置、部分配置、错误处理

Common Patterns

// 解析 nginx 配置
parser := nginx.NewParser(content)
cfg, err := parser.Parse()

// 转换为 lolly 配置
result, err := nginx.Convert(cfg)
// result.Config - 转换后的配置
// result.Warnings - 转换警告

支持的 nginx 指令

指令	转换说明
server	转换为 ServerConfig
listen	转换为 listen 字段
server_name	转换为 name/server_names
location	转换为 ProxyConfig 或 StaticConfig
proxy_pass	转换为代理目标
root/alias	转换为静态文件根目录
upstream	转换为负载均衡目标列表
gzip	转换为压缩配置
ssl_certificate	转换为 SSL 证书配置
rewrite	转换为 URL 重写规则
return 301/302	转换为重定向规则

不支持的指令（生成警告）

• if、map、set - 条件逻辑不支持
• limit_req、limit_conn - 使用 rate_limit 配置替代
• add_header - 使用 security.headers 配置替代
• auth_request - 使用 security.auth_request 配置替代

Dependencies

Internal

• ../../config/ - 配置结构体定义