xfy
4562dd5a7d
deepinit 生成的子目录级 AGENTS.md 文件，帮助 AI agents 理解各功能模块： - docs/config/: advanced, basic, caching, load-balancing, lua, rewriting, security, ssl - docs/lua/: api-gateway, authentication, caching, dynamic-routing, logging-monitoring, middleware, rate-limiting, websocket Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1.4 KiB
1.4 KiB
lua
Purpose
Lua 配置示例目录，包含 Lua 脚本集成、各阶段钩子、共享字典等 Lua 功能配置。
Key Files
| File | Description |
|---|---|
basic-lua.conf |
基础 Lua 配置：脚本加载、基本语法 |
access-by-lua.conf |
access 阶段 Lua：访问控制、认证检查 |
content-by-lua.conf |
content 阶段 Lua：动态内容生成 |
balancer-by-lua.conf |
负载均衡 Lua：动态上游选择 |
shared-dict.conf |
共享字典：进程间数据共享、缓存 |
For AI Agents
Working In This Directory
- Lua 钩子按 nginx 处理阶段执行：rewrite → access → content
- 共享字典用于进程间数据共享，适合缓存场景
- Lua 代码在沙箱中执行，有安全限制
- 参考 OpenResty 风格的 ngx API
Testing Requirements
- Lua 脚本通过集成测试验证
- 运行测试：
go test ./internal/lua/...
Common Patterns
- 访问控制：
access_by_lua_block { ... } - 动态内容：
content_by_lua_block { ngx.say(...) } - 共享字典：
lua_shared_dict cache 10m
Dependencies
Internal
../../../internal/lua/- Lua 脚本引擎实现../../../docs/lua-nginx-module/- lua-nginx-module 文档参考
External
github.com/yuin/gopher-lua- Go Lua 解释器