# File actionpack/lib/action_dispatch/routing/url_for.rb, line 222
def route_for(name, *args)
  public_send(:"#{name}_url", *args)
end

Позволяет вызывать прямой или обычный именованный маршрут.

resources :buckets

direct :recordable do |recording|
  route_for(:bucket, recording.bucket)
end

direct :threadable do |threadable|
  route_for(:recordable, threadable.parent)
end

При этом сохраняется контекст исходного вызывающего кода: будет возвращен путь или полный URL. Например:

threadable_path(threadable)  # => "/buckets/1"
threadable_url(threadable)   # => "http://example.com/buckets/1"

# File actionpack/lib/action_dispatch/routing/url_for.rb, line 178
def url_for(options = nil)
  full_url_for(options)
end

Создает URL на основе переданных параметров, default_url_options и маршрутов, определенных в config/routes.rb. Поддерживаются следующие параметры:

• :only_path — если значение true, возвращается относительный URL. По умолчанию используется false.

• :protocol — протокол для подключения. По умолчанию используется "http".

• :host — указывает хост, на который должна вести ссылка. Если :only_path имеет значение false, этот параметр необходимо передать явно или задать через default_url_options.

• :subdomain — указывает поддомен ссылки, используя tld_length для отделения поддомена от хоста. Если значение false, все поддомены удаляются из части ссылки с хостом.

• :domain — указывает домен ссылки, используя tld_length для отделения домена от хоста.

• :tld_length — количество меток, из которых состоит идентификатор TLD; используется только при передаче :subdomain или :domain. По умолчанию используется ActionDispatch::Http::URL.tld_length, значение которого, в свою очередь, по умолчанию равно 1.

• :port — позволяет указать порт для подключения.

• :anchor — имя якоря, добавляемое в конец пути.

• :params — параметры запроса, добавляемые к пути.

• :path_params — параметры запроса, которые используются только для именованных динамических сегментов пути. Если они не используются, то отбрасываются.

• :trailing_slash — если значение true, добавляет завершающий слеш, как в "/archive/2009/".

• :script_name — задает путь приложения относительно корня домена. Если указан, путь приложения добавляется в начало.

Любые другие ключи (:controller, :action и т. д.), переданные в url_for, перенаправляются в модуль Routes.

url_for controller: 'tasks', action: 'testing', host: 'somehost.org', port: '8080'
# => 'http://somehost.org:8080/tasks/testing'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', anchor: 'ok', only_path: true
# => '/tasks/testing#ok'
url_for controller: 'tasks', action: 'testing', trailing_slash: true
# => 'http://somehost.org/tasks/testing/'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', number: '33'
# => 'http://somehost.org/tasks/testing?number=33'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', script_name: "/myapp"
# => 'http://somehost.org/myapp/tasks/testing'
url_for controller: 'tasks', action: 'testing', host: 'somehost.org', script_name: "/myapp", only_path: true
# => '/myapp/tasks/testing'

Недостающие ключи маршрута могут быть взяты из параметров текущего запроса (например, :controller, :action, :id и любые другие параметры, включенные в путь). Предположим, что текущее действие было вызвано через GET /users/1:

url_for(only_path: true)                        # => '/users/1'
url_for(only_path: true, action: 'edit')        # => '/users/1/edit'
url_for(only_path: true, action: 'edit', id: 2) # => '/users/2/edit'

Обратите внимание, что в первом вызове url_for параметр :id не был передан, и помощник использовал его из пути маршрута. Любой параметр пути, неявно используемый url_for, всегда можно переопределить, как показано в последних вызовах url_for.

# File actionpack/lib/action_dispatch/routing/url_for.rb, line 118
def url_options
  default_url_options
end

Хук переопределяется в контроллере для добавления сведений о запросе с помощью default_url_options. Логику приложения не следует помещать в url_options.