PHP 应用程序中的日志记录：最佳实践与工具

轻松学习Python，无需理论负担。在浏览器中直接解决带自动检查的实践任务，无需安装任何东西。

PHP 应用程序中的日志记录：最佳实践

日志记录不仅仅是把错误写入文件。它是一个系统性的过程，用于收集、存储和分析应用程序运行信息。在 PHP 开发中，配置良好的日志记录有助于快速发现 Bug、追踪用户行为异常并确保安全审计。本文将探讨 PHP 日志记录的最佳实践，从标准到高级工具。

1. 为什么需要日志记录及基本原则

日志记录解决几个关键任务：

调试 — 记录错误发生时应用程序的状态。
监控 — 追踪性能和负载情况。
安全 — 记录可疑行为（如入侵尝试、未授权访问）。
审计 — 记录关键业务操作。

良好日志记录的基本原则：

不要造假 — 日志必须反映系统的真实状态。
结构化 — 使用统一格式（JSON, key=value）。
重要性级别 — 区分 debug, info, warning, error, critical。
无秘密信息 — 绝不记录密码、令牌和个人数据。

2. PSR-3 标准与 LoggerInterface 接口

PHP-FIG 推荐使用 PSR-3 — 日志库的标准接口。它定义了 8 个级别（从 debug 到 emergency）和一个统一契约。

使用 PSR-3 的实现示例：

<?phpuse Psr\\Log\\AbstractLogger;

class SimpleLogger extends AbstractLogger{    public function log($level, $message, array $context = [])    {        $logEntry = sprintf(            '[%s] %s: %s %s',            date('Y-m-d H:i:s'),            strtoupper($level),            $message,            json_encode($context)        );        file_put_contents('/var/log/app.log', $logEntry . PHP_EOL, FILE_APPEND);    }}

$logger = new SimpleLogger();$logger->info('用户已注册', ['user_id' => 42]);?>

使用 PSR-3 可以轻松替换日志库（例如从 Monolog 切换到自定义实现），而无需修改应用程序代码。

3. Monolog — 强大的日志记录工具

Monolog 是 PHP 最流行的日志库（通过 Composer 安装：composer require monolog/monolog）。它支持多种处理器（handlers）和格式化器。

Monolog 基本配置

<?phpuse Monolog\\Logger;use Monolog\\Handler\\StreamHandler;use Monolog\\Handler\\FirePHPHandler;use Monolog\\Formatter\\LineFormatter;

$logger = new Logger('my_app');

// 文件处理器$fileHandler = new StreamHandler(__DIR__ . '/logs/app.log', Logger::WARNING);$fileHandler->setFormatter(new LineFormatter("[%datetime%] %level_name%: %message% %context%"));$logger->pushHandler($fileHandler);

// 浏览器处理器 (FirePHP)$logger->pushHandler(new FirePHPHandler());

// 使用$logger->warning('权限不足', ['user' => 'guest']);$logger->error('数据库连接错误', ['db_host' => 'localhost']);?>