class Rack::Handler::FastCGI - rack-1.6.1 Documentation

# class Rack::Handler::FastCGI

### Public Class Methods

run(app, options={}) click to toggle source

    # File lib/rack/handler/fastcgi.rb, line 21
    def self.run(app, options={})
      if options[:File]
        STDIN.reopen(UNIXServer.new(options[:File]))
      elsif options[:Port]
        STDIN.reopen(TCPServer.new(options[:Host], options[:Port]))
      end
      FCGI.each { |request|
        serve request, app
      }
    end

send_body(out, body) click to toggle source

    # File lib/rack/handler/fastcgi.rb, line 93
    def self.send_body(out, body)
      body.each { |part|
        out.print part
        out.flush
      }
    end

send_headers(out, status, headers) click to toggle source

    # File lib/rack/handler/fastcgi.rb, line 82
    def self.send_headers(out, status, headers)
      out.print "Status: #{status}\r\n"
      headers.each { |k, vs|
        vs.split("\n").each { |v|
          out.print "#{k}: #{v}\r\n"
        }
      }
      out.print "\r\n"
      out.flush
    end

serve(request, app) click to toggle source

    # File lib/rack/handler/fastcgi.rb, line 43
    def self.serve(request, app)
      env = request.env
      env.delete "HTTP_CONTENT_LENGTH"

      env["SCRIPT_NAME"] = ""  if env["SCRIPT_NAME"] == "/"

      rack_input = RewindableInput.new(request.in)

      env.update({"rack.version" => Rack::VERSION,
                   "rack.input" => rack_input,
                   "rack.errors" => request.err,

                   "rack.multithread" => false,
                   "rack.multiprocess" => true,
                   "rack.run_once" => false,

                   "rack.url_scheme" => ["yes", "on", "1"].include?(env["HTTPS"]) ? "https" : "http"
                 })

      env[QUERY_STRING]   ||= ""
      env["HTTP_VERSION"] ||= env["SERVER_PROTOCOL"]
      env["REQUEST_PATH"] ||= "/"
      env.delete "CONTENT_TYPE"  if env["CONTENT_TYPE"] == ""
      env.delete "CONTENT_LENGTH"  if env["CONTENT_LENGTH"] == ""

      begin
        status, headers, body = app.call(env)
        begin
          send_headers request.out, status, headers
          send_body request.out, body
        ensure
          body.close  if body.respond_to? :close
        end
      ensure
        rack_input.close
        request.finish
      end
    end

valid_options() click to toggle source

    # File lib/rack/handler/fastcgi.rb, line 32
    def self.valid_options
      environment  = ENV['RACK_ENV'] || 'development'
      default_host = environment == 'development' ? 'localhost' : '0.0.0.0'

      {
        "Host=HOST" => "Hostname to listen on (default: #{default_host})",
        "Port=PORT" => "Port to listen on (default: 8080)",
        "File=PATH" => "Creates a Domain socket at PATH instead of a TCP socket. Ignores Host and Port if set.",
      }
    end