class ActionDispatch::FileHandler
does not exist, a 404 “File not Found” response will be returned.
located at ‘public/assets/application.js` if the file exists. If the file
`assets/application.js` will return a response with the contents of a file
is set to `public/`, then a request with `env` of
where the base path is in the root
directory. For example, if the root
This middleware will render the file specified in `env`
when a response containing a file’s contents is delivered.
When initialized, it can accept optional HTTP headers, which will be set
This middleware returns a file’s contents from disk in the body response.
def call(env)
def call(env) serve(Rack::Request.new(env)) end
def content_type(path)
def content_type(path) ::Rack::Mime.mime_type(::File.extname(path), 'text/plain'.freeze) end
def ext
def ext ::ActionController::Base.default_static_extension end
def gzip_encoding_accepted?(request)
def gzip_encoding_accepted?(request) request.accept_encoding.any? { |enc, quality| enc =~ /\bgzip\b/i } end
def gzip_file_path(path)
def gzip_file_path(path) can_gzip_mime = content_type(path) =~ /\A(?:text\/|application\/javascript)/ gzip_path = "#{path}.gz" if can_gzip_mime && File.exist?(File.join(@root, ::Rack::Utils.unescape_path(gzip_path))) gzip_path else false end end
def initialize(root, index: 'index', headers: {})
def initialize(root, index: 'index', headers: {}) @root = root.chomp('/') @file_server = ::Rack::File.new(@root, headers) @index = index end
def match?(path)
Used by the `Static` class to check the existence of a valid file
representing the filename. Otherwise, false is returned.
correct read permissions, the return value is a URI-escaped string
Takes a path to a file. If the file is found, has valid encoding, and has
def match?(path) path = ::Rack::Utils.unescape_path path return false unless valid_path?(path) path = Rack::Utils.clean_path_info path paths = [path, "#{path}#{ext}", "#{path}/#{@index}#{ext}"] if match = paths.detect { |p| path = File.join(@root, p.force_encoding('UTF-8'.freeze)) begin File.file?(path) && File.readable?(path) rescue SystemCallError false end } return ::Rack::Utils.escape_path(match) end end
def serve(request)
def serve(request) path = request.path_info gzip_path = gzip_file_path(path) if gzip_path && gzip_encoding_accepted?(request) request.path_info = gzip_path status, headers, body = @file_server.call(request.env) if status == 304 return [status, headers, body] end headers['Content-Encoding'] = 'gzip' headers['Content-Type'] = content_type(path) else status, headers, body = @file_server.call(request.env) end headers['Vary'] = 'Accept-Encoding' if gzip_path return [status, headers, body] ensure request.path_info = path end
def valid_path?(path)
def valid_path?(path) path.valid_encoding? && !path.include?("\0") end