Allows easy API consumer debugging with web debug toolbar extension.

Installs: 180

Dependents: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 1

Type: symfony-bundle

v2.1.1 2015-08-12 14:00 UTC


ApiDebugBundle in action

This bundle adds a web debug toolbar tab which displays information about API consumer requests.

It aims to be universal and allow for easy integration with SDKs and HTTP client libraries.

Currently it supports Guzzle 6 out-of-the box.

It should be extremely easy to integrate with any http client using PSR-7 messages.

For Guzzle4-compatible version use the v1.0 tag.


  • PHP 5.4
  • Symfony 2.4


The usual Symfony stuff.

The composer.json needs: "pinkeen/api-debug-bundle": "dev-master",.

The AppKernel.php needs: new Pinkeen\ApiDebugBundle\PinkeenApiDebugBundle(),.

Add the following to your app/config/routing_dev.yml if you want to be able to view raw body data:

    resource: "@PinkeenApiDebugBundle/Resources/config/routing.yml"
    prefix:   /_profiler


Integrate with your custom client

Firstly you have to subclass AbstractCallData which holds data from a single API request.

If you are using a PSR-7 comptible client then you can use PsrCallData instead of writing your own data class.

Then every time your API consumer makes a request dispatch an ApiEvents::API_CALL event.

    use Pinkeen\ApiDebugBundle\ApiEvents;
    use Pinkeen\ApiDebugBundle\Event\ApiCallEvent;

    /* ... */

        new ApiCallEvent(
            new YourApiCallData(/* your params */)


You've got two options here, either:

Let the bundle create the client for you...

        /* Guzzle client config (optional).
         * It is passed directly to GuzzleHttp\Client constructor. */

... or push the collector handler to your middleware stack.

    $handler = new GuzzleHttp\HandlerStack(new GuzzleHttp\Handler\CurlHandler());
    $client = new GuzzleHttp\Client(['handler' => $handler]);


Let the bundle create the handler for you:

    $handler = $serviceContainer->get('ring_php.handler_factory')->create(new CurlHandler());

Use the collector_middleware service to create your RingPHP middleware and wrap it around your base handler:

    $ringPhpHandler = $serviceContainer
        ->createHandler(new GuzzleHttp\Ring\Client\CurlHandler(), 'apiname')

PS Nicely integrates with elasticsearch-php 2.0.

## Production

For production environment you probably want to skip all of the data gathering.

You should take care of that yourself, unless you're using `guzzle.client_factory` or `ring_php.handler_factory` which
skip it when not in debug mode.

## Notes 

I haven't found an easy way to get call duration out of guzzle6, so there's a regression here. If anybody has an idea
please give me a shout.