## LoggerAppenderMail

`LoggerAppenderMail` appends log events via email.

This appender does not send individual emails for each logging requests but will collect them in a buffer and send them all in a single email once the appender is closed (i.e. when the script exists). Because of this, it may not appropriate for long running scripts, in which case `LoggerAppenderMailEvent` might be a better choice.

Note: When working in Windows, make sure that the `SMTP` and `smpt_port` values in php.ini are set to the correct values for your email server (address and port).

### Layout

This appender requires a layout. If no layout is specified in configuration, `LoggerLayoutSimple` will be used by default.

### Parameters

The following parameters are available:

Parameter | Type | Required | Default | Description
--- | --- | --- | --- | ---
to | string | Yes | - | Email address(es) to which the log will be sent. Multiple email addresses may be specified by separating them with a comma.
from | string | Yes | - | Email address which will be used in the From field.
subject | string | No | Log4php Report | Subject of the email message.

### Examples

This example shows how to configure `LoggerAppenderMail` to send the log to two email addresses.

- XML
- PHP

    <configuration xmlns="http://logging.apache.org/log4php/">
        <appender name="default" class="LoggerAppenderMail">
            <layout class="LoggerLayoutSimple" />
            <param name="to" value="foo@example.com,baz@example.com" />
            <param name="from" value="logger@example.com" />
        </appender>
        <root>
            <appender_ref ref="default" />
        </root>
    </configuration>

    array(
        'appenders' => array(
            'default' => array(
                'class' => 'LoggerAppenderMail',
                'layout' => array(
                    'class' => 'LoggerLayoutSimple',
                ),
                'params' => array(
                    'to' => 'foo@example.com,baz@example.com',
                    'from' => 'logger@example.com'
                ),
            ),
        ),
        'rootLogger' => array(
            'appenders' => array('default'),
        ),
    );