thinkphp可通过自定义accesslog日志驱动、配置专用日志通道、在中间件中统一记录及输出json格式实现标准access_log功能。

如果您在ThinkPHP项目中需要记录类似Web服务器access_log的请求访问日志(如客户端IP、请求路径、响应状态、耗时等),但默认日志系统不直接提供标准access_log格式支持,则需通过自定义日志通道与格式化逻辑实现。以下是配置ThinkPHP AccessLog风格日志格式的具体方法:
一、创建自定义AccessLog日志驱动类
该方法通过扩展ThinkPHP日志驱动,实现结构化、可解析的access_log风格输出,包含时间、IP、方法、URI、状态码、响应体大小、耗时等字段。
1、在 app/driver/log 目录下新建 AccessLog.php 文件(若目录不存在请手动创建)。
2、在文件中定义 AccessLog 类,继承 hinklogdriverFile 并重写 write 方法。
3、在 write 方法中提取请求上下文:使用 hinkacadeRequest::ip() 获取客户端IP, hinkacadeRequest::method() 获取HTTP方法, hinkacadeRequest::url() 获取完整URL, hinkacadeResponse::getCode() 获取响应状态码, hinkacadeResponse::getContent() 获取响应内容长度,结合 microtime(true) 计算请求耗时。
4、按固定分隔格式拼接日志行,例如:[Y-m-d H:i:s] IP "METHOD URI HTTP/1.1" STATUS BODY_BYTES TIME_MS。
5、调用父类 write 方法将格式化后的字符串写入日志文件。
二、配置日志通道启用AccessLog驱动
该方法通过修改日志通道配置,将特定通道绑定至自定义AccessLog驱动,实现按需启用访问日志记录。
1、打开 app/config/log.php 配置文件。
2、在 'channels' 数组中新增名为 'access' 的通道配置项。
3、设置 'type' 为 'app\driver\log\AccessLog'(注意命名空间反斜杠转义)。
4、指定 'path' 为独立目录,例如 'runtime/log/access/',避免与普通日志混杂。
5、设置 'single' 为 false,启用按日期分割日志文件;设置 'max_files' 限制保留天数。
三、在中间件中统一记录AccessLog
该方法利用ThinkPHP中间件机制,在请求生命周期末尾自动采集并写入access_log格式日志,确保每条HTTP请求均有对应记录。
1、执行命令生成中间件:php think make:middleware AccessLogMiddleware。
2、在中间件 handle 方法开头记录起始时间戳到 Request 属性或 Context 中。
3、在 return $next($request); 后添加日志写入逻辑,获取当前请求与响应对象。
4、构造日志内容字符串,字段包括:当前时间、客户端IP、请求方法、请求URI、HTTP协议版本、响应状态码、响应体字节数、总耗时(毫秒)。
5、调用 hinkacadeLog::channel('access')->info($logLine) 写入日志。
6、在 app/middleware.php 全局中间件列表中注册该中间件,置于最后位置以确保响应已生成。
四、使用JSON格式输出结构化AccessLog
该方法将access_log内容序列化为标准JSON,便于ELK、Loki等日志系统自动解析字段,提升可观测性与查询效率。
1、在自定义日志驱动或中间件中,不再拼接文本字符串,而是构建关联数组:
2、键名严格对应通用字段:例如 'timestamp'(ISO8601)、'remote_addr'、'method'、'uri'、'status'、'body_bytes_sent'、'request_time_ms'、'user_agent'、'referer'。
3、使用 json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) 序列化。
4、将JSON字符串作为日志消息传入 Log::info() 或 Log::write(),并确保日志通道配置中 'json'=>true 已启用。
5、验证输出是否为单行合法JSON,无换行或编码乱码。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











