Psr/Log PHP 完整指南：接口、方法与实战教程

日志记录是任何严肃应用开发中的关键环节。没有日志，就无法在生产环境中调试错误、追踪用户行为或分析系统性能。然而，当项目中使用了多个库，每个库都用自己的方式记录日志时，开发者就会陷入混乱：不同的日志级别、不同的格式、不同的输出方式。为了解决这个问题，PSR-3（日志接口标准）应运而生。

Psr/Log 本身并不是一个日志记录库，而是一个标准接口（一组契约），它定义了 PHP 中通用日志记录器应有的样子。它提供了八个用于记录不同重要性级别消息的方法（emergency、alert、critical、error、warning、notice、info、debug），以及一个通用方法 log()。任何实现了 PSR-3 的库都可以轻松集成到任何期望该接口的项目中。这使得开发者可以在不修改应用代码的情况下更换日志记录器的实现（例如，从 Monolog 切换到 Analog）。

本文将详细解析 psr/log 库，从安装到复杂的实战示例。你将学习如何正确使用每个方法、如何使用占位符格式化消息，以及如何避免常见错误。无论你是刚接触 PHP 的新手，还是希望系统梳理知识的有经验开发者，本文都将为你提供帮助。

安装

psr/log 库通过 Composer（PHP 的标准依赖管理器）安装。在终端中执行以下命令：

composer require psr/log

安装完成后，你的项目中会出现 vendor/psr/log 目录。如果你使用的是框架（如 Laravel、Symfony），PSR-3 很可能已经包含在其中。要在 PHP 脚本中引入自动加载器，请添加以下代码：

require __DIR__ . '/vendor/autoload.php';

请注意：psr/log 只是一个接口。要真正记录日志，你需要一个实现，例如 monolog/monolog。安装 Monolog 的命令如下：

composer require monolog/monolog

快速上手

让我们创建一个使用 Monolog（最流行的 PSR-3 实现）的简单日志记录示例。

<?php
require 'vendor/autoload.php';

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// 创建一个名为 'my_logger' 的日志记录器
$log = new Logger('my_logger');

// 添加处理器：将所有 DEBUG 级别及以上的消息写入 app.log 文件
$log->pushHandler(new StreamHandler(__DIR__ . '/app.log', Logger::DEBUG));

// 记录几条消息
$log->info('应用已启动');
$log->warning('无法加载配置文件，使用默认值');
$log->error('严重错误：数据库不可用');

echo "日志已写入。请检查 app.log 文件。";

执行此脚本后，你将在 app.log 文件中看到类似以下内容：

[2025-04-10T15:30:45.123456+00:00] my_logger.INFO: 应用已启动 [] []
[2025-04-10T15:30:45.123789+00:00] my_logger.WARNING: 无法加载配置文件，使用默认值 [] []
[2025-04-10T15:30:45.124012+00:00] my_logger.ERROR: 严重错误：数据库不可用 [] []

这是一个最小的工作示例。接下来，我们将详细解析接口中的每个方法。