1c3e04afdb
docs(lua): 为 Lua API 模块添加标准化 godoc 注释
...
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-20 11:23:03 +08:00
ad177e9640
docs(lua): 为 Lua API 模块添加标准化 godoc 注释
...
为所有 Lua API 文件添加完整的包级和函数级文档注释：
- api_balancer: 负载均衡 API（set_current_peer, set_more_tries 等）
- api_ctx: 请求上下文存储 API（ngx.ctx）
- api_location: 子请求捕获 API（ngx.location.capture）
- api_log: 日志输出 API（ngx.log）
- api_req: 请求对象 API
- api_resp: 响应对象 API
- api_shared_dict: 共享字典 API
- api_socket_tcp: TCP socket API
- api_timer: 定时器 API
- api_var: 变量 API
- engine: Lua 引擎核心
- context: 请求上下文管理
- coroutine: 协程调度器
- middleware: 中间件集成
- filter_writer: 响应过滤器
- cache: Lua 脚本缓存
- shared_dict: 共享字典实现
- socket_manager: socket 连接管理
注释格式遵循 Go 官方风格，包含功能说明、参数说明和注意事项。
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-20 10:59:17 +08:00
9d95aecd6f
refactor(lua): 提取常量并优化结构体字段布局
...
- api_var.go: 提取 argPrefix 常量，消除魔法字符串
- coroutine.go: 按逻辑分组重排 LuaCoroutine 字段，改善可读性
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-16 18:24:05 +08:00
f123018f2d
feat(lua): 增强变量 API 支持数值类型返回和测试覆盖
...
- 新增 getVariableLua 方法返回 Lua 类型而非字符串
- request_length 等变量返回数值类型而非字符串
- luaVarNewIndex 支持 nil 值转换为空字符串
- 添加 api_var 全面的单元测试覆盖
- 添加 api_ctx 上下文 API 测试
- 添加 api_socket_tcp TCP socket 测试
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-16 18:12:16 +08:00
8b382606df
Merge branch 'lint-fix' - resolve sendfile.go conflict
...
Conflict: sendfile.go (!linux build tag) was incorrectly modified to
include linuxSendfile and getSocketFd functions which already exist
in sendfile_linux.go.
Resolution: Keep HEAD version (simple fallback returning ENOTSUP) as
Linux implementation is properly separated in sendfile_linux.go.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 09:26:48 +08:00
a87640defb
feat(lua): 实现定时器调度器线程隔离
...
定时器回调在专用 Scheduler LState 中执行，避免并发问题：
- TimerManager 使用回调队列 + 专用 goroutine 执行
- 拒绝带 upvalue 的回调，防止闭包数据竞争
- 优雅关闭：排空队列后退出调度器
- Engine 支持 InitSchedulerLState 和 CloseScheduler
实现 scheduler 模式标志和 API 注册机制。
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-13 09:24:43 +08:00
7f2939a7e0
feat(lua): 集成共享字典、定时器和子请求到引擎
...
扩展 LuaEngine 以支持新的 ngx API：
- 添加 SharedDictManager/TimerManager/LocationManager
- 在 setupNgxAPI 中注册 ngx.shared/timer/location API
- 实现优雅关闭时清理定时器和共享字典
- 提供管理器访问方法和便捷创建接口
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-12 11:21:39 +08:00
b31733f233
refactor(lua): 简化 ngx API 表注册流程
...
将 ngx 表的创建和全局设置提前，避免各 API 注册时重复检查表是否存在。
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-11 13:34:26 +08:00
6b9df86217
feat(lua): 扩展 ngx.req API 并集成所有 ngx API 到沙箱
...
扩展 API: set_uri, set_uri_args, get_headers, set_header, clear_header, get_body_data, read_body
在 coroutine.SetupSandbox() 中统一注册 ngx.req/resp/var/ctx/log/socket API
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-11 12:17:35 +08:00
7156bbc82f
refactor(lua): 改进代码风格和文档注释
...
- 为 LuaEngine/LuaContext/LuaCoroutine 添加命名说明注释
- 为 Phase 常量添加文档注释
- 规范 import 排序顺序
- 处理 Write 返回值避免 lint 警告
- 修复文件末尾换行符
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-10 16:55:38 +08:00
aa05d6b965
feat(lua): 在沙箱中阻止危险的协程创建函数
...
添加 setupSecureCoroutineLib 函数，在沙箱环境中拦截 coroutine.create/wrap/resume/running，
仅保留 yield/status 安全函数。防止脚本创建不受控制的协程。
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-10 14:56:13 +08:00
7a66e350f0
feat(lua): 添加 Lua 脚本嵌入支持
...
- 基于 gopher-lua 实现类似 OpenResty 的脚本嵌入能力
- LuaEngine: server 级单 LState + 请求级临时协程
- LuaContext: 请求上下文，变量存储和阶段管理
- LuaCoroutine: 沙箱隔离，Yield/Resume 循环，执行超时
- CodeCache: 字节码缓存，LRU 淘汰 + TTL 过期
- 新增 testify 用于测试断言
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-10 14:19:03 +08:00
