Module: ActionDispatch::Http::URL

Included in:
Request
Defined in:
lib/action_dispatch/http/url.rb

Constant Summary collapse

IP_HOST_REGEXP = 
/\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/
HOST_REGEXP = 
/(^[^:]+:\/\/)?(\[[^\]]+\]|[^:]+)(?::(\d+$))?/
PROTOCOL_REGEXP = 
/^([^:]+)(:)?(\/\/)?$/

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.extract_domain(host, tld_length) ⇒ Object

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"



24
25
26
 
# File 'lib/action_dispatch/http/url.rb', line 24

def extract_domain(host, tld_length)
  extract_domain_from(host, tld_length) if named_host?(host)
end

.extract_subdomain(host, tld_length) ⇒ Object

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"



48
49
50
 
# File 'lib/action_dispatch/http/url.rb', line 48

def extract_subdomain(host, tld_length)
  extract_subdomains(host, tld_length).join(".")
end

.extract_subdomains(host, tld_length) ⇒ Object

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"]



34
35
36
37
38
39
40
 
# File 'lib/action_dispatch/http/url.rb', line 34

def extract_subdomains(host, tld_length)
  if named_host?(host)
    extract_subdomains_from(host, tld_length)
  else
    []
  end
end

.full_url_for(options) ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
 
# File 'lib/action_dispatch/http/url.rb', line 60

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

.path_for(options) ⇒ Object 



72
73
74
75
76
77
78
79
80
81
82
 
# File 'lib/action_dispatch/http/url.rb', line 72

def path_for(options)
  path = options[:script_name].to_s.chomp("/")
  path << options[:path] if options.key?(:path)

  path = "/" if options[:trailing_slash] && path.blank?

  add_params(path, options[:params]) if options.key?(:params)
  add_anchor(path, options[:anchor]) if options.key?(:anchor)

  path
end

.url_for(options) ⇒ Object 



52
53
54
55
56
57
58
 
# File 'lib/action_dispatch/http/url.rb', line 52

def url_for(options)
  if options[:only_path]
    path_for options
  else
    full_url_for options
  end
end

Instance Method Details

#domain(tld_length = @@tld_length) ⇒ Object

Returns the domain part of a host, such as “rubyonrails.org” in “www.rubyonrails.org”. You can specify a different ‘tld_length`, such as 2 to catch rubyonrails.co.uk in “www.rubyonrails.co.uk”.



324
325
326
 
# File 'lib/action_dispatch/http/url.rb', line 324

def domain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_domain(host, tld_length)
end

#host ⇒ Object

Returns the host for this request, such as “example.com”.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.host # => "example.com"



228
229
230
 
# File 'lib/action_dispatch/http/url.rb', line 228

def host
  raw_host_with_port.sub(/:\d+$/, "")
end

#host_with_port ⇒ Object

Returns a host:port string for this request, such as “example.com” or “example.com:8080”. Port is only included if it is not a default port (80 or 443)

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.host_with_port # => "example.com"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.host_with_port # => "example.com"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.host_with_port # => "example.com:8080"



244
245
246
 
# File 'lib/action_dispatch/http/url.rb', line 244

def host_with_port
  "#{host}#{port_string}"
end

#initialize ⇒ Object 



181
182
183
184
185
 
# File 'lib/action_dispatch/http/url.rb', line 181

def initialize
  super
  @protocol = nil
  @port     = nil
end

#optional_port ⇒ Object

Returns a number port suffix like 8080 if the port number of this request is not the default HTTP port 80 or HTTPS port 443.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.optional_port # => nil

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.optional_port # => 8080



294
295
296
 
# File 'lib/action_dispatch/http/url.rb', line 294

def optional_port
  standard_port? ? nil : port
end

#port ⇒ Object

Returns the port number of this request as an integer.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.port # => 80

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.port # => 8080



255
256
257
258
259
260
261
 
# File 'lib/action_dispatch/http/url.rb', line 255

def port
  @port ||= if raw_host_with_port =~ /:(\d+)$/
    $1.to_i
  else
    standard_port
  end
end

#port_string ⇒ Object

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.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.port_string # => ""

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.port_string # => ":8080"



306
307
308
 
# File 'lib/action_dispatch/http/url.rb', line 306

def port_string
  standard_port? ? "" : ":#{port}"
end

#protocol ⇒ Object

Returns ‘https://’ if this is an SSL request and ‘http://’ otherwise.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.protocol # => "http://"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com', 'HTTPS' => 'on'
req.protocol # => "https://"



202
203
204
 
# File 'lib/action_dispatch/http/url.rb', line 202

def protocol
  @protocol ||= ssl? ? "https://" : "http://"
end

#raw_host_with_port ⇒ Object

Returns the host and port for this request, such as “example.com:8080”.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.raw_host_with_port # => "example.com"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.raw_host_with_port # => "example.com:80"

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.raw_host_with_port # => "example.com:8080"



216
217
218
219
220
221
222
 
# File 'lib/action_dispatch/http/url.rb', line 216

def raw_host_with_port
  if forwarded = x_forwarded_host.presence
    forwarded.split(/,\s?/).last
  else
    get_header("HTTP_HOST") || "#{server_name}:#{get_header('SERVER_PORT')}"
  end
end

#server_port ⇒ Object

Returns the requested port, such as 8080, based on SERVER_PORT

req = ActionDispatch::Request.new 'SERVER_PORT' => '80'
req.server_port # => 80

req = ActionDispatch::Request.new 'SERVER_PORT' => '8080'
req.server_port # => 8080



317
318
319
 
# File 'lib/action_dispatch/http/url.rb', line 317

def server_port
  get_header("SERVER_PORT").to_i
end

#standard_port ⇒ Object

Returns the standard port number for this request’s protocol.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.standard_port # => 80



267
268
269
270
271
272
273
 
# File 'lib/action_dispatch/http/url.rb', line 267

def standard_port
  if "https://" == protocol
    443
  else
    80
  end
end

#standard_port? ⇒ Boolean

Returns whether this request is using the standard port

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:80'
req.standard_port? # => true

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com:8080'
req.standard_port? # => false

Returns:

  • (Boolean) 


282
283
284
 
# File 'lib/action_dispatch/http/url.rb', line 282

def standard_port?
  port == standard_port
end

#subdomain(tld_length = @@tld_length) ⇒ Object

Returns all the subdomains as a string, so ‘“dev.www”` would be returned for “dev.www.rubyonrails.org”. You can specify a different `tld_length`, such as 2 to catch `“www”` instead of `“www.rubyonrails”` in “www.rubyonrails.co.uk”.



339
340
341
 
# File 'lib/action_dispatch/http/url.rb', line 339

def subdomain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomain(host, tld_length)
end

#subdomains(tld_length = @@tld_length) ⇒ Object

Returns all the subdomains as an array, so ‘[“dev”, “www”]` would be returned for “dev.www.rubyonrails.org”. You can specify a different `tld_length`, such as 2 to catch `[“www”]` instead of `[“www”, “rubyonrails”]` in “www.rubyonrails.co.uk”.



332
333
334
 
# File 'lib/action_dispatch/http/url.rb', line 332

def subdomains(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomains(host, tld_length)
end

#url ⇒ Object

Returns the complete URL used for this request.

req = ActionDispatch::Request.new 'HTTP_HOST' => 'example.com'
req.url # => "http://example.com"



191
192
193
 
# File 'lib/action_dispatch/http/url.rb', line 191

def url
  protocol + host_with_port + fullpath
end