3ba9fcea62
- 新增 access_log.c / access_log.h：Nginx combined 格式，线程安全 - cocoon.h / config.c / config.h：支持 access_log 配置字段 - main.c：新增 --access-log CLI 选项，'-' 表示 stdout - server.c：connection_t 扩展 client_addr/addr_len/response_status - server.c：handle_request 中记录 response_status 并调用 access_log_write - Makefile：加入 access_log.c，更新单元测试编译规则 - cocoon.json：示例配置添加 access_log - 集成测试：新增 5 项访问日志测试 - 59 项集成测试全部通过，35 个单元测试全部通过
59 lines
1.6 KiB
C
59 lines
1.6 KiB
C
/**
|
||
* access_log.h - 访问日志模块接口
|
||
*
|
||
* 提供类似 Nginx combined 格式的访问日志记录。
|
||
* 格式: %h %l %u %t "%r" %s %b "%{Referer}i" "%{User-Agent}i"
|
||
*
|
||
* @author xfy
|
||
*/
|
||
|
||
#ifndef COCOON_ACCESS_LOG_H
|
||
#define COCOON_ACCESS_LOG_H
|
||
|
||
#include <stdbool.h>
|
||
#include <stddef.h>
|
||
#include <stdint.h>
|
||
#include <sys/socket.h>
|
||
#include "http.h"
|
||
|
||
/**
|
||
* access_log_init - 初始化访问日志
|
||
*
|
||
* 打开日志文件（如果 path 为 NULL 或 "-"，则输出到 stdout）。
|
||
* 线程安全：使用内部互斥锁保护。
|
||
*
|
||
* @param path 日志文件路径，NULL 或 "-" 表示 stdout
|
||
* @return 0 成功，-1 失败
|
||
*/
|
||
int access_log_init(const char *path);
|
||
|
||
/**
|
||
* access_log_close - 关闭访问日志
|
||
*
|
||
* 刷新并关闭日志文件。
|
||
*/
|
||
void access_log_close(void);
|
||
|
||
/**
|
||
* access_log_is_enabled - 检查访问日志是否已启用
|
||
*
|
||
* @return true 已启用
|
||
*/
|
||
bool access_log_is_enabled(void);
|
||
|
||
/**
|
||
* access_log_write - 写入一条访问日志记录
|
||
*
|
||
* 格式: 192.168.1.1 - - [05/Jun/2026:00:00:00 +0800] "GET /index.html HTTP/1.1" 200 1234 "-" "Mozilla/5.0"
|
||
*
|
||
* @param client_addr 客户端地址（sockaddr 结构体）
|
||
* @param addr_len 地址长度
|
||
* @param req HTTP 请求指针（实际类型为 http_request_t *，在 http.h 定义）
|
||
* @param status_code HTTP 响应状态码
|
||
* @param response_bytes 响应体字节数（-1 表示未知）
|
||
*/
|
||
void access_log_write(const struct sockaddr *client_addr, socklen_t addr_len,
|
||
const http_request_t *req, int status_code, int64_t response_bytes);
|
||
|
||
#endif /* COCOON_ACCESS_LOG_H */
|