EasyAdmin 4 : C'est le Bundle Symfony pour Créer des Interfaces d'Administration rapidement
Introduction
EasyAdmin 4 est un bundle Symfony puissant qui permet de créer rapidement des interfaces d'administration modernes et responsives. Il offre une solution clé en main pour gérer vos entités Doctrine avec une interface utilisateur élégante et personnalisable.
EasyAdmin 4
- Support complet à partir de Symfony 6.x et PHP 8
- Interface modernisée et responsive
- Meilleure gestion des actions et filtres
- Support amélioré des formulaires complexes
- Nouveau système de templates Twig
- Support complet à partir de Symfony 6.x et PHP 8
- Interface modernisée et responsive
- Meilleure gestion des actions et filtres
- Support amélioré des formulaires complexes
- Nouveau système de templates Twig
Installation et Configuration de Base
Installation via Composer :
composer require easycorp/easyadmin-bundle
Création du Dashboard :
php bin/console make:admin:dashboard
Création des CRUD Controllers :
php bin/console make:admin:crud
Configuration du Dashboard
php// src/Controller/Admin/DashboardController.php namespace App\Controller\Admin; use EasyCorp\Bundle\EasyAdminBundle\Config\Dashboard; use EasyCorp\Bundle\EasyAdminBundle\Config\MenuItem; use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractDashboardController; use Symfony\Component\HttpFoundation\Response; use Symfony\Component\Routing\Annotation\Route; class DashboardController extends AbstractDashboardController { #[Route('/admin', name: 'admin')] public function index(): Response { return $this->render('admin/dashboard.html.twig'); } public function configureDashboard(): Dashboard { return Dashboard::new() ->setTitle('Mon Application') ->setFaviconPath('favicon.svg') ->setTranslationDomain('admin'); } public function configureMenuItems(): iterable { yield MenuItem::linkToDashboard('Dashboard', 'fa fa-home'); yield MenuItem::linkToCrud('Utilisateurs', 'fa fa-user', User::class); yield MenuItem::linkToCrud('Produits', 'fa fa-shopping-cart', Product::class); yield MenuItem::linkToRoute('Retour au site', 'fa fa-home', 'homepage'); } }
Création CRUD Controllers
Exemple pour une entité Product
php// src/Controller/Admin/ProductCrudController.php namespace App\Controller\Admin; use App\Entity\Product; use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController; use EasyCorp\Bundle\EasyAdminBundle\Field\IdField; use EasyCorp\Bundle\EasyAdminBundle\Field\TextField; use EasyCorp\Bundle\EasyAdminBundle\Field\TextEditorField; use EasyCorp\Bundle\EasyAdminBundle\Field\MoneyField; use EasyCorp\Bundle\EasyAdminBundle\Field\ImageField; class ProductCrudController extends AbstractCrudController { public static function getEntityFqcn(): string { return Product::class; } public function configureFields(string $pageName): iterable { return [ IdField::new('id')->hideOnForm(), TextField::new('name'), TextField::new('description')->hideOnIndex(), ou TextEditorField::new('description')->hideOnIndex(), MoneyField::new('price')->setCurrency('EUR'), ImageField::new('image') ->setBasePath('uploads/products') ->setUploadDir('public/uploads/products') ]; } }
Personnalisation de l'Interface
Configuration des Champs
phppublic function configureFields(string $pageName): iterable { return [ // Champs basiques TextField::new('title')->setRequired(true), TextEditorField::new('content'), // Champs relationnels AssociationField::new('category'), // Champs conditionnels TextField::new('author')->hideOnIndex(), // Champs personnalisés DateTimeField::new('createdAt') ->setFormat('d/m/Y H:i') ->renderAsNative(), // Upload de fichiers ImageField::new('image') ->setUploadDir('public/uploads') ->setBasePath('uploads/') ->setRequired(false), ]; }
Personnalisation des Actions
phppublic function configureActions(Actions $actions): Actions { return $actions // Actions globales ->add(Crud::PAGE_INDEX, Action::NEW) ->add(Crud::PAGE_INDEX, Action::DETAIL) // Actions personnalisées ->add(Crud::PAGE_INDEX, Action::new('export', 'Exporter') ->linkToCrudAction('export') ->addCssClass('btn btn-success')) // Modification des actions existantes ->update(Crud::PAGE_INDEX, Action::NEW, function (Action $action) { return $action->setIcon('fa fa-plus')->addCssClass('btn btn-primary'); }); }
Configuration des Filtres
phppublic function configureFilters(Filters $filters): Filters { return $filters ->add('name') ->add('price') ->add(DateTimeFilter::new('createdAt')) ->add(EntityFilter::new('category')); }
Fonctionnalités Avancées
Actions Personnalisées
phppublic function export() { $products = $this->getDoctrine() ->getRepository(Product::class) ->findAll(); // Logique d'export return $this->file($filePath, 'export.csv'); }
Gestion des Permissions
php// config/packages/security.yaml security: access_control: - { path: ^/admin, roles: ROLE_ADMIN } // Dans le CrudController public function configureActions(Actions $actions): Actions { return $actions ->setPermission(Action::NEW, 'ROLE_SUPER_ADMIN') ->setPermission(Action::DELETE, 'ROLE_SUPER_ADMIN'); }
Templates Personnalisés
twig{# templates/admin/dashboard.html.twig #} {% extends '@EasyAdmin/page/content.html.twig' %} {% block content %} <div class="row"> <div class="col"> {# Contenu personnalisé #} </div> </div> {% endblock %}
Bonnes Pratiques
Organisation du Code
src/ Controller/ Admin/ DashboardController.php ProductCrudController.php UserCrudController.php Entity/ Repository/
Sécurité
- Toujours vérifier les permissions
- Valider les données entrantes
- Utiliser HTTPS pour l'admin
Performance
- Utiliser la pagination
- Optimiser les requêtes Doctrine
- Mettre en cache quand possible
- Toujours vérifier les permissions
- Valider les données entrantes
- Utiliser HTTPS pour l'admin
Performance
- Utiliser la pagination
- Optimiser les requêtes Doctrine
- Mettre en cache quand possible
Conclusion
EasyAdmin 4 est un outil puissant qui permet de créer rapidement des interfaces d'administration professionnelles. Ses principaux avantages sont :
- Rapidité de mise en place
- Haute personnalisation
- Intégration parfaite avec Symfony
- Communauté active
Ressources Complémentaires
Soyez le premier à commenter cet article !