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

Константы

HOST_REGEXP
IP_HOST_REGEXP
PROTOCOL_REGEXP

Публичные методы класса

extract_domain(host, tld_length = @@tld_length) Показать исходный код

# File actionpack/lib/action_dispatch/http/url.rb, line 15
def extract_domain(host, tld_length = @@tld_length)
  host.split('.').last(1 + tld_length).join('.') if named_host?(host)
end

extract_subdomain(host, tld_length = @@tld_length) Показать исходный код

# File actionpack/lib/action_dispatch/http/url.rb, line 28
def extract_subdomain(host, tld_length = @@tld_length)
  extract_subdomains(host, tld_length).join('.')
end

extract_subdomains(host, tld_length = @@tld_length) Показать исходный код

# File actionpack/lib/action_dispatch/http/url.rb, line 19
def extract_subdomains(host, tld_length = @@tld_length)
  if named_host?(host)
    parts = host.split('.')
    parts[0..-(tld_length + 2)]
  else
    []
  end
end

new(env) Показать исходный код

Вызывает метод суперкласса

# File actionpack/lib/action_dispatch/http/url.rb, line 150
def initialize(env)
  super
  @protocol = nil
  @port     = nil
end

url_for(options = {}) Показать исходный код

# File actionpack/lib/action_dispatch/http/url.rb, line 32
def url_for(options = {})
  options = options.dup
  path  = options.delete(:script_name).to_s.chomp("/")
  path << options.delete(:path).to_s

  add_trailing_slash(path) if options[:trailing_slash]

  params = options[:params].is_a?(Hash) ? options[:params] : options.slice(:params)
  params.reject! { |_,v| v.to_param.nil? }

  result = build_host_url(options)

  result << path

  result << "?#{params.to_query}" unless params.empty?
  result << "##{Journey::Router::Utils.escape_fragment(options[:anchor].to_param.to_s)}" if options[:anchor]
  result
end

Публичные методы экземпляра

domain(tld_length = @@tld_length) Показать исходный код

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

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

host() Показать исходный код

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

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

host_with_port() Показать исходный код

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

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

optional_port() Показать исходный код

Возвращает числовой суффикс порта, например, 8080, если номер порта данного запроса не является стандартным портом HTTP 80 или HTTPS 443.

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

port() Показать исходный код

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

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

port_string() Показать исходный код

Возвращает строковый суффикс порта, включая двоеточие, например, «:8080», если номер порта данного запроса не является стандартным портом HTTP 80 или HTTPS 443.

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

protocol() Показать исходный код

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

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

raw_host_with_port() Показать исходный код

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

# File actionpack/lib/action_dispatch/http/url.rb, line 167
def raw_host_with_port
  if forwarded = env["HTTP_X_FORWARDED_HOST"].presence
    forwarded.split(/,\s?/).last
  else
    env['HTTP_HOST'] || "#{env['SERVER_NAME'] || env['SERVER_ADDR']}:#{env['SERVER_PORT']}"
  end
end

server_port() Показать исходный код

# File actionpack/lib/action_dispatch/http/url.rb, line 222
def server_port
  @env['SERVER_PORT'].to_i
end

standard_port() Показать исходный код

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

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

standard_port?() Показать исходный код

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

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

subdomain(tld_length = @@tld_length) Показать исходный код

Возвращает все поддомены как строку, поэтому "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 244
def subdomain(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomain(host, tld_length)
end

subdomains(tld_length = @@tld_length) Показать исходный код

Возвращает все поддомены в виде массива, поэтому ["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 236
def subdomains(tld_length = @@tld_length)
  ActionDispatch::Http::URL.extract_subdomains(host, tld_length)
end

url() Показать исходный код

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

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