Routage, contrôleurs et Plugs
Définissez des routes, implémentez des actions de contrôleur et utilisez des Plugs pour créer des chaînes de traitement des requêtes modulaires et réutilisables.
Routage, contrôleurs et Plugs est une leçon Elixir & Phoenix: Scalable Backend Development gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Elixir & Phoenix: Scalable Backend Development, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Elixir & Phoenix: Scalable Backend Development comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Mapping Your Web Requests
Welcome to routing in Phoenix! Think of routing as your application's traffic controller. When a user visits a URL, the router determines which part of your code should handle that request.
It's how Phoenix connects an incoming web address (like /users) to a specific function in your application.
The `router.ex` File
In Phoenix, all your routes are defined in the lib/my_app_web/router.ex file. This file uses special macros to declare how different HTTP methods (GET, POST, PUT, DELETE) map to your application's logic.
You'll often see routes grouped into scopes and processed by pipelines, which apply common behaviors.
Defining a Simple Route
Let's look at how a basic route is defined. Here, a GET request to the root path / is mapped to the index function within PageController.
Notice the pipe_through :browser which applies a set of common behaviors to browser requests.
defmodule MyPhoenixAppWeb.Router do
use MyPhoenixAppWeb, :router
pipeline :browser do
plug :accepts, ["html"]
# ... other plugs for sessions, security, etc.
end
scope "/", MyPhoenixAppWeb do
pipe_through :browser
# Maps GET / to MyPhoenixAppWeb.PageController.index
get "/", PageController, :index
# Maps GET /hello to MyPhoenixAppWeb.PageController.hello
get "/hello", PageController, :hello
end
endControllers: Handling Requests
Once the router directs a request, a controller takes over. Controllers are Elixir modules that contain actions (functions) responsible for handling specific requests.
Their main job is to:
- Receive request parameters.
- Perform necessary business logic (e.g., fetch data).
- Prepare a response, often by rendering a template.
Your First Controller Action
Controller actions are just functions that accept two arguments: conn (the connection struct) and params (request parameters).
Here's a simple PageController with an index action that renders an index.html template.
defmodule MyPhoenixAppWeb.PageController do
use MyPhoenixAppWeb, :controller
# This action handles requests for the root path "/"
def index(conn, _params) do
# The render function looks for a template like page/index.html.heex
render(conn, "index.html")
end
# This action handles requests for "/hello"
def hello(conn, _params) do
text(conn, "Hello from Phoenix!")
end
endPath Helpers: Generating URLs
Instead of hardcoding URLs in your templates or code, Phoenix provides path helpers. These are functions that generate URLs based on your defined routes.
Using path helpers makes your links robust. If you change a route's path, you only update it in router.ex, and all generated links will automatically update.
For example, ~p"/" generates the root path.
Plugs: Request Middleware
Plugs are composable functions or modules that process the Plug.Conn (connection) struct. They act like middleware, allowing you to intercept and modify requests before they reach a controller, or modify responses after they leave.
Think of them as a series of steps a request goes through. Each plug can transform the request (or halt it) and pass it to the next plug in the pipeline.
Creating a Custom Plug
Plugs are simple Elixir modules implementing the init/1 and call/2 functions. init/1 is for configuration, and call/2 does the actual work.
Here's a plug that logs the request path and adds a custom header to the response:
defmodule MyPhoenixAppWeb.Plugs.MyLogger do
import Plug.Conn
def init(opts), do: opts
def call(conn, _opts) do
IO.puts("Request received for path: #{conn.request_path}")
put_resp_header(conn, "X-Custom-Header", "Hello from Plug!")
end
endUsing a Custom Plug
To use your custom plug, you add it to a pipeline in your router.ex file. All requests passing through that pipeline will then be processed by your plug.
For example, adding plug MyPhoenixAppWeb.Plugs.MyLogger to the :browser pipeline means every browser request will trigger this plug.
- Plug.Parsers: Parses request bodies (JSON, forms).
- Plug.Logger: Logs request details.
- Plug.Static: Serves static assets like CSS/JS.
Quick Check: Phoenix Request Flow
Let's test your understanding of how Phoenix handles web requests.
Recap: Routing, Controllers, Plugs
In this lesson, you've learned the core components that handle web requests in Phoenix:
- Routes (in
router.ex) map incoming URLs to controller actions. - Controllers contain actions (functions) that execute business logic and prepare responses.
- Plugs are reusable components that process the request connection (
Plug.Conn) in a pipeline, before or after the controller.
Together, these form a powerful and flexible system for building web applications.
Questions Fréquemment Posées
La leçon « Routage, contrôleurs et Plugs » est-elle gratuite ?
Oui — le texte complet de « Routage, contrôleurs et Plugs » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Elixir & Phoenix: Scalable Backend Development, passe à CoddyKit PRO. Le cours Elixir & Phoenix: Scalable Backend Development comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Routage, contrôleurs et Plugs » ?
Définissez des routes, implémentez des actions de contrôleur et utilisez des Plugs pour créer des chaînes de traitement des requêtes modulaires et réutilisables. Tu pratiques Elixir & Phoenix: Scalable Backend Development avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Elixir & Phoenix: Scalable Backend Development ?
Aucune expérience préalable n'est requise. Elixir & Phoenix: Scalable Backend Development sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.
Combien de temps prend la leçon « Routage, contrôleurs et Plugs » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Elixir & Phoenix: Scalable Backend Development ?
Oui. Chaque leçon Elixir & Phoenix: Scalable Backend Development inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Configuration et structure d’un projet Phoenix
- Routage, contrôleurs et Plugs
- Vues, modèles et bases de LiveView
- Fonctionnalités en temps réel avec les Channels Phoenix