blackfire/player

A powerful web crawler and web scraper with Blackfire support

2026.6.0 2026-06-01 08:02 UTC

Requires

• php: >=8.5
• ext-ctype: *
• ext-filter: *
• ext-intl: *
• ext-mbstring: *
• blackfire/php-sdk: ^2.5
• fakerphp/faker: ^1.10
• mtdowling/jmespath.php: ^2.2
• nyholm/psr7: ^1.6
• psr/log: ^3.0
• sentry/sentry: ^4.0
• symfony/console: 8.0.*
• symfony/css-selector: 8.0.*
• symfony/dom-crawler: 8.0.*
• symfony/event-dispatcher: 8.0.*
• symfony/expression-language: 8.0.*
• symfony/filesystem: 8.0.*
• symfony/finder: 8.0.*
• symfony/http-client: 8.0.*
• symfony/mime: 8.0.*
• symfony/property-access: 8.0.*
• symfony/serializer: 8.0.*
• symfony/yaml: 8.0.*

Requires (Dev)

• phpunit/phpunit: ^13.0
• rector/rector: ^2.0
• symfony/process: 8.0.*
• symfony/var-dumper: 8.0.*

Replaces

• symfony/polyfill-ctype: *
• symfony/polyfill-intl-grapheme: *
• symfony/polyfill-intl-idn: *
• symfony/polyfill-intl-normalizer: *
• symfony/polyfill-mbstring: *
• symfony/polyfill-php72: *
• symfony/polyfill-php81: *
• symfony/polyfill-php82: *
• symfony/polyfill-php83: *
• symfony/polyfill-php84: *
• symfony/polyfill-php85: *
• symfony/polyfill-uuid: *

MIT

• Fabien Potencier

• scraper
• crawler
• blackfire

README

Blackfire Player is a powerful performance testing application. It provides a nice DSL to crawl HTTP services, assert responses, and extract data from HTML/XML/JSON responses.

Read more about how to download and use Blackfire Player.

Usage

blackfire-player is distributed through a Docker image.

To run a scenario located in the my-scenario.bkf file, run the following command:

docker run --rm -it -e BLACKFIRE_CLIENT_ID -e BLACKFIRE_CLIENT_TOKEN -v "`pwd`:/app" blackfire/player run my-scenario.bkf

The pwd part is the local working directory (we are using the current directory here) and it is mapped to the /app path in the Docker container.

BLACKFIRE_CLIENT_ID and BLACKFIRE_CLIENT_TOKEN environment variables need to be properly exposed from the host in order to be able to use the :doc:`Blackfire Profiler integration </integrations/blackfire-player>`.

Note

To make it simpler to run this command, you might create a shell alias (that you can store in a .bashrc or .zshrc file depending on your shell):

alias blackfire-player="docker run --rm -it -e BLACKFIRE_CLIENT_ID -e BLACKFIRE_CLIENT_TOKEN -v \"`pwd`:/app\" blackfire/player"

Don't forget to restart your terminal for it to take effect. You can then use blackfire-player as if it was the binary itself:

blackfire-player --version
blackfire-player list
blackfire-player run my-scenario.bkf