Player

For tools and AI agents: Markdown version

2026.10.1

Maintenance release ·

2026.10.0

Maintenance release ·

2026.9.1

  • Update dependencies to fix vulnerabilities
  • Update support links address
  • Update dependencies

2026.9.0

Maintenance release ·

2026.8.0

Maintenance release ·

2026.7.0

  • `--blackfire-env` is now optional
  • Update dependencies; Internal releasing changes

2026.6.0

  • Remove Code related to Builds
  • Update dependencies

2026.5.0

Maintenance release ·

2026.4.1

  • Upgrade player to php 8.5
  • Add safe strict type declarations
  • Update dependencies; Internal releasing changes

2026.4.0

  • Display profile's result in output
  • Update dependencies

2026.3.1

Maintenance release ·

2026.3.0

  • Switch versioning to calver
  • Update dependencies; Internal releasing changes

2026.2.0

Maintenance release ·

2.6.45

Maintenance release ·

2.6.44

Maintenance release ·

2.6.43

Maintenance release ·

2.6.42

Maintenance release ·

2.6.41

  • Prevent comiting debug code
  • Update dependencies; Internal releasing changes

2.6.40

Maintenance release ·

2.6.39

Maintenance release ·

2.6.38

Maintenance release ·

2.6.37

Maintenance release ·

2.6.36

Maintenance release ·

2.6.35

Maintenance release ·

2.6.34

  • apply random value to cookie __blackfire=NO_CACHE when profiling
  • Update dependencies

2.6.33

Maintenance release ·

2.6.32

  • Add post transfer to build statistics
  • Update dependencies; Internal releasing changes

2.6.31

  • Upgrade player-dev to php 8.4
  • Internal releasing changes; Update dependencies

2.6.30

Maintenance release ·

2.6.29

Maintenance release ·

2.6.28

Maintenance release ·

2.6.27

  • Improve profiling errors reporting
  • Update dependencies; Internal releasing changes

2.6.26

  • Collect step processing duration

2.6.25

Maintenance release ·

2.6.24

  • Upgrade to Symfony 7.2
  • Internal releasing changes; Update dependencies

2.6.23

  • Upgrade docker image to php 8.4
  • Update dependencies; Internal releasing changes

2.6.22

  • ensure step is marked as errored when profile could not be performed as expected
  • Update dependencies

2.6.21

Maintenance release ·

2.6.20

Maintenance release ·

2.6.19

Maintenance release ·

2.6.18

Maintenance release ·

2.6.17

Maintenance release ·

2.6.16

  • Remove debug trace in player
  • Update dependencies

2.6.15

Maintenance release ·

2.6.14

Maintenance release ·

2.6.13

Maintenance release ·

2.6.12

Maintenance release ·

2.6.11

Maintenance release ·

2.6.10

Maintenance release ·

2.6.9

  • Upgrade to Symfony 7.1
  • Update dependencies

2.6.8

Maintenance release ·

2.6.7

  • Upgrade Player image to 8.3
  • Update dependencies; Internal releasing changes

2.6.6

Maintenance release ·

2.6.5

Maintenance release ·

2.6.4

Maintenance release ·

2.6.3

Maintenance release ·

2.6.2

  • Bump docker image version
  • Update dependencies

2.6.1

  • Upgrade docker-image version
  • Update dependencies

2.6.0

  • Deprecate the samples attribute in .blackfire.yml file
  • Update dependencies

2.5.4

Maintenance release ·

2.5.3

  • [player] fix github actions deprecations
  • Update dependencies

2.5.2

Maintenance release ·

2.5.1

  • Remove .phar deprecation
  • Add explicit PHP extensions requirements

2.5.0

  • Fix CS
  • Upgrade player to Symfony 7.0
  • Update dependencies

2.4.8

  • Fix CS
  • Update dependencies

2.4.7

  • Fix .blackfire.ini support
  • Update Dependencies

2.4.6

  • Fix deprecations
  • Update Dependencies

2.4.5

Maintenance release ·

2.4.4

Maintenance release ·

2.4.3

Maintenance release ·

2.4.2

Maintenance release ·

2.4.1

  • Fix description of `merge` function (Thanks @Kocal)
  • Ensure cookie jar is cleared before running every build scenario

2.4.0

  • Add a deprecation message when Player is run outside of its Docker image context
  • Update dependencies

2.3.3

  • Ensure headers defined in a Blackfire Scenario are preserved (Thanks @mnocon)

2.3.2

  • Move Blackfire Internals from `/app` to `/usr/bin/blackfire` in the docker image
  • Update dependencies

2.3.1

  • Ensures network errors are handled on json view update

2.3.0

  • Use Player source instead of Phar in the Docker image
  • Update dependencies

2.2.0

  • Add a dedicated exit code when Blackfire encounter an error while requesting Blackfire APIs
  • Fix boot of the app without credentials
  • Update dependencies

2.1.1

  • Remove hard dependency to ext-uuid
  • Fix deprecation triggering

2.1.0

  • Implement a `--step` option
  • Drop support for `blackfire-env` top-level property
  • Update dependencies

2.0.2

  • Improve reported expectation failure error message

2.0.1

  • Increase docker image memory limit

2.0.0

  • Player internals refactoring
  • Deprecate multi-environment builds
  • Update dependencies

1.32.0

  • Remove polyfills in favor of using PHP extensions
  • Update dependencies

1.31.0

  • Display Player version in its output

1.30.0

  • Switch to Blackfire SDK 2.0
  • Update dependencies

1.29.0

  • Update Sentry integration
  • Update support URL
  • Update README
  • Add tests
  • Update dependencies

1.28.0

  • Use PHP built-in annotations for Serializer configuration
  • Update dependencies

1.27.0

  • Add more breadcrumb to Sentry reports

1.26.0

  • Add breadcrumb to Sentry reports

1.25.0

  • Add Sentry support
  • Fix optional build name type error

1.24.0

  • Avoid serialization failure

1.23.0

  • Use new intention feature when creating builds
  • Serialize the build as Json in output
  • Add PHP 8.1 as a requirement
  • Add PHP return types
  • Modern usage of Json
  • Update dependencies

1.22.0

  • Disable Docker image error reporting
  • Update dependencies

1.21.0

  • Support multiple group files
  • Update dependencies

1.20.0

  • Migrate to Box 4.1
  • Prevent passing non-scalar values to DSL functions
  • Update dependencies

1.19.0

  • Provide an alternative image generator that does not rely on a third-party website
  • Fix BC break in Faker
  • Update to Symfony 6.1
  • Update dependencies

1.18.0

  • Provide a better error message when the faker image server is down/slow
  • Fix deprecation notice
  • Update dependencies

1.17.0

  • Mark all classes internal
  • Fix output formatting
  • Fix deprecations
  • Update dependencies

1.16.0

  • Fix deprecation with PHP 8.1
  • Update dependencies

1.15.0

Maintenance release ·

1.14.0

  • Make Docker support multi-arch
  • Fix re-use of groups with profiled step
  • Update dependencies

1.13.0

  • Add a docker image (Thanks @scyzoryck)

1.12.0

Maintenance release ·

1.11.0

  • Implement variable interpolation in multiline strings (Thanks @scyzoryck)
  • Allow 'X-Blackfire-Response' progress value to stay constant
  • Add support for the 'wait' instruction of the 'X-Blackfire-Response' header

1.10.1

  • Fix handling headers containing ":"
  • Update dependencies

1.10.0

  • Bump minimum PHP version to 7.1.3
  • Replace Faker with a fork
  • Bump min Symfony version to 4.4 and 5.1

1.9.3

Maintenance release ·

1.9.2

Maintenance release ·

1.9.1

  • Properly dump nested arrays in output
  • Update dependencies

1.9.0

  • Add support for scenarios validation using stdin
  • Add support for scenarios validation with variables defined in the environment
  • Update dependencies

1.8.2

  • Fix : Remove the Blackfire Query before following a redirection

1.8.1

  • Update documentation
  • Fix X-Blackfire-Query header not sent when "blackfire" option is used within an env name in a step
  • Update dependencies

1.8.0

  • Add support for loading the content of a file in a test (like `expect body() == file('expected.html')`)

1.7.0

  • Add support for running scenarios stored in a .blackfire.yaml file
  • Update documentation
  • Update dependencies

1.6.1

  • Fix typo

1.6.0

  • Add support for a sandbox mode
  • Fix compat with PHP 5

1.5.1

  • Avoid the BKF validator to throw exceptions
  • Fix Player when submitting a form with some file upload fields and some hidden fields
  • Update dependencies

1.5.0

  • Fixed stdin support for the player
  • Update dependencies

1.4.1

  • Revert empty group latest change, allow for declaring variables

1.4.0

  • Forbid to declare empty groups
  • Fix error when value come from Expectation and Symfony DomCrawler component
  • Update dependencies

1.3.0

  • Add `--ssl-no-verify` option to `run` command

1.2.1

  • Fix certificate verification when using DisableInternalNetworkExtension
  • Fix typo in doc
  • Update player composer dependencies

1.2.0

  • Add the Disable Internal Network Extension
  • Update to latest Composer CA bundle

1.1.2

  • Improve documentation
  • Update dependencies

1.1.1

  • Fix request info sent when using Blackfire's build

1.1.0

  • Dump variables when the --tracer option is used
  • Improve error message for invalid assertions configuration

1.0.1

  • Fix cryptic message when no-endpoint is defined

1.0.0

  • Release version 1.0

0.16.0

  • Remove deprecated --full-report option for "run" command

0.15.1

  • Bump to Blackfire SDK 1.17.6

0.15.0

  • Bump to Blackfire SDK 1.17.4

0.14.0

  • Improve error reporting
  • Fix expectations not sent to Blackfire

0.13.0

  • Add support of multi-line expressions

0.12.0

  • Deprecate --full-report in favor of --json option for "run" command
  • Use an erroneous exit code when "validate" command fails
  • Remove the deprecated --validate option for "run" command in favor of the "validate" command

0.11.0

  • Use URL as default step name
  • Remove quotes around step and build names

0.10.0

  • Standardize ``run --full-report`` output command (BC break)
  • Fix variable management

0.9.0

  • Add Blackfire PHP SDK User-Agent header suffix with Player version
  • Allow to set a build name
  • Change "warmup" default value from "false" to "true"

0.8.2

  • Fix JSON error handling when reading stdin as input

0.8.1

  • Improve error handling
  • Add more info to error output
  • Reword error messages
  • Update documentation
  • Update dependencies

0.8.0

  • Add a validate command
  • Remove deprecated --json option
  • Deprecate run --validate option
  • Forward Blackfire player expectation failures to Blackfire API

0.7.0

  • restrict loading to files with the 'bkf' extension
  • rework build references to have one reference per scenario
  • enable Blackfire by default when the '--blackfire-env' CLI option is used
  • fix usage of variables

0.6.0

  • send Guzzle timers to Blackfire
  • improve exception messages
  • fix variables resolving
  • fix CLI parameters escaping

0.5.0-alpha-5

  • add a 'warmup' step option
  • add a new CLI option '--full-report' and deprecate '--json'
  • add a cookie to profiled requests to help cross HTTP caches
  • add an extension to avoid infinite loops

0.5.0-alpha-1

  • Second major release. It breaks backwards compatibility. For now on, the player is only distributed as a .phar file and cannot be embedded in a PHP project anymore.

0.4.6

  • fix usage of parent build

0.4.5

  • fix usage with headers defined in steps

0.4.4

  • Fix typo in function name

0.4.3

  • throw exceptions in case configuration is invalid

0.4.2

  • made player exit with error when errors are logged

0.4.1

  • fixed embedding scenarios bug

0.4.0

  • updated deps
  • added log for extracted values
  • allowed endpoint to have a non-empty baseurl

0.3.0

  • added reload support
  • added a default User-Agent as it is required by some web servers
  • fixed request content-type when no parameters are provided
  • added the possibility to pass any variable to regex()
  • added the merge function
  • enable debug mode in guzzle when -vvv

0.2.0

  • added the possibility to configure Blackfire build references
  • added regex function
  • added the join function
  • added support for fake values

0.1.0

  • Initial release