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'),
    ),
);