On attaque maintenant la partie administration de notre bibliothèque. On va utiliser EasyAdminBundle, qui permet de construire très vite un back-office complet : écrans CRUD, gestion des entités, et beaucoup de temps gagné.
Prérequis
EasyAdmin a besoin de :
- PHP 8.2 ou plus
- Symfony 6.4 ou plus (on est sur Symfony 8)
- Doctrine ORM (déjà installé avec
--webapp)
Installation
Dans le terminal de VS Code :
composer require easycorp/easyadmin-bundle
Ce qui a été ajouté
Une fois Composer et Symfony Flex terminés, voici ce qui a changé :
| Fichier | Ce que c’est |
|---|---|
composer.json | EasyAdmin ajouté (version 5.x) |
config/packages/twig_component.yaml | Twig Components : ne fait pas partie d’EasyAdmin, mais est nécessaire pour afficher son interface |
config/routes/easyadmin.yaml | Charge les routes de l’admin |
config/bundles.php | Enregistre TwigComponentBundle et EasyAdminBundle |
Voici le fichier de routes :
# config/routes/easyadmin.yaml
easyadmin:
resource: .
type: easyadmin.routes
Les nouvelles commandes console
EasyAdmin ajoute aussi des commandes Maker qui génèrent des classes pour nous. Affiche-les avec :
symfony console
Tu y trouveras notamment :
make:admin:dashboardmake:admin:crud
Générer le dashboard
symfony console make:admin:dashboard
On garde les réponses par défaut :
- Nom de la classe :
DashboardController - Dossier :
src/Controller/Admin/
La commande crée src/Controller/Admin/DashboardController.php. On y trouve :
- la route
/admin, déclarée avec l’attribut#[AdminDashboard] - une méthode
index()avec trois options commentées pour choisir ce que le dashboard affiche configureDashboard(), qui définit le titre du dashboardconfigureMenuItems(), qui construit le menu latéral, en commençant par un élément Dashboard avec son icône Font Awesome
#[AdminDashboard(routePath: '/admin', routeName: 'admin')]
class DashboardController extends AbstractDashboardController
{
public function index(): Response
{
return parent::index();
}
public function configureDashboard(): Dashboard
{
return Dashboard::new()
->setTitle('Minibib');
}
public function configureMenuItems(): iterable
{
yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');
}
}
Ouvrir l’admin
Va sur http://127.0.0.1:8000/admin au lieu de /home : tu vois la page « Welcome to EasyAdmin 5 », avec des liens vers la documentation.
Récap
composer require easycorp/easyadmin-bundleinstalle EasyAdmin- Flex ajoute automatiquement les routes, les bundles et Twig Components
make:admin:dashboardgénère le controller du dashboard- L’admin se trouve sur
/admin
Exercice · Personnalise le dashboard
Change le titre du dashboard en « Mini Bibliothèque » et ajoute, dans le menu, une section « Catalogue » sous l’élément Dashboard.
Voir la solution
public function configureDashboard(): Dashboard
{
return Dashboard::new()
->setTitle('Mini Bibliothèque');
}
public function configureMenuItems(): iterable
{
yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home');
yield MenuItem::section('Catalogue');
}
MenuItem::section() ajoute un intertitre dans le menu : pratique pour regrouper les CRUD qu’on va créer (livres, auteurs, catégories).
La suite
On va remplacer la page d’accueil par notre propre template de dashboard.
Ceci est le chapitre 5 du cours Mini Bibliothèque. Suis la série pour construire de zéro une application complète de bibliothèque numérique avec Symfony 8 et EasyAdmin.