1. Home
  2. Documentation
  3. Profiler
  4. How to Access Profiling Data Programmatically
WARNING: You are browsing the documentation for Symfony 2.7 which is not maintained anymore. Consider upgrading your projects to Symfony 5.0.

How to Access Profiling Data Programmatically

2.7 version
Maintained
3.4
Unmaintained
2.8 3.0 3.1 3.2 3.3 4.0 4.1

How to Access Profiling Data ProgrammaticallyΒΆ

Most of the times, the profiler information is accessed and analyzed using its web-based visualizer. However, you can also retrieve profiling information programmatically thanks to the methods provided by the profiler service.

When the response object is available, use the loadProfileFromResponse() method to access to its associated profile:

// ... $profiler is the 'profiler' service
$profile = $profiler->loadProfileFromResponse($response);

When the profiler stores data about a request, it also associates a token with it; this token is available in the X-Debug-Token HTTP header of the response. Using this token, you can access the profile of any past response thanks to the loadProfile() method:

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

Tip

When the profiler is enabled but not the web debug toolbar, inspect the page with your browser's developer tools to get the value of the X-Debug-Token HTTP header.

The profiler service also provides the find() method to look for tokens based on some criteria:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
// gets the latest 10 tokens
$tokens = $container->get('profiler')->find('', '', 10, '', '', '');

// gets the latest 10 tokens for all URL containing /admin/
$tokens = $container->get('profiler')->find('', '/admin/', 10, '', '', '');

// gets the latest 10 tokens for local POST requests
$tokens = $container->get('profiler')->find('127.0.0.1', '', 10, 'POST', '', '');

// gets the latest 10 tokens for requests that happened between 2 and 4 days ago
$tokens = $container->get('profiler')
    ->find('', '', 10, '', '4 days ago', '2 days ago');

Lastly, if you want to manipulate profiling data on a different machine than the one where the information was generated, use the profiler:export and profiler:import commands:

1
2
3
4
5
6
7
8
# on the production machine
$ php app/console profiler:export > profile.data

# on the development machine
$ php app/console profiler:import /path/to/profile.data

# you can also pipe from the STDIN
$ cat /path/to/profile.data | php app/console profiler:import

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.