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

module Apache
  # Options that aren't specific to a particular purpose go here. Once enough like methods for a
  # particular purpose exist, break them out into a separate module.
  module Master
    class << self
      def listening_on
        @listening_on ||= []
      end
    end

    # Build a module list.
    # Wraps around Modules.build
    def modules(*modules, &block)
      @config += Modules.build(*modules, &block)
    end

    # Listen on network interfaces and ports
    #
    # Each provided parameter generates a new Listen line:
    #  listen "1.2.3.4:80", "2.3.4.5:80" #=>
    #    Listen "1.2.3.4:80"
    #    Listen "2.3.4.5:80"
    def listen(*opt)
      opt.collect(&:quoteize).each do |adapter|
        if !Apache::Master.listening_on.include?(adapter)
          self << "Listen #{adapter}"
          Apache::Master.listening_on << adapter
        else
          $stderr.puts "Multiple Listens for #{adapter}".foreground(:red)
        end
      end
    end
    alias :listen! :listen

    # Add a User/Group block
    #  runner('www', 'www-data') #=>
    #    User www
    #    Group www-data
    def runner(user, group)
      user! user
      group! group
    end

    # Enable Passenger on this server
    #
    # This assumes that Passenger was installed via the gem. This may or may not work for you, but it works for me.
    def passenger(ruby_root, ruby_version, passenger_version)
      load_module 'passenger_module', "#{ruby_root}/lib/ruby/gems/#{ruby_version}/gems/passenger-#{passenger_version}/ext/apache2/mod_passenger.so"
      passenger_root "#{ruby_root}/lib/ruby/gems/#{ruby_version}/gems/passenger-#{passenger_version}"
      passenger_ruby "#{ruby_root}/bin/ruby"
    end

    # Enable gzip compression server-wide on pretty much everything that can be gzip compressed
    def enable_gzip!
      directory '/' do
        add_output_filter_by_type! :DEFLATE, 'text/html', 'text/plain', 'text/css', 'text/javascript', 'application/javascript'
        browser_match! '^Mozilla/4', "gzip-only-text/html"
        browser_match! '^Mozilla/4\.0[678]', "no-gzip"
        browser_match! '\bMSIE', '!no-gzip', '!gzip-only-text/html'
      end
    end

    # Set the TCP timeout. Defined here to get around various other timeout methods.
    def timeout(time)
      self << "Timeout #{time}"
    end

    # Add a comment to the Apache config. Can pass in either a String or Array of comment lines.
    def comment(what)
      self + [ '', what.commentize, '' ].flatten.collect { |line| "# #{line.strip}".strip }
    end

    # Create a ScriptAlias, checking to make sure the filesystem path exists.
    def script_alias(uri, path)
      directory? path
      self << %{ScriptAlias #{[ uri, path ].quoteize * ' '}}
    end

    alias :script_alias! :script_alias

    # Add a MIME type, potentially also adding handlers and encodings
    #  add_type! 'text/html', '.shtml', :handler => 'server-parsed'
    #  add_type! 'text/html', '.gz', :encoding => 'gzip'
    def add_type!(mime, extension, options = {})
      self << "AddType #{mime} #{extension}"
      options.each do |type, value|
        self << "Add#{type.to_s.capitalize} #{value} #{extension}"
      end
    end

    # Include other config files or directories.
    # Used to get around reserved Ruby keyword.
    def apache_include(*opts)
      self << "Include #{opts * " "}"
    end

    # Alias a URL to a directory in the filesystem.
    # Used to get around reserved Ruby keyword.
    def apache_alias(*opts)
      self << "Alias #{opts.quoteize * " "}"
    end

    # Set multiple headers to be delivered for a particular section
    #  set_header 'Content-type' => 'application/octet-stream',
    #             'Content-disposition' => [ 'attachment', 'env=only-for-downloads' ] #=>
    #  Header set "Content-type" "application/octet-stream"
    #  Header set "Content-dispoaition" "attachment" env=only-for-downloads
    def set_header(hash)
      hash.each do |key, value|
        self << "Header set #{key.quoteize} #{value.headerize}"
      end
    end

    def server_name(*opts)
      if first = opts.shift
        self << "ServerName #{first.quoteize}"
        opts.each { |name| server_alias name } if !opts.empty?
      end
    end

    def document_root(*opts)
      dir = opts.first
      directory? dir
      self << "DocumentRoot #{dir.quoteize}"
    end
    alias :document_root! :document_root
  end
end