From 6fdc379c194db56e80747480bdd17ef5c3dcfc13 Mon Sep 17 00:00:00 2001 From: Andrew White Date: Mon, 12 Mar 2018 13:41:12 +0000 Subject: Add section to routing guide about config/routes.rb [ci skip] Closes #32219. --- guides/source/routing.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'guides') diff --git a/guides/source/routing.md b/guides/source/routing.md index 98aa841938..971fd548f9 100644 --- a/guides/source/routing.md +++ b/guides/source/routing.md @@ -58,6 +58,26 @@ and this in the corresponding view: then the router will generate the path `/patients/17`. This reduces the brittleness of your view and makes your code easier to understand. Note that the id does not need to be specified in the route helper. +### Configuring the Rails Router + +The routes for your application or engine live in the file `config/routes.rb` and typically looks like this: + +```ruby +Rails.application.routes.draw do + resources :brands, only: [:index, :show] + resources :products, only: [:index, :show] + end + + resource :basket, only: [:show, :update, :destroy] + + resolve("Basket") { route_for(:basket) } +end +``` + +Since this is a regular Ruby source file you can use all of its features to help you define your routes but be careful with variable names as they can clash with the DSL methods of the router. + +NOTE: The `Rails.application.routes.draw do ... end` block that wraps your route definitions is required to establish the scope for the router DSL and must not be deleted. + Resource Routing: the Rails Default ----------------------------------- -- cgit v1.2.3