# log-target-email
**Repository Path**: mirrors_yiisoft/log-target-email
## Basic Information
- **Project Name**: log-target-email
- **Description**: Yii Logging Library - Email Target
- **Primary Language**: Unknown
- **License**: BSD-3-Clause
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-19
- **Last Updated**: 2026-02-14
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
Yii Logging Library - Email Target
[](https://packagist.org/packages/yiisoft/log-target-email)
[](https://packagist.org/packages/yiisoft/log-target-email)
[](https://github.com/yiisoft/log-target-email/actions/workflows/build.yml)
[](https://scrutinizer-ci.com/g/yiisoft/log-target-email/?branch=master)
[](https://codecov.io/gh/yiisoft/log-target-email)
[](https://dashboard.stryker-mutator.io/reports/github.com/yiisoft/log-target-email/master)
[](https://github.com/yiisoft/log-target-email/actions?query=workflow%3A%22static+analysis%22)
[](https://shepherd.dev/github/yiisoft/log-target-email)
This package provides the Email target for the [yiisoft/log](https://github.com/yiisoft/log) library.
## Requirements
- PHP 8.0 or higher.
## Installation
The package could be installed with [Composer](https://getcomposer.org):
```shell
composer require yiisoft/log-target-email
```
## General usage
Creating a target:
```php
$emailTarget = new \Yiisoft\Log\Target\Email\EmailTarget($mailer, $emailTo, $subjectEmail, $levels);
```
- `$mailer (\Yiisoft\Mailer\MailerInterface)` - The mailer instance that sends email and should be already configured.
- `$emailTo (string|array)` - The receiver email address.
You may pass an array of addresses if multiple recipients should receive this message.
You may also specify receiver name in addition to email address using format: `[email => name]`.
- `$subjectEmail (string)` - The email message subject. Defaults to `Application Log`.
- `$levels (array)` - Optional. The log message levels that this target is interested in. Defaults to `[]` (all levels).
For example: `[LogLevel::ERROR, LogLevel::WARNING]`.
Example with level filtering:
```php
use Psr\Log\LogLevel;
// Only log ERROR and WARNING messages
$emailTarget = new \Yiisoft\Log\Target\Email\EmailTarget(
$mailer,
'admin@example.com',
'Application Errors',
[LogLevel::ERROR, LogLevel::WARNING]
);
```
Creating a logger:
```php
$logger = new \Yiisoft\Log\Logger([$emailTarget]);
```
For use in the [Yii framework](https://www.yiiframework.com/), see the configuration files:
- [`config/di.php`](https://github.com/yiisoft/log-target-email/blob/master/config/di.php)
- [`config/params.php`](https://github.com/yiisoft/log-target-email/blob/master/config/params.php)
## Documentation
For a description of using the logger, see the [yiisoft/log](https://github.com/yiisoft/log) package.
- [Yii guide to logging](https://github.com/yiisoft/docs/blob/master/guide/en/runtime/logging.md)
- [Internals](docs/internals.md)
If you need help or have a question, the [Yii Forum](https://forum.yiiframework.com/c/yii-3-0/63) is a good place
for that. You may also check out other [Yii Community Resources](https://www.yiiframework.com/community).
## License
The Yii Logging Library - Email Target is free software. It is released under the terms of the BSD License.
Please see [`LICENSE`](./LICENSE.md) for more information.
Maintained by [Yii Software](https://www.yiiframework.com/).
## Support the project
[](https://opencollective.com/yiisoft)
## Follow updates
[](https://www.yiiframework.com/)
[](https://twitter.com/yiiframework)
[](https://t.me/yii3en)
[](https://www.facebook.com/groups/yiitalk)
[](https://yiiframework.com/go/slack)