NAME
   Apache::LogFormat::Compiler - Compile LogFormat to perl-code

SYNOPSIS
     use Apache::LogFormat::Compiler;

     my $log_handler = Apache::LogFormat::Compiler->new("combined");
     # my $log_handler = Apache::LogFormat::Compiler->new(
     #     '%h %l %u %t "%r" %>s %b "%{Referer}i" "%{User-agent}i"'
     # );
     my $log = $log_handler->log_line(
         $env,
         $res,
         $length,
         $time
     );

DESCRIPTION
   Compile LogFormat to perl-code. For faster generating access_log line.

   THIS IS A DEVELOPMENT RELEASE. API MAY CHANGE WITHOUT NOTICE.

METHOD
   new($fmt:String)
       Takes a format string (or a preset template "combined" or "custom")
       to specify the log format. This middleware implements a subset of
       Apache's LogFormat templates
       <http://httpd.apache.org/docs/2.0/mod/mod_log_config.html>:

          %%    a percent sign
          %h    REMOTE_ADDR from the PSGI environment, or -
          %l    remote logname not implemented (currently always -)
          %u    REMOTE_USER from the PSGI environment, or -
          %t    [local timestamp, in default format]
          %r    REQUEST_METHOD, REQUEST_URI and SERVER_PROTOCOL from the PSGI environment
          %s    the HTTP status code of the response
          %b    content length
          %T    custom field for handling times in subclasses
          %D    custom field for handling sub-second times in subclasses
          %v    SERVER_NAME from the PSGI environment, or -
          %V    HTTP_HOST or SERVER_NAME from the PSGI environment, or -
          %p    SERVER_PORT from the PSGI environment
          %P    the worker's process id

       Some of these format fields are only supported by middleware that
       subclasses "AccessLog".

       In addition, custom values can be referenced, using "%{name}", with
       one of the mandatory modifier flags "i", "o" or "t":

          %{variable-name}i    HTTP_VARIABLE_NAME value from the PSGI environment
          %{header-name}o      header-name header
          %{time-format]t      localtime in the specified strftime format

   log_line($env:HashRef,$res:ArrayRef,$length:Integer,$time:Integer):
   $log:String
       PSGI-style $env and $res, Content-Length and the time taken to serve
       request in microseconds.

AUTHOR
   Masahiro Nagano <[email protected]>

SEE ALSO
   Plack::Middleware::AccessLog,
   <http://httpd.apache.org/docs/2.2/mod/mod_log_config.html>

LICENSE
   Copyright (C) Masahiro Nagano

   This library is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.