kernel.request

Клас події: GetResponseEvent

Ця подія диспетчеризується Symfony дуже рано, до визначення контролера. Корисна для додавання інформації до Запиту або повернення Відповіді раніше, щоб зупинити обробку запиту.

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події та їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.request

kernel.controller

Клас події: FilterControllerEvent

Ця подія оголошується після того, як було дозволено контролер, що виконується, але до того, як його було виконано. Корисно для ініціалізації речей, необхідних пізніше контролеру, на кшталт перетворювача param, і навіть для зміни контролера повністю:

1
2
3
4
5
6
7
8
9

use Symfony\Component\HttpKernel\Event\FilterControllerEvent;

public function onKernelController(FilterControllerEvent $event)
{
    // ...

    // контролер можна змінити на будь-яке PHP-викличне
    $event->setController($myCustomController);
}

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події та їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.controller

kernel.controller_arguments

Клас події: ControllerArgumentsEvent

Ця подія оголошується прямо перед викликом контролера. Вона корисна для конфігурації аргументів, які будуть передані контролеру. Зазвичай, вона використовується для відображення параметрів маршрутизації URL у відповідних іменованих аргументах; або для передачі запиту, коли знаходиться підказка Request:

1
2
3
4
5
6
7
8
9
10
11
12
13

use Symfony\Component\HttpKernel\Event\ControllerArgumentsEvent;

public function onKernelControllerArguments(ControllerArgumentsEvent $event)
{
    // ...

    // отримати аргументи контролера та запиту
    $namedArguments = $event->getRequest()->attributes->all();
    $controllerArguments = $event->getArguments();

    // встановити аргументи контролера та змінити початкові аргументи або додати нові
    $event->setArguments($newArguments);
}

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події, та їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.controller_arguments

kernel.view

Клас події: GetResponseForControllerResultEvent

Ця подія оголошується після того як контролер було виконано, але лише якшо контролер не повертає об'єкт Response. Корисно для перетворення поверненого значення (наприклад, рядку з деяким HTML змістом) в об'єкт Response, необхідний Symfony:

1
2
3
4
5
6
7
8
9
10
11
12

use Symfony\Component\HttpKernel\Event\GetResponseForControllerResultEvent;
use Symfony\Component\HttpFoundation\Response;

public function onKernelView(GetResponseForControllerResultEvent $event)
{
    $val = $event->getControllerResult();
    $response = new Response();

    // ... якось налаштувати Відповідь зі зворотного значення

    $event->setResponse($response);
}

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події і їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.view

kernel.response

Клас події: FilterResponseEvent

Ця подія оголошується після того як контролер або будь-який слухач kernel.view повертає об'єкт Response. Корисно для зміни або заміни відповіді до її відправлення назад (наприклад, додавати/змінювати HTTP заголовки, додавати куки і т.д.):

1
2
3
4
5
6
7
8

use Symfony\Component\HttpKernel\Event\ResponseEvent;

public function onKernelResponse(ResponseEvent $event)
{
    $response = $event->getResponse();

    // ... змінити об'єкт відповіді
}

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події і їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.response

kernel.finish_request

Клас події: FinishRequestEvent

Ця подія оголошується після події kernel.response. Вона корисня для скидання глобального стану додатку (наприклад, слухач перекладача скидає локаль перекладача за одним з батківських запитів):

1
2
3
4
5
6
7
8
9
10
11

use Symfony\Component\HttpKernel\Event\FinishRequestEvent;

public function onKernelFinishRequest(FinishRequestEvent $event)
{
    if (null === $parentRequest = $this->requestStack->getParentRequest()) {
        return;
    }

    // скинути локаль підзапиту в локаль батківського запиту
    $this->setLocale($parentRequest);
}

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події і їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.finish_request

kernel.terminate

Клас події: PostResponseEvent

Ця подія оголошується після того, як було відправлено відповідь (пісня виконання методу handle() method). Вона корисна для виконання повільних або складних завдань, які не мають бути виконані до відправлення відповіді (наприклад, відправлення листів).

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події і їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.terminate

Purpose: To access and use the current locale

Setting and retrieving the locale can be done via configuration or using container parameters, listeners, route parameters or the current request.

Thanks to the Translation contract, the locale can be set via services.

To register your own locale aware service, first create a service that implements the LocaleAwareInterface interface:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

// src/Locale/MyCustomLocaleHandler.php
namespace App\Locale;

use Symfony\Contracts\Translation\LocaleAwareInterface;

class MyCustomLocaleHandler implements LocaleAwareInterface
{
    public function setLocale($locale)
    {
        $this->locale = $locale;
    }

    public function getLocale()
    {
        return $this->locale;
    }
}

If you're using the default services.yaml configuration , your service will be automatically tagged with kernel.locale_aware. But, you can also register it manually:

1
2
3

services:
    App\Locale\MyCustomLocaleHandler:
        tags: [kernel.locale_aware]

1
2
3
4
5
6
7
8
9
10
11
12

<?xml version="1.0" encoding="UTF-8" ?>
<container xmlns="http://symfony.com/schema/dic/services"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://symfony.com/schema/dic/services
        https://symfony.com/schema/dic/services/services-1.0.xsd">

    <services>
        <service id="App\Locale\MyCustomLocaleHandler">
            <tag name="kernel.locale_aware"/>
        </service>
    </services>
</container>

1
2
3
4
5
6

use App\Locale\MyCustomLocaleHandler;

$container
    ->register(LocaleHandler::class)
    ->addTag('kernel.locale_aware')
;:

kernel.exception

Клас події: GetResponseForExceptionEvent

Ця подія виконується як тільки виникає помилка під час обробки HTTP-запиту. Вона корисня для відновлення після помилок ибо зміни деталей виключень, відправлених в якості відповіді:

1
2
3
4
5
6
7
8
9
10
11
12
13
14

use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Event\ExceptionEvent;

public function onKernelException(ExceptionEvent $event)
{
    $exception = $event->getThrowable();
    $response = new Response();
    // налаштуйте об'єкт Відповідь, засновуючись на виявленому виключенні
    $event->setResponse($response);

    // ви можете, як варіант, встановити нове Виключення
    // $exception = new \Exception('Some special exception');
    // $event->setThrowable($exception);
}

Symfony використовує наступну логіку для визначення HTTP статус-коду відповіді:

• Якщо isClientError(), isServerError() або isRedirect() - true, то у вашому об'єкті Response використовується статус-код;
• Якщо початкове виключення реалізує HttpExceptionInterface, то у виключенні викликається та використовується getStatusCode() (також додаються заголовки з getHeaders());
• Якщо не співпадає нічого з перераховоного вище, то використовується статус-код 500.

1
2
3

$event->allowSuccessfulResponse();
$response = new Response('No Content', 204);
$event->setResponse($response);

Виконайте цю команду, щоб дізнатися, які слухачі зареєстровані для цієї події і їх пріоритетність:

1

$ php bin/console debug:event-dispatcher kernel.exception