L’entité Book est le cœur du projet. Dans ce chapitre, on configure tous les champs de BookCrudController : texte, relations, slug, le fichier PDF, l’image de couverture et l’indicateur d’archivage.

Génère le controller comme pour les autres (symfony console make:admin:crud, puis choisis Book), ajoute-le au menu, et remplissons configureFields().

Titre et résumé

TextField::new('title')->setLabel('Titre')->setRequired(true),
TextEditorField::new('summary')->setLabel('Résumé')->setRequired(true),

Le résumé utilise TextEditorField pour du texte riche. Les deux champs sont obligatoires.

Auteur et catégories

Les relations utilisent AssociationField, qui affiche une liste déroulante des entités liées :

AssociationField::new('author', 'Auteur'),
AssociationField::new('categories', 'Catégories'),

« Could not convert … to string »

Rafraîchis, et EasyAdmin lève une erreur : il ne sait pas comment afficher un Author dans la liste. La solution est d’ajouter une méthode __toString() à l’entité :

// src/Entity/Author.php
public function __toString()
{
    return $this->getFirstName() . ' ' . $this->getLastName();
}

Même erreur pour les catégories, même solution :

// src/Entity/Category.php
public function __toString(): string
{
    return $this->getCategoryName() ?? '';
}

Les placeholders

Par défaut, la liste des auteurs affiche le premier auteur, ce qui prête à confusion. On ajoute un placeholder avec setFormTypeOption(). La syntaxe diffère entre les deux champs, car celui des catégories est en ManyToMany (sélection multiple) :

AssociationField::new('author', 'Auteur')
    ->setRequired(true)
    ->setFormTypeOption('placeholder', 'Choisissez un auteur'),

AssociationField::new('categories', 'Catégories')
    ->setRequired(true)
    ->setFormTypeOption('attr', ['placeholder' => 'Choisissez une ou plusieurs catégorie(s)']),

Le slug

EasyAdmin propose un SlugField. Sa source se définit avec setTargetFieldName() : ici, la combinaison du titre et de l’auteur.

SlugField::new('bookSlug')->setTargetFieldName(['title', 'author']),

Le fichier PDF : FileField

FileField::new('bookFileName', 'Livre')
    ->setUploadDir('public/uploads/books/files/' . $path . '/')
    ->setBasePath('uploads/books/files/' . $path . '/')
    ->setUploadedFileNamePattern('[randomhash].[extension]')
    ->setRequired(true)
    ->maxSize('7M')
    ->mimeTypes('.pdf'),
OptionRôle
setUploadDir()Où le fichier est stocké sur le disque
setBasePath()Le chemin public dans l’URL (le même, sans public/)
setUploadedFileNamePattern()Un nom aléatoire, pour éviter les collisions
maxSize()Refuse les fichiers trop lourds (pas d’upload de 1 Go !)
mimeTypes()Le sélecteur de fichiers n’affiche que les PDF

Ranger les uploads par mois

Plutôt que de tout mettre dans le même dossier, je construis un petit chemin à partir de l’année et du mois de l’upload, en haut de configureFields() :

$now = new \DateTimeImmutable();
$path = $now->format('Y') . '_' . $now->format('m'); // ex. 2026_08

Les fichiers arrivent dans public/uploads/books/files/2026_08/. Le dossier files/ sépare les livres des couvertures.

Ce système a un défaut, qu’on va découvrir et corriger au chapitre 11.

La couverture : ImageField

Mêmes options, avec ImageField, un dossier images/, une limite de 2 Mo, les types MIME d’images et un message d’erreur personnalisé :

ImageField::new('coverImageName', 'Couverture')
    ->setUploadDir('public/uploads/books/images/' . $path . '/')
    ->setBasePath('uploads/books/images/' . $path . '/')
    ->setUploadedFileNamePattern('[randomhash].[extension]')
    ->setRequired(true)
    ->maxSize('2M', 'Le fichier "{{ name }}" dépasse la taille maximale autorisée ({{ limit }} {{ suffix }}).')
    ->mimeTypes('image/jpeg,image/png,image/webp'),

Archivé ou non

BooleanField::new('isArchived', 'Archivé'),

Le test

Crée un livre : titre, résumé, auteur, plusieurs catégories, un PDF et une couverture. Le sélecteur de fichiers n’affiche que les PDF pour le livre, et que les images pour la couverture. Après l’enregistrement, les fichiers sont dans public/uploads/books/files/ et public/uploads/books/images/.

Trois choses posent encore problème dans la liste :

  • le résumé affiche des balises HTML brutes
  • les catégories n’affichent qu’un nombre
  • le livre affiche le nom de fichier hashé

Ce sera pour le prochain chapitre.

Récap

  • AssociationField pour les relations, avec __toString() dans les entités liées
  • setFormTypeOption() pour les placeholders
  • SlugField + setTargetFieldName() pour des slugs automatiques
  • FileField et ImageField pour les uploads : dossier, chemin, nom, taille et type

Exercice · Des couvertures plus légères

Limite les couvertures à 1 Mo et accepte aussi les GIF.

Voir la solution
ImageField::new('coverImageName', 'Couverture')
    // … mêmes options qu'avant …
    ->maxSize('1M', 'Le fichier "{{ name }}" dépasse la taille maximale autorisée ({{ limit }} {{ suffix }}).')
    ->mimeTypes('image/jpeg,image/png,image/webp,image/gif'),

Ceci est le chapitre 9 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.