2013-02-19 04:53:05 -05:00
|
|
|
require 'active_support/core_ext/module/attribute_accessors'
|
|
|
|
|
2010-01-16 07:17:03 -05:00
|
|
|
module ActionDispatch
|
|
|
|
module Http
|
|
|
|
module URL
|
2013-04-18 12:02:21 -04:00
|
|
|
IP_HOST_REGEXP = /\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/
|
2015-04-16 16:20:57 -04:00
|
|
|
HOST_REGEXP = /(^[^:]+:\/\/)?(\[[^\]]+\]|[^:]+)(?::(\d+$))?/
|
2013-04-18 12:02:21 -04:00
|
|
|
PROTOCOL_REGEXP = /^([^:]+)(:)?(\/\/)?$/
|
2012-01-12 11:35:43 -05:00
|
|
|
|
2010-07-27 10:39:28 -04:00
|
|
|
mattr_accessor :tld_length
|
2010-11-16 05:49:08 -05:00
|
|
|
self.tld_length = 1
|
2010-07-27 10:39:28 -04:00
|
|
|
|
2010-12-03 07:27:43 -05:00
|
|
|
class << self
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
# Returns the domain part of a host given the domain level.
|
|
|
|
#
|
|
|
|
# # Top-level domain example
|
|
|
|
# extract_domain('www.example.com', 1) # => "example.com"
|
|
|
|
# # Second-level domain example
|
|
|
|
# extract_domain('dev.www.example.co.uk', 2) # => "example.co.uk"
|
2014-06-11 17:32:18 -04:00
|
|
|
def extract_domain(host, tld_length)
|
2014-06-12 13:01:35 -04:00
|
|
|
extract_domain_from(host, tld_length) if named_host?(host)
|
2010-12-03 07:27:43 -05:00
|
|
|
end
|
2010-11-22 18:31:03 -05:00
|
|
|
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
# Returns the subdomains of a host as an Array given the domain level.
|
|
|
|
#
|
|
|
|
# # Top-level domain example
|
|
|
|
# extract_subdomains('www.example.com', 1) # => ["www"]
|
|
|
|
# # Second-level domain example
|
|
|
|
# extract_subdomains('dev.www.example.co.uk', 2) # => ["dev", "www"]
|
2014-06-11 17:32:18 -04:00
|
|
|
def extract_subdomains(host, tld_length)
|
2012-11-16 06:35:26 -05:00
|
|
|
if named_host?(host)
|
2014-06-12 14:22:38 -04:00
|
|
|
extract_subdomains_from(host, tld_length)
|
2012-11-16 06:35:26 -05:00
|
|
|
else
|
|
|
|
[]
|
|
|
|
end
|
2010-12-03 07:27:43 -05:00
|
|
|
end
|
2010-11-22 18:31:03 -05:00
|
|
|
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
# Returns the subdomains of a host as a String given the domain level.
|
|
|
|
#
|
|
|
|
# # Top-level domain example
|
|
|
|
# extract_subdomain('www.example.com', 1) # => "www"
|
|
|
|
# # Second-level domain example
|
|
|
|
# extract_subdomain('dev.www.example.co.uk', 2) # => "dev.www"
|
2014-06-11 17:32:18 -04:00
|
|
|
def extract_subdomain(host, tld_length)
|
2010-12-03 07:27:43 -05:00
|
|
|
extract_subdomains(host, tld_length).join('.')
|
2010-11-30 10:36:01 -05:00
|
|
|
end
|
|
|
|
|
2014-05-09 20:12:08 -04:00
|
|
|
def url_for(options)
|
2014-07-16 21:15:15 -04:00
|
|
|
if options[:only_path]
|
|
|
|
path_for options
|
|
|
|
else
|
2014-07-17 13:47:58 -04:00
|
|
|
full_url_for options
|
2014-07-16 21:15:15 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2014-07-17 13:47:58 -04:00
|
|
|
def full_url_for(options)
|
|
|
|
host = options[:host]
|
|
|
|
protocol = options[:protocol]
|
|
|
|
port = options[:port]
|
|
|
|
|
|
|
|
unless host
|
|
|
|
raise ArgumentError, 'Missing host to link to! Please provide the :host parameter, set default_url_options[:host], or set :only_path to true'
|
|
|
|
end
|
|
|
|
|
|
|
|
build_host_url(host, port, protocol, options, path_for(options))
|
|
|
|
end
|
|
|
|
|
2014-07-16 21:15:15 -04:00
|
|
|
def path_for(options)
|
2015-03-01 19:05:50 -05:00
|
|
|
path = options[:script_name].to_s.chomp("/".freeze)
|
2014-07-31 12:12:04 -04:00
|
|
|
path << options[:path] if options.key?(:path)
|
2014-07-31 12:14:14 -04:00
|
|
|
|
|
|
|
add_trailing_slash(path) if options[:trailing_slash]
|
|
|
|
add_params(path, options[:params]) if options.key?(:params)
|
|
|
|
add_anchor(path, options[:anchor]) if options.key?(:anchor)
|
|
|
|
|
2014-07-31 12:09:32 -04:00
|
|
|
path
|
2014-07-16 21:13:22 -04:00
|
|
|
end
|
|
|
|
|
|
|
|
private
|
|
|
|
|
2014-07-31 12:09:32 -04:00
|
|
|
def add_params(path, params)
|
2014-07-31 12:08:58 -04:00
|
|
|
params = { params: params } unless params.is_a?(Hash)
|
2014-07-31 12:05:56 -04:00
|
|
|
params.reject! { |_,v| v.to_param.nil? }
|
2015-08-14 18:19:56 -04:00
|
|
|
query = params.to_query
|
|
|
|
path << "?#{query}" unless query.empty?
|
2014-07-16 21:13:22 -04:00
|
|
|
end
|
2014-05-09 20:31:13 -04:00
|
|
|
|
2014-07-31 12:09:32 -04:00
|
|
|
def add_anchor(path, anchor)
|
2014-11-22 08:42:19 -05:00
|
|
|
if anchor
|
|
|
|
path << "##{Journey::Router::Utils.escape_fragment(anchor.to_param)}"
|
|
|
|
end
|
2010-12-03 07:27:43 -05:00
|
|
|
end
|
2010-11-30 10:36:01 -05:00
|
|
|
|
2014-06-12 13:01:35 -04:00
|
|
|
def extract_domain_from(host, tld_length)
|
|
|
|
host.split('.').last(1 + tld_length).join('.')
|
|
|
|
end
|
|
|
|
|
2014-06-12 14:22:38 -04:00
|
|
|
def extract_subdomains_from(host, tld_length)
|
|
|
|
parts = host.split('.')
|
|
|
|
parts[0..-(tld_length + 2)]
|
|
|
|
end
|
|
|
|
|
2014-05-05 18:25:29 -04:00
|
|
|
def add_trailing_slash(path)
|
|
|
|
# includes querysting
|
|
|
|
if path.include?('?')
|
|
|
|
path.sub!(/\?/, '/\&')
|
|
|
|
# does not have a .format
|
|
|
|
elsif !path.include?(".")
|
|
|
|
path.sub!(/[^\/]\z|\A\z/, '\&/')
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2014-07-16 21:13:22 -04:00
|
|
|
def build_host_url(host, port, protocol, options, path)
|
2014-06-11 14:48:39 -04:00
|
|
|
if match = host.match(HOST_REGEXP)
|
2014-07-31 12:18:51 -04:00
|
|
|
protocol ||= match[1] unless protocol == false
|
|
|
|
host = match[2]
|
|
|
|
port = match[3] unless options.key? :port
|
2014-05-20 18:29:40 -04:00
|
|
|
end
|
2012-04-24 10:09:34 -04:00
|
|
|
|
2014-07-31 12:18:51 -04:00
|
|
|
protocol = normalize_protocol protocol
|
|
|
|
host = normalize_host(host, options)
|
2013-04-18 12:02:21 -04:00
|
|
|
|
2014-06-11 14:36:50 -04:00
|
|
|
result = protocol.dup
|
2013-04-18 12:02:21 -04:00
|
|
|
|
2014-05-20 18:29:40 -04:00
|
|
|
if options[:user] && options[:password]
|
|
|
|
result << "#{Rack::Utils.escape(options[:user])}:#{Rack::Utils.escape(options[:password])}@"
|
|
|
|
end
|
2014-05-20 18:20:16 -04:00
|
|
|
|
2014-06-11 14:48:39 -04:00
|
|
|
result << host
|
2014-06-12 02:45:37 -04:00
|
|
|
normalize_port(port, protocol) { |normalized_port|
|
|
|
|
result << ":#{normalized_port}"
|
2014-06-11 14:33:22 -04:00
|
|
|
}
|
2014-05-20 18:20:16 -04:00
|
|
|
|
2014-07-16 21:13:22 -04:00
|
|
|
result.concat path
|
2012-04-24 10:09:34 -04:00
|
|
|
end
|
|
|
|
|
2010-12-03 07:27:43 -05:00
|
|
|
def named_host?(host)
|
2014-06-11 17:40:45 -04:00
|
|
|
IP_HOST_REGEXP !~ host
|
2010-12-03 07:27:43 -05:00
|
|
|
end
|
|
|
|
|
2014-06-11 14:36:50 -04:00
|
|
|
def normalize_protocol(protocol)
|
|
|
|
case protocol
|
2013-04-18 12:02:21 -04:00
|
|
|
when nil
|
|
|
|
"http://"
|
|
|
|
when false, "//"
|
|
|
|
"//"
|
|
|
|
when PROTOCOL_REGEXP
|
|
|
|
"#{$1}://"
|
|
|
|
else
|
2014-06-11 14:36:50 -04:00
|
|
|
raise ArgumentError, "Invalid :protocol option: #{protocol.inspect}"
|
2013-03-18 17:09:15 -04:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2014-06-11 14:48:39 -04:00
|
|
|
def normalize_host(_host, options)
|
2014-06-11 17:40:45 -04:00
|
|
|
return _host unless named_host?(_host)
|
2010-11-30 10:36:01 -05:00
|
|
|
|
|
|
|
tld_length = options[:tld_length] || @@tld_length
|
2014-06-12 13:10:31 -04:00
|
|
|
subdomain = options.fetch :subdomain, true
|
2014-06-12 13:05:26 -04:00
|
|
|
domain = options[:domain]
|
2010-11-30 10:36:01 -05:00
|
|
|
|
2014-06-11 17:05:04 -04:00
|
|
|
host = ""
|
2014-06-12 13:10:31 -04:00
|
|
|
if subdomain == true
|
2014-06-12 13:05:26 -04:00
|
|
|
return _host if domain.nil?
|
2014-06-11 16:55:46 -04:00
|
|
|
|
2014-06-12 14:22:38 -04:00
|
|
|
host << extract_subdomains_from(_host, tld_length).join('.')
|
2014-06-11 18:30:12 -04:00
|
|
|
elsif subdomain
|
|
|
|
host << subdomain.to_param
|
2011-10-04 04:16:34 -04:00
|
|
|
end
|
2013-04-18 12:02:21 -04:00
|
|
|
host << "." unless host.empty?
|
2014-06-12 13:05:26 -04:00
|
|
|
host << (domain || extract_domain_from(_host, tld_length))
|
2010-11-30 10:36:01 -05:00
|
|
|
host
|
|
|
|
end
|
2013-04-18 12:02:21 -04:00
|
|
|
|
2014-06-11 14:27:07 -04:00
|
|
|
def normalize_port(port, protocol)
|
2014-06-11 14:33:22 -04:00
|
|
|
return unless port
|
2013-04-18 12:02:21 -04:00
|
|
|
|
2014-06-11 14:27:07 -04:00
|
|
|
case protocol
|
2014-06-11 14:33:22 -04:00
|
|
|
when "//" then yield port
|
2013-04-18 12:02:21 -04:00
|
|
|
when "https://"
|
2014-06-11 14:33:22 -04:00
|
|
|
yield port unless port.to_i == 443
|
2013-04-18 12:02:21 -04:00
|
|
|
else
|
2014-06-11 14:33:22 -04:00
|
|
|
yield port unless port.to_i == 80
|
2013-04-18 12:02:21 -04:00
|
|
|
end
|
|
|
|
end
|
2010-11-30 10:36:01 -05:00
|
|
|
end
|
|
|
|
|
2015-09-04 20:36:15 -04:00
|
|
|
def initialize
|
2012-08-09 14:21:58 -04:00
|
|
|
super
|
|
|
|
@protocol = nil
|
|
|
|
@port = nil
|
|
|
|
end
|
|
|
|
|
2010-07-27 10:39:28 -04:00
|
|
|
# Returns the complete URL used for this request.
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com'
|
|
|
|
# req.url # => "http://example.com"
|
2010-01-16 07:17:03 -05:00
|
|
|
def url
|
2010-03-03 03:31:55 -05:00
|
|
|
protocol + host_with_port + fullpath
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
# Returns 'https://' if this is an SSL request and 'http://' otherwise.
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com'
|
|
|
|
# req.protocol # => "http://"
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com', 'HTTPS' => 'on'
|
|
|
|
# req.protocol # => "https://"
|
2010-01-16 07:17:03 -05:00
|
|
|
def protocol
|
2010-09-27 11:37:40 -04:00
|
|
|
@protocol ||= ssl? ? 'https://' : 'http://'
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
# Returns the \host for this request, such as "example.com".
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com'
|
|
|
|
# req.raw_host_with_port # => "example.com"
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.raw_host_with_port # => "example.com:8080"
|
2010-01-16 07:17:03 -05:00
|
|
|
def raw_host_with_port
|
2015-08-24 19:14:42 -04:00
|
|
|
if forwarded = x_forwarded_host.presence
|
2010-01-16 07:17:03 -05:00
|
|
|
forwarded.split(/,\s?/).last
|
|
|
|
else
|
2015-08-24 19:14:42 -04:00
|
|
|
get_header('HTTP_HOST') || "#{server_name || server_addr}:#{get_header('SERVER_PORT')}"
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Returns the host for this request, such as example.com.
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.host # => "example.com"
|
2010-01-16 07:17:03 -05:00
|
|
|
def host
|
2015-07-19 17:19:15 -04:00
|
|
|
raw_host_with_port.sub(/:\d+$/, ''.freeze)
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
# Returns a \host:\port string for this request, such as "example.com" or
|
|
|
|
# "example.com:8080".
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:80'
|
|
|
|
# req.host_with_port # => "example.com"
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.host_with_port # => "example.com:8080"
|
2010-01-16 07:17:03 -05:00
|
|
|
def host_with_port
|
2010-11-24 04:10:38 -05:00
|
|
|
"#{host}#{port_string}"
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
# Returns the port number of this request as an integer.
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com'
|
|
|
|
# req.port # => 80
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.port # => 8080
|
2010-01-16 07:17:03 -05:00
|
|
|
def port
|
2010-11-22 18:31:03 -05:00
|
|
|
@port ||= begin
|
|
|
|
if raw_host_with_port =~ /:(\d+)$/
|
|
|
|
$1.to_i
|
|
|
|
else
|
|
|
|
standard_port
|
|
|
|
end
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Returns the standard \port number for this request's protocol.
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.standard_port # => 80
|
2010-01-16 07:17:03 -05:00
|
|
|
def standard_port
|
|
|
|
case protocol
|
|
|
|
when 'https://' then 443
|
|
|
|
else 80
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2010-08-19 10:29:54 -04:00
|
|
|
# Returns whether this request is using the standard port
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:80'
|
|
|
|
# req.standard_port? # => true
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.standard_port? # => false
|
2010-08-19 10:29:54 -04:00
|
|
|
def standard_port?
|
|
|
|
port == standard_port
|
|
|
|
end
|
|
|
|
|
2010-11-24 04:10:38 -05:00
|
|
|
# Returns a number \port suffix like 8080 if the \port number of this request
|
2010-01-16 07:17:03 -05:00
|
|
|
# is not the default HTTP \port 80 or HTTPS \port 443.
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:80'
|
|
|
|
# req.optional_port # => nil
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.optional_port # => 8080
|
2010-11-22 18:31:03 -05:00
|
|
|
def optional_port
|
|
|
|
standard_port? ? nil : port
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
2010-11-24 04:10:38 -05:00
|
|
|
# Returns a string \port suffix, including colon, like ":8080" if the \port
|
|
|
|
# number of this request is not the default HTTP \port 80 or HTTPS \port 443.
|
Add docs for ActionDispatch::Http::URL methods
Add docs for `extract_domain`, `extract_subdomains`, `extract_subdomain`.
Add doc examples for `url`, `protocol`, `raw_host_with_port`, `host`,
`host_with_port`, `port`, `standard_port`, `standard_port?`, `optional_port`,
`port_string`.
[ci skip]
2014-12-17 15:10:43 -05:00
|
|
|
#
|
|
|
|
# class Request < Rack::Request
|
|
|
|
# include ActionDispatch::Http::URL
|
|
|
|
# end
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:80'
|
|
|
|
# req.port_string # => ""
|
|
|
|
#
|
|
|
|
# req = Request.new 'HTTP_HOST' => 'example.com:8080'
|
|
|
|
# req.port_string # => ":8080"
|
2010-11-24 04:10:38 -05:00
|
|
|
def port_string
|
|
|
|
standard_port? ? '' : ":#{port}"
|
|
|
|
end
|
|
|
|
|
2010-01-16 07:17:03 -05:00
|
|
|
def server_port
|
2015-08-24 19:39:47 -04:00
|
|
|
get_header('SERVER_PORT').to_i
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
# Returns the \domain part of a \host, such as "rubyonrails.org" in "www.rubyonrails.org". You can specify
|
|
|
|
# a different <tt>tld_length</tt>, such as 2 to catch rubyonrails.co.uk in "www.rubyonrails.co.uk".
|
2010-11-16 05:49:08 -05:00
|
|
|
def domain(tld_length = @@tld_length)
|
2010-11-22 18:31:03 -05:00
|
|
|
ActionDispatch::Http::URL.extract_domain(host, tld_length)
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
|
|
|
# Returns all the \subdomains as an array, so <tt>["dev", "www"]</tt> would be
|
|
|
|
# returned for "dev.www.rubyonrails.org". You can specify a different <tt>tld_length</tt>,
|
|
|
|
# such as 2 to catch <tt>["www"]</tt> instead of <tt>["www", "rubyonrails"]</tt>
|
|
|
|
# in "www.rubyonrails.co.uk".
|
2010-07-27 10:39:28 -04:00
|
|
|
def subdomains(tld_length = @@tld_length)
|
2010-11-22 18:31:03 -05:00
|
|
|
ActionDispatch::Http::URL.extract_subdomains(host, tld_length)
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
|
2010-11-22 18:31:03 -05:00
|
|
|
# Returns all the \subdomains as a string, so <tt>"dev.www"</tt> would be
|
|
|
|
# returned for "dev.www.rubyonrails.org". You can specify a different <tt>tld_length</tt>,
|
2011-05-04 15:53:10 -04:00
|
|
|
# such as 2 to catch <tt>"www"</tt> instead of <tt>"www.rubyonrails"</tt>
|
2010-11-22 18:31:03 -05:00
|
|
|
# in "www.rubyonrails.co.uk".
|
2010-07-27 10:39:28 -04:00
|
|
|
def subdomain(tld_length = @@tld_length)
|
2012-01-12 11:47:25 -05:00
|
|
|
ActionDispatch::Http::URL.extract_subdomain(host, tld_length)
|
2010-02-28 18:16:34 -05:00
|
|
|
end
|
2010-01-16 07:17:03 -05:00
|
|
|
end
|
|
|
|
end
|
2010-10-26 14:31:05 -04:00
|
|
|
end
|