monolog README

The project's README from github.com/Seldaek/monolog. As one markdown file: README.md.

Monolog

Monolog - Logging for PHP Continuous Integration

Total Downloads Latest Stable Version

Note This is the documentation for Monolog 3.x, if you are using older releases see the documentation for Monolog 2.x or Monolog 1.x

Monolog sends your logs to files, sockets, inboxes, databases and various web services. See the complete list of handlers below. Special handlers allow you to build advanced logging strategies.

This library implements the PSR-3 interface that you can type-hint against in your own libraries to keep a maximum of interoperability. You can also use it in your applications to make sure you can always use another compatible logger at a later time. As of 1.11.0 Monolog public APIs will also accept PSR-3 log levels. Internally Monolog still uses its own level scheme since it predates PSR-3.

Sponsored by:
Better Stack
Better Stack lets you centralize, search, and visualize your logs.

Installation

Install the latest version with

composer require monolog/monolog

Basic Usage

<?php

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

// create a log channel
$log = new Logger('name');
$log->pushHandler(new StreamHandler('path/to/your.log', Level::Warning));

// add records to the log
$log->warning('Foo');
$log->error('Bar');

Documentation

Support Monolog Financially

Get supported Monolog and help fund the project with the Tidelift Subscription or via GitHub sponsorship.

Tidelift delivers commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use.

Third Party Packages

Third party handlers, formatters and processors are listed in the wiki. You can also add your own there if you publish one.

About

Requirements

Support

Monolog 1.x support is somewhat limited at this point and only important fixes will be done. You should migrate to Monolog 2 or 3 where possible to benefit from all the latest features and fixes.

Submitting bugs and feature requests

Bugs and feature request are tracked on GitHub

Framework Integrations

Author

Jordi Boggiano - [email protected] - http://twitter.com/seldaek
See also the list of contributors who participated in this project.

License

Monolog is licensed under the MIT License - see the LICENSE file for details

Acknowledgements

This library is heavily inspired by Python's Logbook library, although most concepts have been adjusted to fit to the PHP world.

monolog (Seldaek/monolog)

Searching Database…

21.4K ·GitHub
Monolog
Что это такое?Monolog — это библиотека для логирования на PHP: она забирает логи, которые создаёт ваше приложение, и отправляет их в файлы, сокеты, почтовые ящики, базы данных и различные веб-сервисы.
Это библиотека, которую я добавляю в свой код, или отдельный сервис для логов?Это библиотека, которую вы устанавливаете в свой PHP-код, а не сервис, который нужно запускать. Она реализует интерфейс логирования PSR-3, поэтому можно указывать PSR-3 в типах (type-hint) и позже заменить её на любой другой совместимый логгер.
Как добавить её в свой проект?Установите через Composer: composer require monolog/monolog. Затем подключите обработчики (handlers) для нужных мест назначения и пишите логи через API логгера — в документации описаны использование, handlers, formatters и processors.
Какая версия PHP мне нужна?Актуальная ветка 3.x требует PHP 8.1 или новее. Старые ветки рассчитаны на устаревшие стеки: 2.5+ работает на PHP 7.2+, а 1.25+ поддерживает PHP от 5.3 до 8.1.
У меня всё ещё стоит Monolog 1.x — это проблема?Со временем да: ветка 1.x получает только критические исправления и больше не получит исправлений для поддержки новых версий PHP, поэтому в README рекомендуется по возможности перейти на 2.x или 3.x.
Работает ли она с Laravel и Symfony сразу после установки?Да — Symfony, Laravel, Lumen, Magento и ещё несколько фреймворков поставляются с Monolog из коробки, а CakePHP, Yii 2, Drupal и Nette подключаются через специальные bridge-плагины.
Она умеет больше, чем просто записывать логи в файл?Да — специальные обработчики позволяют строить продвинутые стратегии логирования, а handlers, formatters и processors — это собираемые друг с другом блоки; сторонние из них перечислены в вики проекта.
Какие уровни логов она поддерживает?Начиная с версии 1.11.0 публичные API также принимают уровни логов из PSR-3; внутри Monolog использует собственную схему уровней, потому что библиотека появилась раньше PSR-3.
Можно ли получить коммерческую поддержку Monolog?Да — подписка Tidelift даёт коммерческую поддержку и сопровождение этой зависимости, а также можно поддержать проект напрямую через GitHub sponsorship.
What are similar projects?loguru, pino, log, Slim, whoops, logger, timber, gofr
Which topics is it in?error-handling, logger, logging, debugging, php, observability, monitoring, hacktoberfest, backend, web-development, server, library
Creator
Seldaek
Size
5.1 MB
Stars
21.4K
Updated
CommitOct 05Release3.12.1Sep 29
Age
15y
Commits · 90 Days