# Yii Logging Library Change Log

## 2.2.1 March 22, 2026

- Chg #130, #133: Changed `Message::parse()` to conform to PSR-3 (@technicated, @vjik)
- Enh #132: Add benchmarks, improve performance of `Message::parse()` (@samdark)
- Enh #135: Add validation for `$traceLevel` in `SystemContextProvider` to ensure values are greater than or equal to zero (@rekmixa)
- Enh #137: Explicitly import classes, functions, and constants in "use" section (@mspirkov)
- Enh #138: Moved the final log flush from `register_shutdown_function()` to the `Logger::__destruct()` method (@olegbaturin)
- Bug #130: Updated `Message::parse()` to correctly support multiple placeholders (@technicated)

## 2.2.0 December 13, 2025

- New #125: Add optional `$levels` parameter to `Target` constructor allowing log level filtering at instantiation (@samdark)
- Chg #126: Add `ext-psr` to `conflict` section in `composer.json` (@samdark)

## 2.1.1 June 03, 2025

- Enh #123, #124: Minor refactor internal class `ContextValueExtractor` (@Tigrov, @vjik)
- Bug #123: Explicitly marking parameters as nullable (@Tigrov)

## 2.1.0 July 03, 2024

- New #104: Add new static methods `Logger::assertLevelIsValid()`, `Logger::assertLevelIsString()` and
  `Logger::assertLevelIsSupported()` (@vjik)
- New #108: Support of nested values in message templates' variables, e.g. `{foo.bar}` (@vjik)
- New #109, #113, #116: Add context providers (@vjik)
- New #111: Add `DateTime` and `DateTimeImmutable` support as time in log context (@vjik)
- New #112: Add `Message::category()` method and `Message::DEFAULT_CATEGORY` constant, deprecate
  `CategoryFilter::DEFAULT` in favor it (@vjik)
- New #113: Add `Message::trace()` method (@vjik)
- New #114: Add `Message::time()` method (@vjik)
- Chg #104: Deprecate method `Logger::validateLevel()` (@vjik)
- Chg #109: Deprecate `Logger` methods `setTraceLevel()` and `setExcludedTracePaths()` in favor of context provider
  usage (@vjik)
- Chg #116: Deprecate methods `setCommonContext()` and `getCommonContext()` in `Target` class (@vjik)
- Chg #118: Replace `gettype()` to `get_debug_type()` in exception messages generation (@vjik)
- Bug #84: Change the type of the `$level` parameter in the `Message` constructor to `string` (@dood-)
- Bug #89: Fix error on parse messages, that contains variables that cannot cast to a string (@vjik)
- Bug #98: Fix error on formatting trace, when it doesn't contain "file" and "line" (@vjik)

## 2.0.0 May 22, 2022

- Chg #68: Raise the minimum `psr/log` version to `^2.0|^3.0` and the minimum PHP version to 8.0 (@xepozz, @rustamwin)

## 1.0.4 March 29, 2022

- Bug #76: Fix time formatter when locale uses comma as a decimal point separator (@terabytesoftw)

## 1.0.3 November 12, 2021

- Chg #74: Replace usage of `yiisoft/yii-web` to `yiisoft/yii-http` in event config (@devanych)

## 1.0.2 May 19, 2021

- Bug #67: Flush logger on the console is terminated (@rustamwin)

## 1.0.1 March 23, 2021

- Chg: Adjust config for new config plugin (@samdark)

## 1.0.0 February 11, 2021

Initial release.