Symfony认证系统如何添加登录成功与失败的系统日志？

嘿，我来帮你搞定Symfony里的登录日志记录问题！你之前的代码只能记录登录页访问，是因为没准确捕获登录成功/失败的状态——毕竟Symfony的认证逻辑是由Security组件处理的，登录成功后会直接重定向，控制器里的代码根本跑不到成功后的逻辑。下面给你两种方案，推荐用更规范的事件监听器方式：

方案一：用Symfony事件监听器（推荐，符合最佳实践） #

这种方式能精准捕获所有登录成功/失败事件，不管登录请求来自表单还是其他入口，都能统一记录。

1. 创建登录成功监听器

新建src/EventListener/SuccessLoginListener.php：

namespace App\EventListener;

use App\Entity\Logs;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Component\Security\Http\Event\AuthenticationSuccessEvent;

class SuccessLoginListener
{
    private $entityManager;

    public function __construct(EntityManagerInterface $entityManager)
    {
        $this->entityManager = $entityManager;
    }

    public function onAuthenticationSuccess(AuthenticationSuccessEvent $event)
    {
        $user = $event->getUser();
        $request = $event->getRequest();

        $log = new Logs();
        $log->setAction('login_success')
            ->setDate(new \DateTime())
            ->setIp($request->getClientIp())
            ->setUsername($user->getUserIdentifier()); // 换成你用户实体里的用户名字段，比如getUsername()

        $this->entityManager->persist($log);
        $this->entityManager->flush();
    }
}

2. 创建登录失败监听器

新建src/EventListener/FailureLoginListener.php：

namespace App\EventListener;

use App\Entity\Logs;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Component\Security\Http\Event\AuthenticationFailureEvent;

class FailureLoginListener
{
    private $entityManager;

    public function __construct(EntityManagerInterface $entityManager)
    {
        $this->entityManager = $entityManager;
    }

    public function onAuthenticationFailure(AuthenticationFailureEvent $event)
    {
        $request = $event->getRequest();
        $exception = $event->getAuthenticationException();
        $lastUsername = $request->request->get('_username'); // 对应你登录表单里的用户名输入框name属性

        $log = new Logs();
        $log->setAction('login_failed')
            ->setDate(new \DateTime())
            ->setIp($request->getClientIp())
            ->setUsername($lastUsername)
            ->setMessage($exception->getMessage()); // 记录具体错误原因，比如"用户名不存在"或"密码错误"

        $this->entityManager->persist($log);
        $this->entityManager->flush();
    }
}

3. 注册监听器

在config/services.yaml里添加监听器标签（Symfony 4+开启autoconfigure的话可能自动注册，但手动加更稳妥）：

services:
    App\EventListener\SuccessLoginListener:
        tags:
            - { name: kernel.event_listener, event: security.authentication.success }

    App\EventListener\FailureLoginListener:
        tags:
            - { name: kernel.event_listener, event: security.authentication.failure }

4. 完善Logs实体

确保你的Logs实体有这些字段（根据需要调整）：

// src/Entity/Logs.php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity(repositoryClass="App\Repository\LogsRepository")
 */
class Logs
{
    /**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */
    private $id;

    /**
     * @ORM\Column(type="string", length=255)
     */
    private $action; // 比如login_success/login_failed

    /**
     * @ORM\Column(type="datetime")
     */
    private $date;

    /**
     * @ORM\Column(type="string", length=45)
     */
    private $ip;

    /**
     * @ORM\Column(type="string", length=255, nullable=true)
     */
    private $username;

    /**
     * @ORM\Column(type="text", nullable=true)
     */
    private $message; // 记录失败时的错误信息

    // 记得生成所有字段的getter和setter方法
}

方案二：快速在LoginController里处理失败记录（仅临时用） #

如果只是想快速记录登录失败，也可以在你现有的login方法里修改，但登录成功还是得用事件监听器（因为成功后会重定向，控制器代码执行不到）：

public function login(AuthenticationUtils $authenticationUtils, Request $request, EntityManagerInterface $em): Response {
    // 移除原来的通用访问日志，或者保留但区分状态
    $error = $authenticationUtils->getLastAuthenticationError();
    $lastUsername = $authenticationUtils->getLastUsername();

    // 记录登录失败
    if ($error) {
        $log = new Logs();
        $log->setAction('login_failed')
            ->setDate(new \DateTime())
            ->setIp($request->getClientIp())
            ->setUsername($lastUsername)
            ->setMessage($error->getMessage());
        
        $em->persist($log);
        $em->flush();
    }

    return $this->render('security/login.html.twig', ['last_username' => $lastUsername, 'error' => $error]);
}

最后提醒下：方案一的事件监听器是Symfony官方推荐的做法，能覆盖所有认证场景，比控制器里硬编码更灵活、更符合框架设计理念。

内容的提问来源于stack exchange，提问作者Ambu