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é :

FichierCe que c’est
composer.jsonEasyAdmin ajouté (version 5.x)
config/packages/twig_component.yamlTwig Components : ne fait pas partie d’EasyAdmin, mais est nécessaire pour afficher son interface
config/routes/easyadmin.yamlCharge les routes de l’admin
config/bundles.phpEnregistre 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:dashboard
  • make: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 dashboard
  • configureMenuItems(), 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-bundle installe EasyAdmin
  • Flex ajoute automatiquement les routes, les bundles et Twig Components
  • make:admin:dashboard gé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.