Easyadmin 4

03/03/2025
image de la page d'easyadmin lorsque l'installation a réussi

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

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

php

public 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

php

public 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

php

public 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

php

public 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

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


0 Commentaire

Soyez le premier à commenter cet article !

Laisser un commentaire

Vous devez être connecté pour commenter.

Se connecter

Commentaires récents

Aucun commentaire pour le moment