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.