Objectif : Lister des tâches, afficher le détail d'une tâche

Définition du périmètre fonctionnel initial de notre gestionnaire

L'objectif fondamental de cette première phase de notre mini-projet Symfony est de construire une application web capable d'exécuter deux actions principales concernant la gestion de tâches : premièrement, présenter à l'utilisateur une liste complète de toutes les tâches existantes, et deuxièmement, permettre à l'utilisateur de consulter les informations spécifiques associées à une tâche particulière en cliquant dessus ou en accédant à son URL dédiée.

Ces deux fonctionnalités, bien que simples en apparence, couvrent un large spectre des opérations de base que l'on retrouve dans la majorité des applications web. Lister des éléments implique de récupérer un ensemble de données et de les présenter de manière structurée. Afficher le détail d'un élément spécifique nécessite de pouvoir identifier cet élément de manière unique, de récupérer ses informations propres, et de les afficher distinctement. Maîtriser ces deux aspects est donc une étape essentielle dans l'apprentissage de tout framework web.

Simplification : L'abstraction de la base de données pour une focalisation pédagogique

Afin de concentrer nos efforts sur la compréhension du fonctionnement interne de Symfony et sur le cycle de vie d'une requête HTTP (depuis sa réception jusqu'à l'envoi de la réponse), nous allons volontairement omettre l'utilisation d'une base de données pour cette première itération du projet. La gestion de la persistance des données, bien qu'essentielle dans les applications réelles, introduit une couche de complexité supplémentaire que nous aborderons dans des modules ultérieurs.

Pour simuler la présence de données, nous allons directement encoder nos tâches (comprenant un identifiant unique, un titre et une description) sous la forme d'un tableau PHP au sein de notre contrôleur. Par exemple :

// Dans votre TaskController.php
private array $tasks = [
    ['id' => 1, 'title' => 'Faire les courses', 'description' => 'Acheter du lait, du pain et des oeufs.'],
    ['id' => 2, 'title' => 'Réviser Symfony', 'description' => 'Relire le chapitre sur les contrôleurs et les routes.'],
    ['id' => 3, 'title' => 'Planifier la réunion', 'description' => 'Envoyer l\'ordre du jour et les invitations.'],
];

Cette approche présente l'avantage pédagogique de nous permettre de nous focaliser sur les mécanismes de routage, la logique des contrôleurs, et la création de templates avec Twig, sans être distraits par la configuration d'un ORM ou l'écriture de requêtes SQL. Les données sont ainsi immédiatement disponibles pour être manipulées et affichées.

Résultats attendus et compétences acquises à l'issue de ce jalon

A la fin de ce module de projet guidé, vous aurez développé une compréhension pratique et concrète de la manière dont les composants fondamentaux de Symfony – le routeur, les contrôleurs et le moteur de templating Twig – collaborent pour générer des pages web dynamiques. Vous serez en mesure de traduire une exigence fonctionnelle simple en une implémentation technique au sein du framework.

Plus spécifiquement, vous saurez :

• Définir des routes en utilisant les attributs PHP pour mapper des URLs à des actions de contrôleur.
• Créer des méthodes d'action dans un contrôleur pour traiter les requêtes entrantes et préparer les données nécessaires à l'affichage.
• Passer des variables depuis un contrôleur vers un template Twig.
• Utiliser la syntaxe Twig (boucles, conditions, affichage de variables) pour construire la structure HTML d'une page et y insérer dynamiquement des données.
• Gérer les paramètres de route pour afficher des informations spécifiques à un élément.
• Lever des exceptions standards de Symfony, comme NotFoundHttpException, pour gérer les cas où une ressource demandée n'existe pas.

Cette expérience initiale de construction d'une fonctionnalité de bout en bout, de la requête de l'utilisateur jusqu'à la réponse affichée dans son navigateur, est cruciale. Elle établit une base solide sur laquelle nous pourrons ensuite greffer des concepts plus avancés, tels que la gestion des formulaires, la validation des données et l'interaction avec une base de données.