Mate Extensions

Container Introspection

symfony-services

Search the services of the compiled container.

Parameter	Description
query	Service ID or class name. Case-insensitive partial match.
tag	DI tag name, for example kernel.event_listener.
context	Kernel context. Only relevant with several cache directories.
limit	Maximum number of services per context. Default 100.

The result holds the matches under services, plus count and truncated. When the result is truncated, narrow the filter. Raising the limit only costs context. With several cache directories the services are grouped by context.

symfony-service-detail

Show one service by its exact id: class, tags, method calls, constructor or factory information and the definition flags debug:container reports (public, synthetic, lazy, shared, abstract, autowired, autoconfigured). Accepts context as well, and reports the context the service was found in.

Both tools fail with a clear error when no container was dumped yet. They never answer as if nothing matched.

1
2

$ vendor/bin/mate tools:call symfony-services --tag=kernel.event_listener
$ vendor/bin/mate tools:call symfony-service-detail --id=App\\Mailer\\Notifier

Configuration:

1
2

$container->parameters()
    ->set('ai_mate_symfony.cache_dir', '%mate.root_dir%/var/cache');

The extension looks for a *DebugContainer.xml file in the cache directory itself, then in its dev, test and prod subdirectories. Kernels with a custom class name are found too.

Environment Variables

The symfony-dotenv-check tool is registered when symfony/dotenv is installed. Use it to find out which .env file declares a variable and whether the variable has a value. The tool never returns the value itself.

symfony-dotenv-check

Read the files .env (or .env.dist when there is no .env), .env.local, .env.<APP_ENV> and .env.<APP_ENV>.local, in the same order as Symfony. When APP_ENV is test, .env.local is skipped. APP_ENV comes from the environment of the Mate process, then from the .env file. The default is dev.

Parameter	Description
key	Check only this variable, even when no .env file declares it.
limit	Maximum number of variables when listing. Default 200, 0 for all.

The result holds app_env, the candidate files under files and the variables under variables, plus count and truncated. Each file shows whether it exists, whether it was considered and whether it is parseable. Each variable lists the files that declare it under declared_in, tells with resolved whether the Mate process has a value for it, and has a state:

State	Meaning
file	The value comes from the last file that declares the variable.
ambient_override	A file declares the variable, but the shell or CI environment sets another value.
ambient_only	No file declares the variable. Only the shell or CI environment sets it.
declared_empty_in_file	The last file that declares the variable sets it to an empty value.
declared_not_resolved_in_this_process	A file declares a value, but the Mate process doesn't have it.
not_set	No file declares the variable and the environment doesn't set it.

By default, Mate doesn't load the .env files of your project into its own process. A variable that is only set in a file therefore shows declared_not_resolved_in_this_process, even when your application resolves it. This is the normal case and not an error.

When the Mate process has a value, the variable shows its length, a masked preview with the first and last character (e.g. s***t) and looks_like_placeholder instead of the value. The last one is true for values like changeme or your_api_key. These fields describe the value in the Mate process, not the value in the file.

1

$ vendor/bin/mate tools:call symfony-dotenv-check --key=DATABASE_URL

Profiler

The profiler tools are registered when symfony/http-kernel is installed. They need symfony/web-profiler-bundle to have profiles to read.

symfony-profiler-list

List profiles with summary data, most recent first.

Parameter	Description
limit	Maximum number of profiles. Default 20. Use 1 for the latest.
method	HTTP method.
url	URL path. Partial match.
ip	Client IP address.
statusCode	HTTP response status code.
from	Start of the time range.
to	End of the time range.
context	Kernel context. Only relevant with several profiler directories.

symfony-profiler-get

Get one profile by its token, with its metadata and the collectors it has.

Every profile carries a resource_uri that points at the full profile resource. With several profiler directories it also carries a context field.

Two resource templates hold the details:

symfony-profiler://profile/{token}

The profile metadata and the list of collectors, each with its own URI.

symfony-profiler://profile/{token}/{collector}

The data of one collector.

This split keeps large payloads out of the context window. The agent lists first, then reads only the collector that matters:

1
2
3
4
5
6
7
8

# Find the failed requests
$ vendor/bin/mate tools:call symfony-profiler-list --statusCode=500 --limit=5

# See which collectors that profile has
$ vendor/bin/mate resources:read symfony-profiler://profile/abc123

# Read one of them
$ vendor/bin/mate resources:read symfony-profiler://profile/abc123/exception

Collector formatters

A formatter reduces the raw collector data to what an agent needs for a diagnosis. The extension ships formatters for these collectors:

A collector without a formatter is exposed with its raw data.

To add a formatter for your own collector, implement Symfony\AI\Mate\Bridge\Symfony\Profiler\Service\CollectorFormatterInterface and tag the service with ai_mate.profiler_collector_formatter:

1
2
3
4

// mate/config.php
$container->services()
    ->set(MyCollectorFormatter::class)
        ->tag('ai_mate.profiler_collector_formatter');

getName() returns the collector name, getSummary() the short form shown in the profile, and format() the full data.

Redaction

The request formatter redacts cookies, session data, the raw request body, the reconstructed curl command, authentication headers and sensitive environment variables. A header, parameter or variable counts as sensitive when its name contains a word like password, token, secret, key, auth, credential, csrf or session. The raw data of a collector without a formatter goes through the same kind of key-based redaction.

Configuration:

1
2

$container->parameters()
    ->set('ai_mate_symfony.profiler_dir', '%mate.root_dir%/var/cache/dev/profiler');