pinkeen / api-debug-bundle
Allows easy API consumer debugging with web debug toolbar extension.
Installs: 701
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 1
Open Issues: 2
Type:symfony-bundle
Requires
- php: >=5.5.9
- guzzlehttp/psr7: ~1.0
- psr/http-message: ~1.0
- symfony/framework-bundle: >=3.3
- symfony/symfony: >=3.3
Suggests
- guzzlehttp/guzzle: Install for easy API calling and integrated debugging.
README
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.
For Symfony < 3.3
-compatible version use the v2.0
tag.
Requirements
- PHP 5.5.9
- Symfony 3.3
Installation
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:
_api_debug: resource: "@PinkeenApiDebugBundle/Resources/config/routing.yml" prefix: /_profiler
Services
New symfony approach
All services expect GuzzleClientFactory and RingPHPHandlerFactory are private, which means you cannot fetch services directly from the container via $container->get().
They are also automatically registered and set to autowire, all you need to do add type-hinted service to your class as an argument of contructor.
// src/AppBundle/Service/FooService.php // ... use Pinkeen\ApiDebugBundle\Bridge\Guzzle\Middleware\DataCollectorMiddleware; class FooService { private $dataCollectorMiddleware; public function __construct(DataCollectorMiddleware $dataCollectorMiddleware) { $this->dataCollectorMiddleware = $dataCollectorMiddleware; } // ... }
Usage
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; /* ... */ /** @var $eventDispatcher \Symfony\Component\EventDispatcher\EventDispatcher */ $eventDispatcher->dispatch( ApiEvents::API_CALL, new ApiCallEvent( new YourApiCallData(/* your params */) ) );
Guzzle
You've got two options here, either:
Let the bundle create the client for you...
/** @var $guzzleClientFactory \Pinkeen\ApiDebugBundle\Bridge\Guzzle\Service\GuzzleClientFactory */ $guzzleClientFactory->create([ /* 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()); /** @var $dataCollectorMiddleware \Pinkeen\ApiDebugBundle\Bridge\Guzzle\Middleware\DataCollectorMiddleware */ $dataCollectorMiddlewareHandler = $dataCollectorMiddleware->getHandler(); $handler->push($dataCollectorMiddlewareHandler); $client = new GuzzleHttp\Client(['handler' => $handler]);
RingPHP
Let the bundle create the handler for you:
/** @var $ringPHPHandlerFactory \Pinkeen\ApiDebugBundle\Bridge\RingPHP\Service\RingPHPHandlerFactory */ $handler = $ringPHPHandlerFactory->create(new CurlHandler());
Use the collector_middleware service to create your RingPHP middleware and wrap it around your base handler:
/** @var $dataCollectorMiddleware \Pinkeen\ApiDebugBundle\Bridge\RingPHP\Middleware\DataCollectorMiddleware */ $ringPhpHandler = $dataCollectorMiddleware->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 Pinkeen\ApiDebugBundle\Bridge\Guzzle\Service\GuzzleClientFactory
or
Pinkeen\ApiDebugBundle\Bridge\RingPHP\Service\RingPHPHandlerFactory
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.