v3.10.0

Compare Source

• Added automatic directory cleanup in RotatingFileHandler (#​2000)
  • Added timezone-aware file rotation to RotatingFileHandler (#​1982)
  • Added support for mongodb/mongodb 2.0+ (#​1998)
  • Added NoDiscard attribute to TestHandler methods to ensure the result is used (#​2013)
  • Fixed JsonFormatter crashing if __toString throws while normalizing data (#​1968)
  • Fixed PHP 8.5 deprecation warnings (#​1997, #​2009)
  • Fixed DeduplicatingHandler collecting duplicate logs if the file cannot be locked (2e97231)
  • Fixed GelfMessageFormatter to use integers instead of bool for gelf 1.1 support (#​1973)
  • Fixed empty stack traces being output anyway (#​1979)
  • Fixed StreamHandler not reopening the file if the inode changed (#​1963)
  • Fixed TelegramBotHandler sending empty messages (#​1992)
  • Fixed file paths in stack traces containing backslashes on windows, always using / now to unify logs (#​1980)
  • Fixed RotatingFileHandler unlink errors not being suppressed correctly (#​1999)

v3.9.0

Compare Source

• BC Warning: Fixed SendGridHandler to use the V3 API as V2 is now shut down, but this requires a new API key (#​1952)
  • Deprecated Monolog\Test\TestCase in favor of Monolog\Test\MonologTestCase (#​1953)
  • Added extension point for NativeMailerHandler::mail (#​1948)
  • Added setHandler method to BufferHandler to modify the nested handler at runtime (#​1946)
  • Fixed date format in ElasticsearchFormatter to use +00:00 vs +0000 tz identifiers (#​1942)
  • Fixed GelfMessageFormatter handling numeric context/extra keys (#​1932)

v3.8.1

Compare Source

• Deprecated Monolog\DateTimeImmutable in favor of Monolog\JsonSerializableDateTimeImmutable (#​1928)
  • Fixed gelf keys not being valid when context/extra data keys have spaces in them (#​1927)
  • Fixed empty lines appearing in the stack traces when a custom formatter returned null (#​1925)

v3.8.0

Compare Source

• Added $fileOpenMode param to StreamHandler to define a custom fopen mode to open the log file (#​1913)
  • Fixed PHP 8.4 deprecation notices (#​1903)
  • Added ability to extend/override IntrospectionProcessor (#​1899)
  • Added $timeout param to ProcessHandler to configure the stream_select() timeout to avoid blocking too long (default is 1.0 sec) (#​1916)
  • Fixed JsonFormatter batch handling to normalize records individually to make sure they look the same as if they were handled one by one (#​1906)
  • Fixed StreamHandler handling of write failures so that it now closes/reopens the stream and retries the write once before failing (#​1882)
  • Fixed StreamHandler error handler causing issues if a stream handler triggers an error (#​1866)
  • Fixed StreamHandler::reset not closing the stream, so that it would fail to write in some cases with long running processes (#​1862)
  • Fixed RotatingFileHandler issue where rotation does not happen in some long running processes (#​1905)
  • Fixed JsonFormatter handling of incomplete classes (#​1834)
  • Fixed RotatingFileHandler bug where rotation could sometimes not happen correctly (#​1905)

v3.7.0

Compare Source

• Added NormalizerFormatter->setBasePath(...) (and JsonFormatter by extension) that allows removing the project's path from the stack trace output (47e301d)
  • Fixed JsonFormatter handling of incomplete classes (#​1834)
  • Fixed private error handlers causing problems with custom StreamHandler implementations (#​1866)

v3.6.0

Compare Source

• Added LineFormatter->setBasePath(...) that allows removing the project's path from the stack trace output (#​1873)
  • Added $includeExtra option in PsrHandler to also use extra data to replace placeholder values in the message (#​1852)
  • Added ability to customize what is a duplicated message by extending the DeduplicationHandler (#​1879)
  • Added handling for using GelfMessageFormatter together with the AmqpHandler (#​1869)
  • Added ability to extend GoogleCloudLoggingFormatter (#​1859)
  • Fixed __toString failures in context data crashing the normalization process (#​1868)
  • Fixed PHP 8.4 deprecation warnings (#​1874)

v3.5.0

Compare Source

• Added ability to indent stack traces in LineFormatter via e.g. indentStacktraces(' ') (#​1835)
  • Added ability to configure a max level name length in LineFormatter via e.g. setMaxLevelNameLength(3) (#​1850)
  • Added support for indexed arrays (i.e. [] and not {} arrays once json serialized) containing inline linebreaks in LineFormatter (#​1818)
  • Added WithMonologChannel attribute for integrators to use to configure autowiring (#​1847)
  • Fixed log record extra data leaking between handlers that have handler-specific processors set (#​1819)
  • Fixed LogglyHandler issue with record level filtering (#​1841)
  • Fixed display_errors parsing in ErrorHandler which did not support string values (#​1804)
  • Fixed bug where the previous error handler would not be restored in some cases where StreamHandler fails (#​1815)
  • Fixed normalization error when normalizing incomplete classes (#​1833)

v3.4.0

Compare Source

• Added LoadAverageProcessor to track one of the 1, 5 or 15min load averages (#​1803)
  • Added support for priority to the AsMonologProcessor attribute (#​1797)
  • Added TelegramBotHandler topic/message_thread_id support (#​1802)
  • Fixed FingersCrossedHandler passthruLevel checking (#​1801)
  • Fixed support of yearly and monthly rotation log file to rotate only once a month/year (#​1805)
  • Fixed TestHandler method docs (#​1794)
  • Fixed handling of falsey display_errors string values (#​1804)

v3.3.1

Compare Source

• Fixed Logger not being serializable anymore (#​1792)

v3.3.0

Compare Source

• Deprecated FlowdockHandler & Formatter as the flowdock service was shutdown (#​1748)
  • Added ClosureContextProcessor to allow delaying the creation of context data by setting a Closure in context which is called when the log record is used (#​1745)
  • Added an ElasticsearchHandler option to set the op_type to create instead of the default index (#​1766)
  • Added support for enum context values in PsrLogMessageProcessor (#​1773)
  • Added graylog2/gelf-php 2.x support (#​1747)
  • Improved BrowserConsoleHandler logging to use more appropriate methods than just console.log in the browser (#​1739)
  • Fixed GitProcessor not filtering correctly based on Level (#​1749)
  • Fixed WhatFailureGroupHandler not catching errors happening inside close() (#​1791)
  • Fixed datetime field in GoogleCloudLoggingFormatter (#​1758)
  • Fixed infinite loop detection within Fibers (#​1753)
  • Fixed AmqpHandler->setExtraAttributes not working with buffering handler wrappers (#​1781)

v3.2.0

Compare Source

• Deprecated CubeHandler and PHPConsoleHandler as both projects are abandoned and those should not be used anymore (#​1734)
  • Marked Logger @final as it should not be extended, prefer composition or talk to us if you are missing something
  • Added RFC 5424 level (7 to 0) support to Logger::log and Logger::addRecord to increase interoperability (#​1723)
  • Added SyslogFormatter to output syslog-like files which can be consumed by tools like lnav (#​1689)
  • Added support for __toString for objects which are not json serializable in JsonFormatter (#​1733)
  • Added GoogleCloudLoggingFormatter (#​1719)
  • Added support for Predis 2.x (#​1732)
  • Added AmqpHandler->setExtraAttributes to allow configuring attributes when using an AMQPExchange (#​1724)
  • Fixed serialization/unserialization of handlers to make sure private properties are included (#​1727)
  • Fixed allowInlineLineBreaks in LineFormatter causing issues with windows paths containing \n or \r sequences (#​1720)
  • Fixed max normalization depth not being taken into account when formatting exceptions with a deep chain of previous exceptions (#​1726)
  • Fixed PHP 8.2 deprecation warnings (#​1722)
  • Fixed rare race condition or filesystem issue where StreamHandler is unable to create the directory the log should go into yet it exists already (#​1678)

v3.1.0

Compare Source

• Added $datetime parameter to Logger::addRecord as low level API to allow logging into the past or future (#​1682)
  • Added Logger::useLoggingLoopDetection to allow disabling cyclic logging detection in concurrent frameworks (#​1681)
  • Fixed handling of fatal errors if callPrevious is disabled in ErrorHandler (#​1670)
  • Fixed interop issue by removing the need for a return type in ProcessorInterface (#​1680)
  • Marked the reusable Monolog\Test\TestCase class as @internal to make sure PHPStorm does not show it above PHPUnit, you may still use it to test your own handlers/etc though (#​1677)
  • Fixed RotatingFileHandler issue when the date format contained slashes (#​1671)

v3.0.0

Compare Source

Changes from RC1

• The Monolog\LevelName enum does not exist anymore, use Monolog\Level->getName() instead.