apache-config-generator/lib/apache/logging.rb

module Apache
  # Methods to handle logging configuration are defined here.
  #
  # For each of the four main log types (Custom, Error, Script, and Rewrite), the following two methods are created:
  #
  # * (type)_log: A non-rotated log file
  # * rotate_(type)_log: A rotated log file
  #
  # Non-rotated logs work as such:
  #  custom_log "/path/to/log/file.log", :common #=> CustomLog "/path/to/log/file.log" common
  #
  # Rotated logs work as such:
  #  rotate_custom_log "/path/to/log/file-%Y%m%d.log", 86400, :common
  #    #=> CustomLog "|/path/to/rotatelogs /path/to/log/file-%Y%m%d.jpg 86400" common
  #
  # Both variations check to make sure the log file diretory exists during generation.
  # The rotate_ variations need @rotate_logs_path set to work.
  module Logging
    [ :custom, :error, :script, :rewrite ].each do |type|
      class_eval <<-EOT
        def #{type}_log(*opts)
          handle_log '#{type.to_s.capitalize}Log', opts.first, quoteize(opts.first), opts[1..-1]
        end

        def rotate_#{type}_log(*opts)
          handle_log '#{type.to_s.capitalize}Log', opts.first, quoteize(rotatelogs(*opts[0..1])), opts[2..-1]
        end
      EOT
    end

    def combined_log_format(name = 'combined')
      log_format '%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"', name.to_sym
    end

    def common_log_format(name = 'common')
      log_format '%h %l %u %t \"%r\" %>s %b', name.to_sym
    end

    private
      def handle_log(tag, path, real_path, *opts)
        writable? path
        self << "#{tag} #{[real_path, opts].flatten * " "}"
      end
  end
end