 module ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Http8b7c:f320:99b9:690f:4595:cd17:293a:c069URL     Constants   HOST_REGEXP 
IP_HOST_REGEXP 
PROTOCOL_REGEXP 
    Public Class Methods    extract_domain(host, tld_length) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 20
def extract_domain(host, tld_length)
  extract_domain_from(host, tld_length) if named_host?(host)
end  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"
     extract_subdomain(host, tld_length) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 44
def extract_subdomain(host, tld_length)
  extract_subdomains(host, tld_length).join(".")
end  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"
     extract_subdomains(host, tld_length) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 30
def extract_subdomains(host, tld_length)
  if named_host?(host)
    extract_subdomains_from(host, tld_length)
  else
    []
  end
end  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"]
     full_url_for(options) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 56
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      new() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 187
def initialize
  super
  @protocol = nil
  @port     = nil
end   Calls superclass method      path_for(options) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 68
def path_for(options)
  path = options[:script_name].to_s.chomp("/".freeze)
  path << options[:path] if options.key?(:path)

  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)

  path
end      url_for(options) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 48
def url_for(options)
  if options[:only_path]
    path_for options
  else
    full_url_for options
  end
end       Public Instance Methods    domain(tld_length = @@tld_length) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 330
def domain(tld_length = @@tld_length)
  ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Http8b7c:f320:99b9:690f:4595:cd17:293a:c069URL.extract_domain(host, tld_length)
end  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”.     host() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 234
def host
  raw_host_with_port.sub(/:\d+$/, "".freeze)
end  Returns the host for this request, such as “example.com”. req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.host # => "example.com"
     host_with_port() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 250
def host_with_port
  "#{host}#{port_string}"
end  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 = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com'
req.host_with_port # => "example.com"

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:80'
req.host_with_port # => "example.com"

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.host_with_port # => "example.com:8080"
     optional_port() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 301
def optional_port
  standard_port? ? nil : port
end  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 = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:80'
req.optional_port # => nil

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.optional_port # => 8080
     port() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 261
def port
  @port ||= begin
    if raw_host_with_port =~ /:(\d+)$/
      $1.to_i
    else
      standard_port
    end
  end
end  Returns the port number of this request as an integer. req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com'
req.port # => 80

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.port # => 8080
     port_string() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 313
def port_string
  standard_port? ? "" : ":#{port}"
end  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 = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:80'
req.port_string # => ""

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.port_string # => ":8080"
     protocol() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 208
def protocol
  @protocol ||= ssl? ? "https://" : "http://"
end  Returns 'https://' if this is an SSL request and 'http://' otherwise. req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com'
req.protocol # => "http://"

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com', 'HTTPS' => 'on'
req.protocol # => "https://"
     raw_host_with_port() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 222
def raw_host_with_port
  if forwarded = x_forwarded_host.presence
    forwarded.split(/,\s?/).last
  else
    get_header("HTTP_HOST") || "#{server_name || server_addr}:#{get_header('SERVER_PORT')}"
  end
end  Returns the host and port for this request, such as “example.com:8080”. req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com'
req.raw_host_with_port # => "example.com"

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:80'
req.raw_host_with_port # => "example.com:80"

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.raw_host_with_port # => "example.com:8080"
     server_port() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 324
def server_port
  get_header("SERVER_PORT").to_i
end  Returns the requested port, such as 8080, based on SERVER_PORT req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'SERVER_PORT' => '80'
req.server_port # => 80

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'SERVER_PORT' => '8080'
req.server_port # => 8080
     standard_port() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 275
def standard_port
  case protocol
  when "https://" then 443
    else 80
  end
end  Returns the standard port number for this request's protocol. req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.standard_port # => 80
     standard_port?() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 289
def standard_port?
  port == standard_port
end  Returns whether this request is using the standard port req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:80'
req.standard_port? # => true

req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com:8080'
req.standard_port? # => false
     subdomain(tld_length = @@tld_length) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 346
def subdomain(tld_length = @@tld_length)
  ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Http8b7c:f320:99b9:690f:4595:cd17:293a:c069URL.extract_subdomain(host, tld_length)
end  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”.     subdomains(tld_length = @@tld_length) Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 338
def subdomains(tld_length = @@tld_length)
  ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Http8b7c:f320:99b9:690f:4595:cd17:293a:c069URL.extract_subdomains(host, tld_length)
end  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”.     url() Show source  
 # File actionpack/lib/action_dispatch/http/url.rb, line 197
def url
  protocol + host_with_port + fullpath
end  Returns the complete URL used for this request. req = ActionDispatch8b7c:f320:99b9:690f:4595:cd17:293a:c069Request.new 'HTTP_HOST' => 'example.com'
req.url # => "http://example.com"
    

    
{'path': 'public/docs/rails~5.1/actiondispatch/http/url.html', 'source': 'DevDocs.IO'}