# Net::Server::Log::Log::Log4perl - log via Log4perl - perldoc - [phpMan]

## NAME
    [Net::Server::Log::Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer%3A%3ALog%3A%3ALog%3A%3ALog4perl/markdown) - log via Log4perl

## SYNOPSIS
        use base qw([Net::Server::PreFork](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer%3A%3APreFork/markdown));

        __PACKAGE__->run(
            log_file => '[Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown)',
            log4perl_conf => '/path/to/my/log4perl.conf',
            log4perl_logger => 'myapp',
        );

## DESCRIPTION
    This module provides [Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown) style logging to the [Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown) system.

## CONFIGURATION
    log_file
        To begin using [Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown) logging, simply set the [Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown) log_file configuration
        parameter to "[Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown)".

        If the magic name "[Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown)" is used, all logging will be directed to the Log4perl
        system. If used, the "log4perl_conf", "log4perl_poll", "log4perl_logger" may also be
        defined.

    log4perl_conf
        Only available if "log_file" is equal to "[Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown)". This is the filename of the
        log4perl configuration file - see [Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown). If this is not set, will die on startup. If
        the file is not readable, will die.

    log4perl_poll
        If set to a value, will initialize with [Log::Log4perl::init_and_watch](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl%3A%3Ainitandwatch/markdown) with this polling
        value. This can also be the string "HUP" to re-read the log4perl_conf when a HUP signal is
        received. If set to 0, no polling is done. See [Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown) for more details.

    log4perl_logger
        This is the facility name. Defaults to "[Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown)".

DEFAULT ARGUMENTS FOR [Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown)
    The following arguments are available in the default "[Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown)" or "[Net::Server::Single](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer%3A%3ASingle/markdown)"
    modules. (Other personalities may use additional parameters and may optionally not use
    parameters from the base class.)

        Key               Value                    Default

        ## log4perl parameters (if log_file eq [Log::Log4perl](https://www.chedong.com/phpMan.php/perldoc/Log%3A%3ALog4perl/markdown))
        log4perl_conf     "filename"               will die if not set
        log4perl_poll     number or HUP            0 (no polling)
        log4perl_logger   "name"                   "[Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown)"

## METHODS
    "initialize"
        This method is called during the initilize_logging method of [Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown). It returns a
        single code ref that will be stored under the log_function property of the [Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown)
        object. That code ref takes log_level and message as arguments and calls the initialized
        log4perl system.

## LICENCE
    Distributed under the same terms as [Net::Server](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3AServer/markdown)