Symfony用户认证通过配置SecurityBundle实现，无需编写认证逻辑：安装bundle后，定义登录控制器与模板（含CSRF token），再在security.yaml中设置access_control路径规则及角色权限。
用 Symfony 创建用户认证，就是配置 SecurityBundle 并定义用户来源、登录路径与访问控制规则，让系统能识别登录态、拦截未授权请求、跳转到登录页——不写一行认证逻辑代码，也能跑通完整流程。
安装并启用 SecurityBundle
运行命令安装安全组件：
composer require symfony/security-bundle
安装后，Bundle 会自动注册。若使用旧版 Symfony（config/bundles.php 中确认存在 Symfony\Bundle\SecurityBundle\SecurityBundle::class => ['all' => true]。
【必须启用 enable_authenticator_manager: true】 否则后续表单登录将无法工作；该开关自 Symfony 5.3 起成为强制要求，旧配置方式（如 form_login 直接挂 firewall 下）已被废弃。
定义用户实体与用户提供器
第一步：创建 User 实体类，实现 UserInterface 接口：
运行 php bin/console make:user，按提示输入类名（如 User）、是否用邮箱登录、是否支持 API Token 等。该命令自动生成实体、密码哈希逻辑、用户提供器骨架及数据库迁移。
第二步：确保实体中包含 getPassword()、getSalt()（已弃用，可返回 null）、eraseCredentials() 等必需方法；若使用 Doctrine，还需添加 @ORM\Entity 和字段映射。
第三步：检查 config/packages/security.yaml 中的用户提供器配置是否匹配：
providers:
app_user_provider:
entity:
class: App\Entity\User
property: email
property 值必须与你实体中用于登录的字段名一致（如 username 或 email），填错会导致登录时查不到用户。
配置防火墙与表单登录
在 security.yaml 的 firewalls 下添加 main 防火墙：
firewalls:
main:
lazy: true
provider: app_user_provider
custom_authenticator: App\Security\AppAuthenticator
logout:
path: app_logout
target: app_home
注意：不要保留旧式 form_login: 块——它只在 enable_authenticator_manager: false 时有效，而你现在已启用新认证器管理器。
运行 php bin/console make:auth，选择「Login form authenticator」，输入类名（如 AppAuthenticator），它会生成一个继承 LoginFormAuthenticator 的类，并自动注册为 custom_authenticator。
生成的 AppAuthenticator.php 中，authenticate() 方法已预置用户名/密码提取逻辑；onAuthenticationSuccess() 返回重定向响应，默认跳转至 target_path 或 /。
创建登录控制器与模板
方法一：用命令快速生成
运行 php bin/console make:controller LoginController，然后在 login() 方法中注入 AuthenticationUtils，调用 $authenticationUtils->getLastAuthenticationError() 和 getLastUsername() 获取错误与上次输入的用户名。
方法二：手写最小化控制器
在 src/Controller/LoginController.php 中写：
#[Route('/login', name: 'app_login')]
public function login(AuthenticationUtils $authenticationUtils): Response
{
$error = $authenticationUtils->getLastAuthenticationError();
$lastUsername = $authenticationUtils->getLastUsername();
return $this->render('login/index.html.twig', compact('error', 'lastUsername'));
}
模板路径必须是 templates/login/index.html.twig，且表单 action 指向 path('app_login')，method 为 POST，隐藏域包含 _csrf_token 字段（{{ csrf_token('authenticate') }}）。
这一步漏掉 CSRF token，表单提交会直接 403 拒绝——SecurityBundle 默认启用 CSRF 保护，且 token id 必须与认证器中 getCsrfTokenId() 返回值一致（默认是 authenticate）。
设置访问控制规则
在 security.yaml 的 access_control 下逐行添加路径限制：
access_control:
- { path: ^/admin, roles: ROLE_ADMIN }
- { path: ^/profile, roles: ROLE_USER }
- { path: ^/login, roles: PUBLIC_ACCESS }
ROLE_ADMIN 和 ROLE_USER 是角色名，不是数据库字段；它们由用户实体的 getRoles() 方法返回，该方法必须返回字符串数组（如 ['ROLE_USER']）。
PUBLIC_ACCESS 是特殊角色标识，表示无需登录即可访问；也可写作 IS_AUTHENTICATED_ANONYMOUSLY，效果相同。
路径匹配使用正则前缀匹配，^/admin 匹配 /admin、/admin/、/admin/settings，但不匹配 /administration。
