Phoenix Router предоставляет выразительную систему маршрутизации для связывания HTTP-запросов с действиями контроллеров и LiveViews.
Просмотр маршрутов (Inspecting Routes)
# Вывод всех определенных маршрутов и хелперов
mix phx.routes
Ресурсная маршрутизация (Resource Routing)
# Создает все 7 стандартных RESTful-действий
resources "/users", UserController
# Ограничение генерируемых действий
resources "/posts", PostController, only: [:index, :show]
resources "/comments", CommentController, except: [:delete]
Таблица сопоставления RESTful-маршрутов
| 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) |
Вложенные ресурсы (Nested Resources)
resources "/users", UserController do
resources "/posts", PostController
end
Генерирует вложенные хелперы путей:
# Routes.user_post_path(conn, :index, user_id)
# Routes.user_post_path(conn, :show, user_id, post_id)
Области видимости и пайплайны (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