PHP 日志记录：初学者的最佳实践

引言：为什么需要在 PHP 中进行日志记录？

日志记录不仅仅是把错误写入文件。它是您监控、调试和分析 Web 应用程序运行情况的主要工具。没有高质量的日志记录，您将只能猜测网站为何崩溃，或者用户为何无法完成订单。对于 PHP 初学者来说，配置正确的日志记录是迈向专业开发的第一步。

想象一下，您的应用程序是一个黑匣子。日志是您窥探内部、了解每一刻正在发生什么的唯一途径。在本文中，我们将介绍一些最佳实践，帮助您避免新手常见错误，并构建一个可靠的监控系统。

1. 基础：PHP 内置的日志记录函数

PHP 提供了几个用于处理日志的内置函数。最简单且最流行的是 error_log()。它允许将消息发送到服务器系统日志或指定的文件。

error_log() 的基本使用示例

// 最简单的错误记录到系统日志error_log("这是一个错误消息", 0);

// 记录到特定文件error_log("数据库连接错误", 3, "/var/log/php_errors.log");

// 指定消息类型的记录error_log("警告：慢查询", 4);

然而，在生产环境中直接使用 error_log() 并不是一个好主意。首先，您会将不同类型的消息混在一起。其次，很难管理日志格式和轮转。对于严肃的项目，最好使用专门的库。

配置 php.ini 以改进日志记录

在编写代码之前，请确保您的 php.ini 配置正确：

; 开启错误日志记录log_errors = On; 日志文件路径error_log = /var/log/php_errors.log; 日志最大大小（字节）log_errors_max_len = 1024; 关闭屏幕错误输出（用于生产环境）display_errors = Off; 开启所有级别的错误日志记录error_reporting = E_ALL

2. 日志级别：从 DEBUG 到 CRITICAL

新手常犯的一个主要错误是将所有消息混在一起记录。专业的日志记录使用严重性级别。这有助于快速过滤日志，并且不会在信息性消息中遗漏关键错误。

标准 PSR-3 日志级别

PHP 社区采用了 PSR-3 标准，该标准定义了 8 个日志级别：

• DEBUG — 详细的调试信息（仅在开发中使用）
• INFO — 信息性消息（用户已注册，订单已创建）
• NOTICE — 正常但重要的事件（使用了已弃用的函数）
• WARNING — 警告（例如，慢查询，磁盘空间不足）
• ERROR — 需要关注的错误（无法连接到数据库）
• CRITICAL — 关键错误（系统主要组件不可用）
• ALERT — 需要立即干预（入侵，系统故障）
• EMERGENCY — 系统无法运行

使用 Monolog 实现日志级别的示例

PHP 中最好的日志记录库是 Monolog。它完全符合 PSR-3 标准，并且易于配置：

use Monolog\\Logger;use Monolog\\Handler\\StreamHandler;use Monolog\\Handler\\RotatingFileHandler;use Monolog\\Level;

// 创建一个带有频道名称的日志记录器$log = new Logger('app');

// 为所有级别添加处理器$log->pushHandler(new StreamHandler('/var/log/app.log', Level::Debug));

// 为关键错误单独创建文件$log->pushHandler(    new RotatingFileHandler('/var/log/critical.log', 30, Level::Critical));

// 和