Referência rápida

Folha de dicas do Phoenix Routing

Guia rapido de referencia para Phoenix Router: verbos HTTP, rotas de recursos, helpers de rota, recursos aninhados e escopos.

· Publicado

O Phoenix Router oferece um roteamento expressivo para mapear requisicoes HTTP para acoes de controladores e LiveViews por meio de pipelines.

Inspecionando rotas (Inspecting Routes)

# Listar todas as rotas e helpers de caminho
mix phx.routes

Roteamento de recursos (Resource Routing)

# Gera todas as 7 acoes RESTful padrao
resources "/users", UserController

# Limitar acoes geradas
resources "/posts", PostController, only: [:index, :show]
resources "/comments", CommentController, except: [:delete]

Mapeamento de rotas RESTful geradas

HTTP Verb Path Action Helper Function
GET /users :index Routes.user_path(conn, :index)
GET /users/new :new Routes.user_path(conn, :new)
POST /users :create Routes.user_path(conn, :create)
GET /users/:id :show Routes.user_path(conn, :show, id)
GET /users/:id/edit :edit Routes.user_path(conn, :edit, id)
PUT / PATCH /users/:id :update Routes.user_path(conn, :update, id)
DELETE /users/:id :delete Routes.user_path(conn, :delete, id)

Recursos aninhados (Nested Resources)

resources "/users", UserController do
  resources "/posts", PostController
end

Gera helpers aninhados:

# Routes.user_post_path(conn, :index, user_id)
# Routes.user_post_path(conn, :show, user_id, post_id)

Escopos e pipelines (Scopes & Pipelines)

pipeline :browser do
  plug :accepts, ["html"]
  plug :fetch_session
  plug :protect_from_forgery
end

pipeline :api do
  plug :accepts, ["json"]
end

scope "/api", MyAppWeb.Api, as: :api do
  pipe_through :api

  resources "/articles", ArticleController
end

Referencias relacionadas

Temas relacionados