Установка

У додатках, що використовують Symfony Flex , виконайте цю команду, щоб встановити пакет Symfony profiler перед його використанням:

1

$ composer require --dev symfony/profiler-pack

Тепер, відкрийте будь-яку сторінку вашого додатку у середовищі розробки, щоб дозволити профілювальнику зібрати інформацію. Потім, натисніть на будь-який елемент панелі інструментів налагодження, впровадженої знизу ваших сторінок, щоб відкрити веб-інтерфейс Профілювальника Symfony, який виглядатиме так:

Програмний доступ до даних профілювання

У більшості випадків, доступ та аналіз інформації профілювальника відбувається з використанням його веб-інтерфейсу. Однак, ви також можете вилучити інформацію профілювання пограмно, завдяки методам, наданим сервісом profiler.

Коли доступний обʼєкт відповіді, використайте метод loadProfileFromResponse(), щоб отримати доступ до його асоційованого профілю:

1
2

// ... $profiler - це сервіс 'profiler'
$profile = $profiler->loadProfileFromResponse($response);

Коли профілювальник зберігає дані про запит, він також асоціює з ним токен; цей токен доступний в HTTP-заголовку відповіді X-Debug-Token. Використовуючи цей токен, ви можете отримати доступ до профілю будь-якого попереднього запиту, завдяки методу loadProfile():

1
2

$token = $response->headers->get('X-Debug-Token');
$profile = $profiler->loadProfile($token);

Сервіс profiler також надає метод find(), щоб шукати токени, засновуючись на якихось критеріях:

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

// отримує останні 10 токенів
$tokens = $profiler->find('', '', 10, '', '', '');

// отримує останні 10 токенів для всіх URL, що містять /admin/
$tokens = $profiler->find('', '/admin/', 10, '', '', '');

// отримує останні 10 токенів для всіх URL, що не містять /api/
$tokens = $profiler->find('', '!/api/', 10, '', '', '');

// отримує останні 10 токенів для локальних запитів POST
$tokens = $profiler->find('127.0.0.1', '', 10, 'POST', '', '');

// отримує останні 10 токенів для запитів, які відбулися від 2 до 4 днів тому
$tokens = $profiler->find('', '', 10, '', '4 days ago', '2 days ago');

Колектори даних

Профілювальник отримує інформацію, використовуючи деякі сервіси під назвою "колектори даних". Symfony постачається з декількома колекторами, які отирмують інфомацію про запит, логер, машрутизацію, кеш та ін.

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

1

$ php bin/console debug:container --tag=data_collector

Ви також можете створити власний колектор даних, щоб зберігати будь-які дані, згенеровані вашим додатком, та відображати їх у панелі інструментів налагодження та веб-інтерфейсі профілювальника.

Засікання часу виконання додатку

Якщо ви хочете виміряти час, який займають якісь задачі у вашому додатку, немає необхідності створювати користувацький колектор даних. Натомість, використайте вбудовані утиліти, щоб профілювати додатки Symfony .

Включення профілювальника програмно

Профілювальник Symfony не може бути включено/відключено за умовами, використовуючи зіставники, так як ця функція була видалена в Symfony 4.0. Однак, ви можете використати методи enable() та disable() класу Profiler у ваших контролерах, щоб управляти профілювальником програмно:

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

use Symfony\Component\HttpKernel\Profiler\Profiler;
// ...

class DefaultController
{
    // ...

    public function someMethod(?Profiler $profiler): Response
    {
        // $profiler не буде встановлено, якщо ваше середовище не має профілювальника (як prod, за замовчуванням)
        if (null !== $profiler) {
            // якщо він існує, відключіть профілювальник для цієї конкретної дії контролера
            $profiler->disable();
        }

        // ...
    }
}

Для того, щоб профілювальник був впроваджений у ваш контролер, вам потрібно створити псевдонім, що вказує на існуючий сервіс profiler:

1
2
3

# config/services_dev.yaml
services:
    Symfony\Component\HttpKernel\Profiler\Profiler: '@profiler'

1
2
3
4
5
6
7
8
9
10
11

<!-- config/services_dev.xml -->
<?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="Symfony\Component\HttpKernel\Profiler\Profiler" alias="profiler"/>
    </services>
</container>

1
2
3
4

// config/services_dev.php
use Symfony\Component\HttpKernel\Profiler\Profiler;

$container->setAlias(Profiler::class, 'profiler');

1
2
3
4
5

# config/packages/dev/web_profiler.yaml
    framework:
        profiler:
            collect: false
            collect_parameter: 'profile'

Оновлення панелі веб-інструментів налагодження після запитів AJAX

Односторінкові додатки (SPA) - це веб-додатки, які взаємодіють з користувачем, динамічно перреписуючи поточну сторінку, а не завантажуючи цілі нові сторінки з сервера.

За замовчуванням, панель інструментів налагодження відображує інформацію завантаження початкової сторінки і не оновлюється після кожного запиту AJAX. Однак, ви можете встановити заголовок Symfony-Debug-Toolbar-Replace у значення 1 у відповідь на запит AJAX, щоб форсувати оновлення панелі інструментів:

1

$response->headers->set('Symfony-Debug-Toolbar-Replace', 1);

В ідеалі цей заголовок має бути встановлений лише під час розробки і не у виробництві. Щоб зробити це, створіть підписник подій та слухайте подію kernel.response :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\HttpKernel\Event\ResponseEvent;
use Symfony\Component\HttpKernel\KernelInterface;

// ...

class MySubscriber implements EventSubscriberInterface
{
    public function __construct(
        private KernelInterface $kernel,
    ) {
    }

    // ...

    public function onKernelResponse(ResponseEvent $event): void
    {
        if (!$this->kernel->isDebug()) {
            return;
        }

        $request = $event->getRequest();
        if (!$request->isXmlHttpRequest()) {
            return;
        }

        $response = $event->getResponse();
        $response->headers->set('Symfony-Debug-Toolbar-Replace', '1');
    }
}

Створення колектора даних

Symfony Profiler отримує інформацію для профілювання та налагодження за допомогою деяких спеціальних класів, які називаються колекторами даних. Symfony постачається з декількома з них, але ви також можете створити свій власний.

Колектор даних - це PHP-клас, який реалізує DataCollectorInterface. Для зручності, ваші колектори даних також можуть розширюватися з класу AbstractDataCollector, який реалізує інтерфейс і надає деякі утиліти та властивість $this->data для зберігання зібраної інформації.

У наступному прикладі показано користувацький колектор, який зберігає інформацію про запит:

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

// src/DataCollector/RequestCollector.php
namespace App\DataCollector;

use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

class RequestCollector extends AbstractDataCollector
{
    public function collect(Request $request, Response $response, \Throwable $exception = null): void
    {
        $this->data = [
            'method' => $request->getMethod(),
            'acceptable_content_types' => $request->getAcceptableContentTypes(),
        ];
    }
}

Ось методи, які ви можете визначити у клас колектора даних:

Метод collect():

Зберігає зібрані дані у локальних властивостях ($this->data, якщо ви розширюєте з AbstractDataCollector). Якщо вам потрібні якісь сервіси для збору даних, додайте ці сервіси до конструктора колектора даних.

Caution

Метод collect() викликається лише один раз. Він не використовується для "збору" даних, але існує для "підбирання" даних, які були збережені вашим сервісом.

Caution

Оскільки профілювальник серіалізує екземпляри колекторів даних, вам не слід зберігати об'єкти, які не можна серіалізувати (наприклад, об'єкти PDO), або вам потрібно надати власний метод серіалізувати().

Метод reset():

Викликається між запитами для скидання стану профілювальника. За замовчуванням очищується лише зміст $this->data, але ви можете перевизначити цей метод для додаткового очищення.

Метод getName():

Повертає ідентифікатор колектора, який має бути унікальним у додатку. За замовчуванням повертає FQCN класу колектора даних, але ви можете перевизначити цей метод, щоб повернути користувацьке ім'я (наприклад, app.request_collector). Це значення використовується пізніше для доступу до інформації про колектор (див. Як використовувати профілювальник у функціональному тесті), тому ви можете використовувати короткі рядки замість рядків FQCN.

Метод collect() викликається під час події kernel.response . Якщо вам потрібно зібрати дані, які будуть доступні лише пізніше, реалізуйте LateDataCollectorInterfacefe9fbbc144664ef1a065a894267545b46f2f92fdlateCollect()`, який викликається безпосередньо перед серіалізацією даних профілювальника (під час події kernel.terminate ).

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

// src/DataCollector/RequestCollector.php
namespace App\DataCollector;

use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;
use Symfony\Component\VarDumper\Cloner\Data;

class RequestCollector extends AbstractDataCollector
{
    // ...

    public static function getTemplate(): ?string
    {
        return 'data_collector/template.html.twig';
    }

    public function getMethod(): string
    {
        return $this->data['method'];
    }

    public function getAcceptableContentTypes(): array
    {
        return $this->data['acceptable_content_types'];
    }

    public function getSomeObject(): Data
    {
        // використати метод cloneVar(), щоб скинути зібрані дані у профілювальник
        return $this->cloneVar($this->data['method']);
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

{# templates/data_collector/template.html.twig #}
{% extends '@WebProfiler/Profiler/layout.html.twig' %}

{% block toolbar %}
    {% set icon %}
        {# це зміст, який відображається як панель у панелі інструментів #}
        <svg xmlns="http://www.w3.org/2000/svg"> ... </svg>
        <span class="sf-toolbar-value">Request</span>
    {% endset %}

    {% set text %}
        {# це зміст, який відображається при наведенні курсору
           the toolbar panel #}
        <div class="sf-toolbar-info-piece">
            <b>Method</b>
            <span>{{ collector.method }}</span>
        </div>

        <div class="sf-toolbar-info-piece">
            <b>Accepted content type</b>
            <span>{{ collector.acceptableContentTypes|join(', ') }}</span>
        </div>
    {% endset %}

    {# значення 'link', встановлене як 'false', означає, що ця панель не відображає
       розділ у веб-профілювальнику #}
    {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { link: false }) }}
{% endblock %}

1
2
3
4

{% set icon %}
    {{ include('data_collector/icon.svg') }}
    {# ... #}
{% endset %}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

{# templates/data_collector/template.html.twig #}
{% extends '@WebProfiler/Profiler/layout.html.twig' %}

{% block toolbar %}
    {% set icon %}
        {# ... #}
    {% endset %}

    {% set text %}
        <div class="sf-toolbar-info-piece">
            {# ... #}
        </div>
    {% endset %}

    {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { 'link': true }) }}
{% endblock %}

{% block head %}
    {# Опціональьно. Тут ви можете послатися на або визначити ваш власний зміст CSS та JS. #}
    {# Використайте {{ parent() }}, щоб розширити стилі за замовчуванням замість того, щоб перевизначати їх. #}
{% endblock %}

{% block menu %}
    {# Це лівостороннє меню зʼявляється прир використанні повноекранного профілювальника. #}
    <span class="label">
        <span class="icon"><img src="..." alt=""/></span>
        <strong>Request</strong>
    </span>
{% endblock %}

{% block panel %}
    {# Опціонально, для відображення найбільшої кількості деталей. #}
    <h2>Acceptable Content Types</h2>
    <table>
        <tr>
            <th>Content Type</th>
        </tr>

        {% for type in collector.acceptableContentTypes %}
        <tr>
            <td>{{ type }}</td>
        </tr>
        {% endfor %}
    </table>
{% endblock %}

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

# config/services.yaml
services:
    App\DataCollector\RequestCollector:
        tags:
            -
                name: data_collector
                # має співпадати зі значенням, поверненим методом getName()
                id: 'App\DataCollector\RequestCollector'
                # опціональний шаблон (має вищий пріоритет, ніж значення, повернене  getTemplate())
                template: 'data_collector/template.html.twig'
                # опціональний пріоритет (додатне або від'ємне ціле число; за замовчуванням = 0)
                # priority: 300

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

<!-- config/services.xml -->
<?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\DataCollector\RequestCollector">
            <!-- атрибут 'template' має вищий пріоритет, ніж значення, повернене getTemplate() -->
            <tag name="data_collector"
                id="App\DataCollector\RequestCollector"
                template="data_collector/template.html.twig"
            />
            <!-- опціональний атрибут 'priority' (додатне або від'ємне ціле число; за замовчуванням = 0) -->
            <!-- priority="300" -->
        </service>
    </services>
</container>

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

// config/services.php
namespace Symfony\Component\DependencyInjection\Loader\Configurator;

use App\DataCollector\RequestCollector;

return function(ContainerConfigurator $container): void {
    $services = $containerConfigurator->services();

    $services->set(RequestCollector::class)
        ->tag('data_collector', [
            'id' => RequestCollector::class,
            // опціональний шаблон (має вищий пріоритет, ніж значення, повернене getTemplate())
            'template' => 'data_collector/template.html.twig',
            // опціональний пріоритет (додатне або від'ємне ціле число; за замовчуванням = 0)
            // 'priority' => 300,
        ]);
};