blackfire/php-sdk

Blackfire.io PHP SDK

Maintainers

👁 fabpot

Package info

github.com/blackfireio/php-sdk

pkg:composer/blackfire/php-sdk

Statistics

Installs: 12 993 853

Dependents: 32

Suggesters: 4

Stars: 159

Open Issues: 8

v3.0.0 2026-06-01 08:02 UTC

Requires

Requires (Dev)

Suggests

  • ext-blackfire: The C version of the Blackfire probe
  • ext-zlib: To push config to remote profiling targets
  • symfony/panther: To use Symfony web test cases with Blackfire

Provides

None

Conflicts

None

Replaces

None

MIT ad3e1a20702f326957851c9711436f68cc83c769

  • Blackfire.io <support.woop@blackfire.io>

performanceprofilerxhprofuprofiler

This package is auto-updated.

Last update: 2026-06-01 11:59:26 UTC


README

Install the Blackfire PHP SDK via Composer:

$ composer require blackfire/php-sdk

Blackfire Client

See https://docs.blackfire.io/php/integrations/sdk

PhpUnit Integration

See https://docs.blackfire.io/php/integrations/phpunit

Proxy

If you want to inspect the traffic between profiled servers and blackfire's servers, you can use a small proxy script provided in this repository. Please read the instructions in ./bin/blackfire-io-proxy.php to do so.

PHP Probe

WARNING: This code should only be used when installing the Blackfire PHP extension is not possible.

This repository provides a Blackfire PHP Probe implementation that should only be used under the following circumstances:

  • You already have XHProf installed and cannot install the Blackfire PHP extension (think PHP 5.2);

  • You want a fallback in case the Blackfire PHP extension is not installed on some machines (manual instrumentation will be converted to noops).

Read more about how to use this feature on Blackfire's blog.

Blackfire Support

If you are facing any issue with using the Blackfire PHP SDK, please check our support site or reach out to support@blackfire.io.