Repolode
Seldaek

Seldaek/monolog

PHP 日志库,可将日志发送到文件、套接字、邮件、数据库及多种 Web 服务,实现 PSR-3 接口。

Star
21,403
Fork
1,919
未关闭 Issue
12
最近提交
18天前

这是什么?

Monolog 是一个 PHP 日志库,通过不同的 Handler 把日志记录发送到文件、套接字、邮箱、数据库以及多种 Web 服务等目标。借助特殊的 Handler,还可以组合出更复杂的日志策略。

该库实现了 PSR-3 日志接口,因此其他库可以直接面向该接口编程,应用也能在之后方便地替换为其他兼容的日志实现。日志级别沿用 Monolog 自身的体系,同时公共 API 也接受 PSR-3 级别。

3.x 版本要求 PHP 8.1 及以上,旧版 PHP 可使用 2.x 或 1.x 分支。Symfony、Laravel 和 Lumen 已内置 Monolog,其他一些 PHP 框架也可通过插件接入。

核心功能

  • 01通过 Handler 将日志发送到文件、套接字、邮件、数据库和 Web 服务。
  • 02Handler、Formatter 和 Processor 可组合成自定义的日志处理流程。
  • 03实现 PSR-3 日志接口,便于与其他库互通。
  • 04公共 API 同时支持 Monolog 级别和 PSR-3 级别。

适用场景

  • 在 PHP Web 应用中把运行日志写入文件。
  • 将错误日志发送到外部服务或邮箱以便及时告警。
  • 搭建同时写入多个目标的日志方案。
  • 在 PHP 库中通过标准 PSR-3 接口输出日志。

快速上手

  1. 1

    使用 Composer 安装 Monolog

    composer require monolog/monolog
  2. 2

    创建日志记录器并添加文件处理器

  3. 3

    使用日志记录器写入日志

使用前须知

  • Monolog 3.x 需要 PHP 8.1 或更高版本;更旧的 PHP 版本需使用 Monolog 2.x 或 1.x。

收录于专题

标签

常见问题

monolog 是什么?
PHP 日志库,可将日志发送到文件、套接字、邮件、数据库及多种 Web 服务,实现 PSR-3 接口。 Monolog 是一个 PHP 日志库,通过不同的 Handler 把日志记录发送到文件、套接字、邮箱、数据库以及多种 Web 服务等目标。借助特殊的 Handler,还可以组合出更复杂的日志策略。
monolog 可以免费使用吗?用的什么许可证?
monolog 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
monolog 还在维护吗?
活跃维护中。monolog 最近一次提交是在 2026年10月5日。
monolog 适合用来做什么?
在 PHP Web 应用中把运行日志写入文件。 将错误日志发送到外部服务或邮箱以便及时告警。 搭建同时写入多个目标的日志方案。 在 PHP 库中通过标准 PSR-3 接口输出日志。
monolog 怎么安装和运行?
使用 Composer 安装 Monolog: composer require monolog/monolog 创建日志记录器并添加文件处理器 使用日志记录器写入日志
在哪里获取 monolog?
源代码和安装说明在 GitHub 上:https://github.com/Seldaek/monolog

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目