# PsrTarget

> Exports Yii log messages to a PSR-3 logger.

[API reference](/docs/api/index.md) › [yii](/docs/api/yii/index.md) › [log](/docs/api/yii/log/index.md) › PsrTarget

| class | `yii\log\PsrTarget` |
| --- | --- |
| Extends | [`Target`](/docs/api/yii/log/target/index.md) » [`yii\base\Component`](/docs/api/yii/base/component/index.md) » [`yii\base\BaseObject`](/docs/api/yii/base/baseobject/index.md) |
| Implements | [`yii\base\Configurable`](/docs/api/yii/base/configurable/index.md) |
| Since | 22.0 |
| Source | [`framework/log/PsrTarget.php`](https://github.com/yiisoft/yii2/blob/22.0/framework/log/PsrTarget.php#L37) |

Exports Yii log messages to a PSR-3 logger.

The Yii category, trace, and memory usage are passed as PSR-3 context. The original Yii timestamp can also be added
by enabling [`$addTimestampToContext`](/docs/api/yii/log/psrtarget/index.md#property-addTimestampToContext). Context keys carried by a round-tripped [`PsrMessage`](/docs/api/yii/log/psrmessage/index.md) take precedence:
`trace`, `memory`, `category`, and `timestamp` are only added when the original context does not define them, and
`trace` only when Yii collected traces. [`$extractExceptionTrace`](/docs/api/yii/log/psrtarget/index.md#property-extractExceptionTrace) deliberately overwrites `trace` when enabled.

## Properties

| Property | Type | Description | Defined by |
| --- | --- | --- | --- |
| <span id="property-addTimestampToContext"></span>`$addTimestampToContext` | `bool` | Whether to add the original Yii log timestamp to the PSR-3 context. Default: `false`. | `PsrTarget` |
| <span id="property-behaviors"></span>[`$behaviors`](/docs/api/yii/base/component/index.md#property-behaviors) read-only | `array<`[`yii\base\Behavior`](/docs/api/yii/base/behavior/index.md)`<static>>` | List of behaviors attached to this component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="property-categories"></span>[`$categories`](/docs/api/yii/log/target/index.md#property-categories) | `list<string>` | List of message categories that this target is interested in. Default: `[]`. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-enabled"></span>[`$enabled`](/docs/api/yii/log/target/index.md#property-enabled) | `bool\|callable` | A boolean value or a callable to obtain the value from. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-except"></span>[`$except`](/docs/api/yii/log/target/index.md#property-except) | `list<string>` | List of message categories that this target is NOT interested in. Default: `[]`. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-exportInterval"></span>[`$exportInterval`](/docs/api/yii/log/target/index.md#property-exportInterval) | `int` | How many messages should be accumulated before they are exported. Default: `1000`. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-extractExceptionTrace"></span>`$extractExceptionTrace` | `bool` | Whether to export an exception message and trace separately instead of stringifying the exception. Default: `false`. | `PsrTarget` |
| <span id="property-levelMap"></span>`$levelMap` | `array<int, string>` | Mapping from Yii levels to PSR-3 levels. Default: `[\yii\log\Logger::LEVEL_ERROR => \Psr\Log\LogLevel::ERROR, \yii\log\Logger::LEVEL_WARNING => \Psr\Log\LogLevel::WARNING, \yii\log\Logger::LEVEL_INFO => \Psr\Log\LogLevel::INFO, \yii\log\Logger::LEVEL_TRACE => \Psr\Log\LogLevel::DEBUG, \yii\log\Logger::LEVEL_PROFILE => \Psr\Log\LogLevel::DEBUG, \yii\log\Logger::LEVEL_PROFILE_BEGIN => \Psr\Log\LogLevel::DEBUG, \yii\log\Logger::LEVEL_PROFILE_END => \Psr\Log\LogLevel::DEBUG]`. | `PsrTarget` |
| <span id="property-levels"></span>[`$levels`](/docs/api/yii/log/target/index.md#property-levels) | `array\|int` | Message levels that this target is interested in. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-logger"></span>`$logger` | `Psr\Log\LoggerInterface` | The PSR-3 logger used to export messages. | `PsrTarget` |
| <span id="property-logVars"></span>[`$logVars`](/docs/api/yii/log/target/index.md#property-logVars) | `list<string>` | List of the PHP predefined variables that should be logged in a message. Default: `['_GET', '_POST', '_FILES', '_COOKIE', '_SESSION', '_SERVER']`. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-maskVars"></span>[`$maskVars`](/docs/api/yii/log/target/index.md#property-maskVars) | `list<string>` | List of the PHP predefined variables that should NOT be logged "as is" and should always be replaced with a mask `***` before logging, when exist. Default: `['_SERVER.HTTP_AUTHORIZATION', '_SERVER.PHP_AUTH_USER', '_SERVER.PHP_AUTH_PW']`. Available since 2.0.16. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-messages"></span>[`$messages`](/docs/api/yii/log/target/index.md#property-messages) | `list<yii\log\LogMessage>` | The messages that are retrieved from the logger so far by this log target. Default: `[]`. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-microtime"></span>[`$microtime`](/docs/api/yii/log/target/index.md#property-microtime) | `bool` | Whether to log time with microseconds. Default: `false`. Available since 2.0.13. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-prefix"></span>[`$prefix`](/docs/api/yii/log/target/index.md#property-prefix) | `callable(yii\log\LogMessage): string\|null` | A PHP callable that returns a string to be prefixed to every exported message. Default: `null`. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="property-psrLevels"></span>`$psrLevels` | `list<string>\|null` | Exact PSR-3 levels this target exports after Yii level and category filtering. `null` means all PSR-3 levels. | `PsrTarget` |

## Methods

| Method | Description | Defined by |
| --- | --- | --- |
| <span id="method-__construct"></span>[`__construct()`](/docs/api/yii/base/baseobject/index.md#method-__construct) | Constructor. | [`yii\base\BaseObject`](/docs/api/yii/base/baseobject/index.md) |
| <span id="method-__call"></span>[`__call()`](/docs/api/yii/base/component/index.md#method-__call) | Calls the named method which is not a class method. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-__clone"></span>[`__clone()`](/docs/api/yii/base/component/index.md#method-__clone) | This method is called after the object is created by cloning an existing one. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-__get"></span>[`__get()`](/docs/api/yii/base/component/index.md#method-__get) | Returns the value of a component property. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-__isset"></span>[`__isset()`](/docs/api/yii/base/component/index.md#method-__isset) | Checks if a property is set, i.e. defined and not null. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-__set"></span>[`__set()`](/docs/api/yii/base/component/index.md#method-__set) | Sets the value of a component property. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-__unset"></span>[`__unset()`](/docs/api/yii/base/component/index.md#method-__unset) | Sets a component property to be null. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-attachBehavior"></span>[`attachBehavior()`](/docs/api/yii/base/component/index.md#method-attachBehavior) | Attaches a behavior to this component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-attachBehaviors"></span>[`attachBehaviors()`](/docs/api/yii/base/component/index.md#method-attachBehaviors) | Attaches a list of behaviors to the component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-behaviors"></span>[`behaviors()`](/docs/api/yii/base/component/index.md#method-behaviors) | Returns a list of behaviors that this component should behave as. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-canGetProperty"></span>[`canGetProperty()`](/docs/api/yii/base/component/index.md#method-canGetProperty) | Returns a value indicating whether a property can be read. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-canSetProperty"></span>[`canSetProperty()`](/docs/api/yii/base/component/index.md#method-canSetProperty) | Returns a value indicating whether a property can be set. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-className"></span>[`className()`](/docs/api/yii/base/baseobject/index.md#method-className) static | Returns the fully qualified name of this class. | [`yii\base\BaseObject`](/docs/api/yii/base/baseobject/index.md) |
| <span id="method-collect"></span>[`collect()`](/docs/api/yii/log/target/index.md#method-collect) | Processes the given log messages. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="method-detachBehavior"></span>[`detachBehavior()`](/docs/api/yii/base/component/index.md#method-detachBehavior) | Detaches a behavior from the component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-detachBehaviors"></span>[`detachBehaviors()`](/docs/api/yii/base/component/index.md#method-detachBehaviors) | Detaches all behaviors from the component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-ensureBehaviors"></span>[`ensureBehaviors()`](/docs/api/yii/base/component/index.md#method-ensureBehaviors) | Makes sure that the behaviors declared in [`behaviors()`](/docs/api/yii/base/component/index.md#method-behaviors) are attached to this component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| [`export()`](#method-export) | Exports accumulated messages to the configured PSR-3 logger. | `PsrTarget` |
| <span id="method-filterMessages"></span>[`filterMessages()`](/docs/api/yii/log/target/index.md#method-filterMessages) static | Filters the given messages according to their categories and levels. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="method-formatMessage"></span>[`formatMessage()`](/docs/api/yii/log/target/index.md#method-formatMessage) | Formats a log message for display as a string. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="method-getBehavior"></span>[`getBehavior()`](/docs/api/yii/base/component/index.md#method-getBehavior) | Returns the named behavior object. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-getBehaviors"></span>[`getBehaviors()`](/docs/api/yii/base/component/index.md#method-getBehaviors) | Returns all behaviors attached to this component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-getEnabled"></span>[`getEnabled()`](/docs/api/yii/log/target/index.md#method-getEnabled) | Check whether the log target is enabled. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="method-getLevels"></span>[`getLevels()`](/docs/api/yii/log/target/index.md#method-getLevels) |  | [`Target`](/docs/api/yii/log/target/index.md) |
| [`getLogger()`](#method-getLogger) | Returns the configured PSR-3 logger. | `PsrTarget` |
| <span id="method-getMessagePrefix"></span>[`getMessagePrefix()`](/docs/api/yii/log/target/index.md#method-getMessagePrefix) | Returns a string to be prefixed to the given message. | [`Target`](/docs/api/yii/log/target/index.md) |
| [`getPsrLevels()`](#method-getPsrLevels) | Returns the exact PSR-3 levels this target exports. | `PsrTarget` |
| <span id="method-hasEventHandlers"></span>[`hasEventHandlers()`](/docs/api/yii/base/component/index.md#method-hasEventHandlers) | Returns a value indicating whether there is any handler attached to the named event. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-hasMethod"></span>[`hasMethod()`](/docs/api/yii/base/component/index.md#method-hasMethod) | Returns a value indicating whether a method is defined. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-hasProperty"></span>[`hasProperty()`](/docs/api/yii/base/component/index.md#method-hasProperty) | Returns a value indicating whether a property is defined for this component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| [`init()`](#method-init) | Initializes the object. | `PsrTarget` |
| <span id="method-off"></span>[`off()`](/docs/api/yii/base/component/index.md#method-off) | Detaches an existing event handler from this component. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-on"></span>[`on()`](/docs/api/yii/base/component/index.md#method-on) | Attaches an event handler to an event. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-setEnabled"></span>[`setEnabled()`](/docs/api/yii/log/target/index.md#method-setEnabled) | Sets a value indicating whether this log target is enabled. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="method-setLevels"></span>[`setLevels()`](/docs/api/yii/log/target/index.md#method-setLevels) | Sets the message levels that this target is interested in. | [`Target`](/docs/api/yii/log/target/index.md) |
| [`setLogger()`](#method-setLogger) | Sets the PSR-3 logger. | `PsrTarget` |
| [`setPsrLevels()`](#method-setPsrLevels) | Sets the exact PSR-3 levels this target exports after normal Yii target filtering. | `PsrTarget` |
| <span id="method-trigger"></span>[`trigger()`](/docs/api/yii/base/component/index.md#method-trigger) | Triggers an event. | [`yii\base\Component`](/docs/api/yii/base/component/index.md) |
| <span id="method-formatMessageText"></span>[`formatMessageText()`](/docs/api/yii/log/target/index.md#method-formatMessageText) protected | Converts a log message value to text. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="method-getContextMessage"></span>[`getContextMessage()`](/docs/api/yii/log/target/index.md#method-getContextMessage) protected | Generates the context information to be logged. | [`Target`](/docs/api/yii/log/target/index.md) |
| <span id="method-getTime"></span>[`getTime()`](/docs/api/yii/log/target/index.md#method-getTime) protected | Returns formatted ('Y-m-d H:i:s') timestamp for message. | [`Target`](/docs/api/yii/log/target/index.md) |
| [`resolvePsrLevel()`](#method-resolvePsrLevel) protected | Resolves the PSR-3 level for a Yii message. | `PsrTarget` |

## Method details

### export() <span id="method-export"></span>

```php
public function export(): void
```

Exports accumulated messages to the configured PSR-3 logger.

### getLogger() <span id="method-getLogger"></span>

```php
public function getLogger(): Psr\Log\LoggerInterface
```

Returns the configured PSR-3 logger.

**Returns**

`Psr\Log\LoggerInterface`

**Throws**

- [`yii\base\InvalidConfigException`](/docs/api/yii/base/invalidconfigexception/index.md): If no logger is configured.

### getPsrLevels() <span id="method-getPsrLevels"></span>

```php
public function getPsrLevels(): list<string>|null
```

Returns the exact PSR-3 levels this target exports.

**Returns**

`list<string>|null`: `null` means all PSR-3 levels.

### init() <span id="method-init"></span>

```php
public function init(): mixed
```

Initializes the object.

This method is invoked at the end of the constructor after the object is initialized with the
given configuration.

**Returns**

`mixed`

### setLogger() <span id="method-setLogger"></span>

```php
public function setLogger(Psr\Log\LoggerInterface $logger): void
```

Sets the PSR-3 logger.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$logger` | `Psr\Log\LoggerInterface` |  |

**Throws**

- [`yii\base\InvalidConfigException`](/docs/api/yii/base/invalidconfigexception/index.md): If a Yii-to-PSR adapter is configured as the destination.

### setPsrLevels() <span id="method-setPsrLevels"></span>

```php
public function setPsrLevels(list<string>|null $levels): void
```

Sets the exact PSR-3 levels this target exports after normal Yii target filtering.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$levels` | `list<string>\|null` | `null` or an empty array enables all PSR-3 levels. |

**Throws**

- [`yii\base\InvalidConfigException`](/docs/api/yii/base/invalidconfigexception/index.md): If a level is not recognized.

### resolvePsrLevel() <span id="method-resolvePsrLevel"></span>

```php
protected function resolvePsrLevel(array $message): string
```

Resolves the PSR-3 level for a Yii message.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$message` | `array` | Yii log message. |

**Returns**

`string`

**Throws**

- [`LogRuntimeException`](/docs/api/yii/log/logruntimeexception/index.md): If the level cannot be mapped.