19c97ae6a9
- test_load_invalid_field_type: 字段类型非法（port 为字符串），验证不 crash - test_load_log_level_invalid: 非法 log_level 值保持默认 INFO - test_load_nested_ignored: 嵌套对象——极简解析器返回 false 但不 crash - test_load_array_ignored: 数组——同上，不 crash 即可 - test_merge_cmdline_null_root_dir: cmdline root_dir 为 NULL 时不覆盖 base
4.3 KiB
4.3 KiB
Cocoon 发展规划（自主维护）
此文件由 cron 任务每3小时更新，记录项目状态与下一步计划。
路线图
Phase 1 — 核心稳定（当前）
- HTTP/1.1 请求解析
- 响应头格式化
- 静态文件服务（sendfile）
- 目录浏览
- Range 请求
- MIME 类型识别
- 多线程 M:N 调度
- 命令行参数
- 优雅关闭
Phase 2 — 健壮性
- HTTP 缓存（ETag / Last-Modified / If-None-Match）✅ 2026-06-03
- 连接超时管理（空闲连接自动清理）✅ 2026-06-03
- 最大并发连接数限制 ✅ 2026-06-03
- 分级日志系统（error / warn / info / debug）✅ 2026-06-03
- Gzip 压缩 ✅ 2026-06-03（已接入响应流程）
- 集成测试 suite（30 项 curl/bash 测试全部通过）✅ 2026-06-03
- 性能基准（wrk: ~16.2K RPS / ~60μs 延迟）✅ 2026-06-03
- 请求体解析（POST 支持）✅ 2026-06-03
- Content-Length 读取
- JSON / form-urlencoded 回显
- multipart/form-data 文件上传（保存到 root_dir/uploads/）✅ 2026-06-04
- C 语言单元测试框架 ✅ 2026-06-03（Unity 框架，99 个测试全部通过）
Phase 3 — 扩展
- 配置文件支持（JSON / YAML）
- 虚拟主机 / 多站点
- 反向代理支持
- HTTPS / TLS
- HTTP/2
Phase 4 — 生态
- WebSocket 支持
- 中间件机制
- 插件系统
当前状态
- 编译通过，零警告（除 coco 子模块的 linker .note.GNU-stack 提示）
- 32 项集成测试全部通过（GET/HEAD/POST/404/Range/304/gzip/MIME/目录浏览/路径防护/文件上传）
- 99 个单元测试全部通过（Unity 框架，覆盖 http.c / static.c / multipart.c 核心逻辑）
- 压测数据：wrk -t4 -c100 -d10s → 16,179 RPS，平均延迟 59.86μs
- POST 支持：JSON 和 form-urlencoded 回显，multipart 文件上传，Content-Length 解析，8MB 上限
- README / Makefile 已更新
待办池
- Brotli 压缩 — 在 Gzip 基础上添加 br 支持
- 配置文件支持 — JSON/YAML 配置替代纯命令行
- server.c 单元测试 — 需要 mock socket 和 coco 协程环境
- 性能优化 — io_uring 性能调优、连接池优化
- HTTPS / TLS — 添加 SSL 支持
最近行动记录
- 2026-06-04: 本轮行动 — multipart 文件上传
- 实现
multipart.c/multipart.h：boundary 提取、multipart 解析、part 内存管理 server.c集成：POST 请求检测 multipart，保存文件到root_dir/uploads/- 修复 boundary 解析条件（
>= b_len替代> b_len），修复边界扫描越界 - 创建
tests/unit/test_multipart.c（12 个测试）：boundary 提取、解析、边界条件 - 修复集成测试 CRLF 问题：使用
printf生成真实 CRLF 字节 - 集成测试 32 项全部通过，单元测试 99 个全部通过
- 推送到 main
- 实现
- 2026-06-03: 项目初始化，核心模块全部实现
- 2026-06-03: 添加缓存协商（ETag + Last-Modified + 304），修复编译警告
- 2026-06-03: 添加连接空闲超时管理 + 最大并发限制 + 分级日志系统
- 2026-06-03: 创建集成测试套件 + 性能基准 + 更新文档
- 2026-06-03: 添加 POST 请求体解析支持，30 项测试全部通过，README 更新
- 2026-06-03: 本轮行动 — 单元测试框架
- 引入 Unity 测试框架（ThrowTheSwitch）
- 创建
tests/unit/test_http.c（35 个测试）：- 请求解析：方法、路径、头部、Range、缓存、编码、边界条件
- 响应格式化：状态行、缓存头、Range、缓冲区溢出
- MIME 类型：常见类型、大小写、无扩展名、特殊类型
- 内存管理：请求体释放
- 创建
tests/unit/test_static.c（31 个测试）：- 压缩判断：文本/二进制/空值
- 时间处理：格式化、解析、边界
- ETag：生成、匹配（精确/弱/通配符/空值）
- 路径安全：正常拼接、路径遍历、空值、边界
- HTML 转义：特殊字符、缓冲区溢出
- gzip 压缩：可压缩/不可压缩/小数据/溢出
- socket 层：send_all、错误响应（404/500/未知）
- 更新 Makefile：
make unit-test一键编译运行 - 66 个测试全部通过，集成测试保持 30 项通过
- 推送到 main