blackfire

Profile a PHP script

$ blackfire run php [script.php]

$ blackfire run php [script.php] --arg1 [value]

$ blackfire curl [https://example.com/page]

$ blackfire --env=[ENV_UUID] run php [script.php]

$ blackfire --json run php [script.php]

$ blackfire -q run php [script.php]

$ blackfire run php bin/console [command:name]

blackfire [options] subcommand [arguments]

blackfire is the CLI tool for the Blackfire profiler, a performance management solution for PHP applications. It profiles PHP scripts, HTTP requests, and web applications to identify performance bottlenecks.
The tool integrates with Blackfire.io cloud services to provide detailed flame graphs, call graphs, and performance recommendations. Profiles can be compared to track performance changes over time.

--env uuid

Target environment UUID for the profile

Output profile results in JSON format

Suppress output (do not display profile URL)

Number of samples to collect

Set a title for the profile

Set an external identifier for the profile

Ignore non-zero exit status from profiled command

/etc/blackfire/agent

Blackfire agent configuration including server credentials and socket settings.

Client-side configuration with client ID and token for authentication.

run

Profile a PHP CLI script or command

Profile an HTTP request (uses system curl)

Upload a profile to Blackfire.io

Configure client credentials

Configure agent settings

Requires a Blackfire account and properly configured credentials (BLACKFIRECLIENTID and BLACKFIRECLIENTTOKEN). The Blackfire PHP extension must be installed for profiling to work. The curl subcommand requires curl to be installed on the system.

Blackfire was created by SensioLabs (the company behind Symfony) and launched in 2014 as a commercial profiling solution. It evolved from the open-source xhprof profiler and provides continuous performance monitoring for PHP applications.

php(1), xdebug(1), curl(1)