How to Create a custom Data Collector ¶

Creating a custom Data Collector ¶

A data collector is a PHP class that implements the DataCollectorInterface. For convenience, your data collectors can also extend from the AbstractDataCollector class, which implements the interface and provides some utilities and the $this->data property to store the collected information.

The following example shows a custom collector that stores information about the request:

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)
    {
        $this->data = [
            'method' => $request->getMethod(),
            'acceptable_content_types' => $request->getAcceptableContentTypes(),
        ];
    }
}

These are the method that you can define in the data collector class:

collect() method:

Stores the collected data in local properties ($this->data if you extend from AbstractDataCollector). If you need some services to collect the data, inject those services in the data collector constructor.

収集したデータをローカル プロパティに格納します (AbstractDataCollector から拡張する場合は $this->data)。データを収集するためにいくつかのサービスが必要な場合は、それらのサービスをデータ コレクター コンストラクターに挿入します。

Caution

注意

The collect() method is only called once. It is not used to "gather" data but is there to "pick up" the data that has been stored by your service.

collect() メソッドは 1 回だけ呼び出されます。データを「収集」するために使用されるのではなく、サービスによって保存されたデータを「ピックアップ」するために使用されます。

Caution

注意

As the profiler serializes data collector instances, you should not store objects that cannot be serialized (like PDO objects) or you need to provide your own serialize() method.

プロファイラーはデータ コレクター インスタンスをシリアル化するため、シリアル化できないオブジェクト (PDO オブジェクトなど) を保存しないか、独自の serialize() メソッドを提供する必要があります。

reset() method:

It's called between requests to reset the state of the profiler. By default it only empties the $this->data contents, but you can override this method to do additional cleaning.

プロファイラーの状態をリセットするために、リクエスト間で呼び出されます。デフォルトでは、$this->data の内容のみを空にしますが、このメソッドをオーバーライドして追加のクリーニングを行うことができます。

getName() method:

Returns the collector identifier, which must be unique in the application. By default it returns the FQCN of the data collector class, but you can override this method to return a custom name (e.g. app.request_collector). This value is used later to access the collector information (see How to Use the Profiler in a Functional Test) so you may prefer using short strings instead of FQCN strings.

アプリケーション内で一意である必要があるコレクター識別子を返します。デフォルトでは、データ コレクター クラスの FQCN を返しますが、このメソッドをオーバーライドしてカスタム名 (app.request_collector など) を返すことができます。この値は、後でアクセスするために使用されます。コレクター情報 (「機能テストでプロファイラーを使用する方法」を参照) を使用するため、FQCN 文字列の代わりに短い文字列を使用することをお勧めします。

The collect() method is called during the kernel.response event. If you need to collect data that is only available later, implement LateDataCollectorInterface and define the lateCollect() method, which is invoked right before the profiler data serialization (during kernel.terminate event).

Adding Web Profiler Templates ¶

The information collected by your data collector can be displayed both in the web debug toolbar and in the web profiler. To do so, you need to create a Twig template that includes some specific blocks.

First, add the getTemplate() method in your data collector class to return the path of the Twig template to use. Then, add some getters to give the template access to the collected information:

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

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

use Symfony\Bundle\FrameworkBundle\DataCollector\AbstractDataCollector;

class RequestCollector extends AbstractDataCollector
{
    // ...

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

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

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

In the simplest case, you want to display the information in the toolbar without providing a profiler panel. This requires to define the toolbar block and set the value of two variables called icon and text:

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 %}
        {# this is the content displayed as a panel in the toolbar #}
        <svg xmlns="http://www.w3.org/2000/svg"> ... </svg>
        <span class="sf-toolbar-value">Request</span>
    {% endset %}

    {% set text %}
        {# this is the content displayed when hovering the mouse over
           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 %}

    {# the 'link' value set to 'false' means that this panel doesn't
       show a section in the web profiler #}
    {{ include('@WebProfiler/Profiler/toolbar_item.html.twig', { link: false }) }}
{% endblock %}

1
2
3
4

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

If the toolbar panel includes extended web profiler information, the Twig template must also define additional blocks:

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 %}
    {# Optional. Here you can link to or define your own CSS and JS contents. #}
    {# Use {{ parent() }} to extend the default styles instead of overriding them. #}
{% endblock %}

{% block menu %}
    {# This left-hand menu appears when using the full-screen profiler. #}
    <span class="label">
        <span class="icon"><img src="..." alt=""/></span>
        <strong>Request</strong>
    </span>
{% endblock %}

{% block panel %}
    {# Optional, for showing the most details. #}
    <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 %}

The menu and panel blocks are the only required blocks to define the contents displayed in the web profiler panel associated with this data collector. All blocks have access to the collector object.

Enabling Custom Data Collectors ¶

If you don't use Symfony's default configuration with autowire and autoconfigure you'll need to configure the data collector explicitly:

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

# config/services.yaml
services:
    App\DataCollector\RequestCollector:
        tags:
            -
                name: data_collector
                # must match the value returned by the getName() method
                id: 'App\DataCollector\RequestCollector'
                # optional template (it has more priority than the value returned by getTemplate())
                template: 'data_collector/template.html.twig'
                # optional priority (positive or negative integer; default = 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">
            <!-- the 'template' attribute has more priority than the value returned by getTemplate() -->
            <tag name="data_collector"
                id="App\DataCollector\RequestCollector"
                template="data_collector/template.html.twig"
            />
            <!-- optional 'priority' attribute (positive or negative integer; default = 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 $configurator) {
    $services = $configurator->services();

    $services->set(RequestCollector::class)
        ->tag('data_collector', [
            'id' => RequestCollector::class,
            // optional template (it has more priority than the value returned by getTemplate())
            'template' => 'data_collector/template.html.twig',
            // optional priority (positive or negative integer; default = 0)
            // 'priority' => 300,
        ]);
};