модуль ActionDispatch::Http::URL

# File actionpack/lib/action_dispatch/http/url.rb, line 21
def extract_domain(host, tld_length)
  extract_domain_from(host, tld_length) if named_host?(host)
end

Возвращает доменную часть хоста с учетом уровня домена.

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

# File actionpack/lib/action_dispatch/http/url.rb, line 45
def extract_subdomain(host, tld_length)
  extract_subdomains(host, tld_length).join(".")
end

Возвращает поддомены хоста как строку с учетом уровня домена.

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

# File actionpack/lib/action_dispatch/http/url.rb, line 31
def extract_subdomains(host, tld_length)
  if named_host?(host)
    extract_subdomains_from(host, tld_length)
  else
    []
  end
end

Возвращает поддомены хоста как массив с учетом уровня домена.

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

# File actionpack/lib/action_dispatch/http/url.rb, line 329
def domain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_domain(host, tld_length)
end

Возвращает доменную часть хоста, например, «rubyonrails.org» в «www.rubyonrails.org». Вы можете указать другой tld_length, например, 2, чтобы получить rubyonrails.co.uk в «www.rubyonrails.co.uk».

# File actionpack/lib/action_dispatch/http/url.rb, line 233
def host
  raw_host_with_port.sub(/:\d+$/, "")
end

Возвращает хост для этого запроса, например, «example.com».

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

# File actionpack/lib/action_dispatch/http/url.rb, line 249
def host_with_port
  "#{host}#{port_string}"
end

Возвращает строку хост:порт для этого запроса, например, «example.com» или «example.com:8080». Порт включается только в том случае, если он не является стандартным портом (80 или 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"

# File actionpack/lib/action_dispatch/http/url.rb, line 300
def optional_port
  standard_port? ? nil : port
end

Возвращает числовой суффикс порта, например, 8080, если номер порта этого запроса не является стандартным портом HTTP 80 или HTTPS 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

# File actionpack/lib/action_dispatch/http/url.rb, line 260
def port
  @port ||= begin
    if raw_host_with_port =~ /:(\d+)$/
      $1.to_i
    else
      standard_port
    end
  end
end

Возвращает номер порта этого запроса как целое число.

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

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

# File actionpack/lib/action_dispatch/http/url.rb, line 312
def port_string
  standard_port? ? "" : ":#{port}"
end

Возвращает строковый суффикс порта, включая двоеточие, например, «:8080», если номер порта этого запроса не является стандартным портом HTTP 80 или HTTPS 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"

# File actionpack/lib/action_dispatch/http/url.rb, line 207
def protocol
  @protocol ||= ssl? ? "https://" : "http://"
end

Возвращает 'https://', если это запрос SSL, и 'http://' в противном случае.

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

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

# File actionpack/lib/action_dispatch/http/url.rb, line 221
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

Возвращает хост и порт для этого запроса, например, «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"

# File actionpack/lib/action_dispatch/http/url.rb, line 323
def server_port
  get_header("SERVER_PORT").to_i
end

Возвращает запрашиваемый порт, например, 8080, на основе SERVER_PORT

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

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

# File actionpack/lib/action_dispatch/http/url.rb, line 274
def standard_port
  case protocol
  when "https://" then 443
  else 80
  end
end

Возвращает стандартный номер порта для протокола этого запроса.

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

# File actionpack/lib/action_dispatch/http/url.rb, line 288
def standard_port?
  port == standard_port
end

Возвращает, использует ли этот запрос стандартный порт

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

# File actionpack/lib/action_dispatch/http/url.rb, line 345
def subdomain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomain(host, tld_length)
end

Возвращает все поддомены в виде строки, например, "dev.www" для «dev.www.rubyonrails.org». Вы можете указать другой tld_length, например, 2, чтобы получить "www" вместо "www.rubyonrails" в «www.rubyonrails.co.uk».

# File actionpack/lib/action_dispatch/http/url.rb, line 337
def subdomains(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomains(host, tld_length)
end

Возвращает все поддомены в виде массива, например, ["dev", "www"] для «dev.www.rubyonrails.org». Вы можете указать другой tld_length, например, 2, чтобы получить ["www"] вместо ["www", "rubyonrails"] в «www.rubyonrails.co.uk».

# File actionpack/lib/action_dispatch/http/url.rb, line 196
def url
  protocol + host_with_port + fullpath
end

Возвращает полный URL, используемый для этого запроса.

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