Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Symfony : le Security Bundle

Chez Symfony, l’authentification commence par la configuration. Vous dĂ©crivez en YAML comment les utilisateurs sont chargĂ©s, comment les mots de passe sont vĂ©rifiĂ©s et quelles routes exigent quel rĂŽle, et le framework l’applique Ă  chaque requĂȘte. La logique de contrĂŽle, vous ne l’écrivez jamais.

composer require symfony/security-bundle
# config/packages/security.yaml
security:
  password_hashers:
    App\Entity\User: 'auto'

  providers:
    app_user_provider:
      entity:
        class: App\Entity\User
        property: email

  firewalls:
    main:
      lazy: true
      provider: app_user_provider
      form_login:
        login_path: app_login
        check_path: app_login
      logout:
        path: app_logout

  access_control:
    - { path: ^/admin, roles: ROLE_ADMIN }
    - { path: ^/account, roles: ROLE_USER }

Le Maker Bundle gĂ©nĂšre l’entitĂ©, le formulaire et le contrĂŽleur correspondants en une commande :

composer require symfony/maker-bundle --dev
php bin/console make:user
php bin/console make:auth
php bin/console make:migration
php bin/console doctrine:migrations:migrate

Dans un contrÎleur, vérifier une permission tient en une ligne, pas dans un contrÎle manuel de la session :

class AdminController extends AbstractController
{
    #[IsGranted('ROLE_ADMIN')]
    public function dashboard(): Response
    {
        // only reachable by ROLE_ADMIN users; Symfony enforces it before this runs
    }
}

Quand le choisir

Toute application Symfony, sans vraie exception. Le Security Bundle est le chemin standard et auditĂ©. Bricoler une authentification par session Ă  cĂŽtĂ© ne ferait que ramener des bugs qu’il a dĂ©jĂ  corrigĂ©s.

Quand ce n’est pas le bon outil

Une application Symfony purement API, qui s’authentifie par jetons plutĂŽt que par sessions, utilise toujours le Security Bundle, avec un autre authentificateur (un authentificateur de jeton d’API Ă  la place de form_login). Moins un mauvais outil qu’une autre configuration du mĂȘme composant.

Sous le capot : #[IsGranted] est un attribut PHP 8, une mĂ©tadonnĂ©e accrochĂ©e Ă  la mĂ©thode et lue par Symfony Ă  l’exĂ©cution par rĂ©flexion. Le mĂȘme mĂ©canisme, attributs plus rĂ©flexion, permet Ă  une seule classe de piloter le routage, la validation et la sĂ©rialisation ailleurs dans le framework, sans fichiers de configuration rĂ©pĂ©titifs.