PHP日志关键信息详解

在PHP开发中，日志如同程序的“黑匣子”，详细记录运行时每一个关键细节。无论是排查线上故障、分析性能瓶颈，还是监控系统健康度，日志都是开发者最得力的助手。那么，一份高质量的PHP日志究竟应该包含哪些关键信息？下面逐一拆解。

1. 时间戳

事件发生的具体时间，这是日志的“时间轴”。格式通常为 YYYY-MM-DD HH:MM:SS，精确到秒甚至毫秒，才能精准定位问题。

2. 日志级别

日志的“严重程度标记”。从低到高常见的有：DEBUG、INFO、NOTICE、WARNING、ERROR、CRITICAL、ALERT、EMERGENCY。级别可以帮助开发者在海量日志中快速筛选出关键信息。

3. 请求信息

每一次请求的“身份标识”：

• 客户端IP地址
• 请求的URL和方法（GET/POST等）
• 返回的HTTP状态码
• User-Agent字符串（识别客户端类型）

4. 用户信息

谁在操作？记录用户ID或用户名，以及对应的角色、权限，便于审计和追溯。

5. 操作详情

具体干了什么？包括执行的函数或方法名、传入的参数和返回值，甚至操作前后数据的变化。

6. 错误信息

当程序出现异常时，必须记录：

• 异常类型和错误消息
• 错误发生的文件路径和行号——这是定位bug最直接的线索

7. 性能数据

速度与资源是永恒的话题：

• 脚本执行时间（毫秒级）
• 内存使用峰值
• 数据库查询耗时及返回结果集大小（比如哪些查询拖慢了响应）

8. 系统信息

运行环境快照：

• PHP版本
• 服务器操作系统及版本
• Web服务器软件（Nginx/Apache等）及版本

9. 第三方服务交互

与外部API、缓存、消息队列等服务的每一次握手记录：

• 调用是否成功
• 响应时间
• 返回状态码

10. 安全事件

关乎系统安危的事项：

• 登录尝试（成功/失败）
• 权限变更操作
• 异常访问模式（如短时间内大量请求同一接口）

日志格式示例

[2023-04-15 14:30:45] [INFO] User logged in: user123
[2023-04-15 14:31:02] [ERROR] Failed to connect to database: PDOException: SQLSTATE[HY000] [2002] Connection refused
[2023-04-15 14:32:18] [DEBUG] Executing query: SELECT * FROM users WHERE id = 1
[2023-04-15 14:33:05] [WARNING] High memory usage detected: 95%

日志管理建议

光记录还不够，管理更要跟上：

• 定期清理：日志文件过大不仅占用磁盘，还会拖慢写入性能。建议按天或周轮转。
• 分类存储：根据级别或业务模块分开存放，比如错误日志、访问日志、慢查询日志等，便于分析。
• 安全保护：日志中可能包含敏感信息（如用户token、个人数据），必须加密存储，并严格控制访问权限。
• 监控告警：设定阈值，当错误率飙升、响应超时、内存暴增时，自动通知运维或开发者。

合理记录并深度分析这些关键信息，是PHP应用稳定运行和快速迭代的基石。每次线上事故复盘时，你会发现：好的日志胜过千言万语。