PHP 应用程序的监控与日志记录：如何不错过任何错误

面向初学者的在线Python训练器

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

开始课程

你的 PHP 应用不会说话，它在尖叫

想象一下，你是一艘宇宙飞船的船长。你的任务是飞往火星。但飞船上没有仪表盘，没有传感器，甚至连一个“紧急警报”按钮都没有。你只能凭运气飞行。这大致就是那些在没有监控和日志记录的情况下，将 PHP 应用部署到生产环境的开发者的感受。

用户看到的是“500 Internal Server Error”，而你看到的只是一片空白的日志屏幕。熟悉吗？如果不熟悉，那么你要么是天才，要么只是还没遇到过凌晨三点生产服务器宕机的情况。

在本文中，我们将探讨如何将你的 PHP 应用从一个“黑盒”转变为一个透明的系统，让它自己告诉你哪里出了问题以及为什么。我将展示真实的代码、最佳实践以及大型项目在生产环境中使用的工具。我们开始吧。

为什么 PHP 中的日志记录不仅仅是“echo”

许多新手认为日志记录就是：

echo "这里出错了: " . $error;

剧透：这在生产环境中行不通。用户会在屏幕上看到这些“精彩”内容。而如果是致命错误，你根本什么都不会知道。

真正的日志记录是结构化的数据收集，这些数据可以被分析、搜索，并能实时响应。PHP 提供了基本函数（error_log()、syslog()），但在现代世界中，这远远不够。

一个好的日志应该包含什么？

严重级别 — DEBUG, INFO, WARNING, ERROR, CRITICAL
时间戳 — 事件的精确时间（最好使用 UTC）
上下文 — 用户 ID, IP, URL, 请求数据
调用栈 — 错误追踪信息
唯一请求标识符 — 用于关联同一操作的所有日志

Monolog — PHP 日志记录的标准

如果你用 PHP 编程却没有使用 Monolog — 那你就是在浪费时间。这是事实上的日志记录标准，被 Symfony、Laravel 以及大多数现代框架所支持。

为什么 Monolog 很酷？

灵活的“处理器”（handlers） — 可以写入文件、数据库、Telegram、Slack、电子邮件
格式化器 — JSON, HTML, Syslog
处理器 — 自动添加上下文

安装与基本示例

composer require monolog/monolog

现在我们来编写一个简单的日志记录器：

<?phprequire 'vendor/autoload.php';

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

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

// 写入文件$log->pushHandler(    new StreamHandler(__DIR__ . '/logs/app.log', Level::Debug));

// 严重错误 — 发送到 Telegram$log->pushHandler(    new TelegramBotHandler(        'YOUR_BOT_TOKEN',        'YOUR_CHAT_ID',        Level::Critical    ));

// 使用$log->info('用户已登录', ['user_id' => 123]);$log->error('数据库不可用', ['db_host' => 'localhost']);

请注意：我们对不同级别使用了不同的处理器。所有内容（调试信息）都写入文件，而只有严重错误才发送到 Telegram。这样既能避免通知轰炸，又不会错过真正的问题。