Как Symfony находит классы AsEventListener?

Классы «находятся» по общей конфигурации «сервисов». В этом атрибуте нет ничего особенного для того, чтобы сделать классы доступными как сервисы в Symfony.

Например, при установке Symfony по умолчанию:

# config/services.yaml
services:
    # default configuration for services in *this* file
    _defaults:
        autowire: true      # Automatically injects dependencies in your services.
        autoconfigure: true # Automatically registers your services as commands, event subscribers, etc.

    # makes classes in src/ available to be used as services
    # this creates a service per class whose id is the fully-qualified class name
    App\:
        resource: '../src/'
        exclude:
            - '../src/DependencyInjection/'
            - '../src/Entity/'
            - '../src/Kernel.php'

Это говорит Symfony искать все под src, за исключением трех перечисленных исключений.

За поиск и загрузку этих файлов отвечает класс Symfony\Component\DependencyInjection\Loader\FileLoader. Проверьте методы findClasses и registerClasses.

Код, который вы нашли на FrameworkExtension, сообщает Symfony, что делать каждый раз, когда обнаруживается класс, отмеченный атрибутом #[AsEventListener]: пометить его тегом kernel.event_listener (если только тег не использовался в методе, и в этом случае он выдает исключение).

Позже, в RegisterListenersPass, сервисы, которые ранее были помечены как kernel.event_listener (с помощью этого атрибута или каким-либо другим способом), регистрируются как прослушиватели событий.