guilhermednt/http-service-bundle

Symfony HttpServiceBundle

http-service-bundle

Currently, this bundle turns Guzzle HTTP Client into a service to allow application wide configuration (like curl proxy settings)., _(*1)

It uses a ClientFactory so that you can adapt it to other HTTP Clients., _(*2)

Installation

Step 1: Add package as requirement in Composer

Add the bundle to your composer.json:, _(*3)

``` js { "require": { "guilhermednt/http-service-bundle": "dev-master" } }, <sub>(*4)</sub>

Then run the update command:

``` bash
$ composer update guilhermednt/http-service-bundle

Step 2: Tell Symfony2 about it.

Enable the bundle in your AppKernel.php:, <sub>(*5)</sub>

``` php <?php // app/AppKernel.php, <sub>(*6)</sub>

public function registerBundles() { $bundles = array( // ... new Donato\HttpServiceBundle\DonatoHttpServiceBundle(), ); }, <sub>(*7)</sub>

### Step 3: Add desired parameters

This bundle does not require you to change `config.yml`, so that you can have different configuration scenarios for each environment you have.

The minimum configuration needed is this:

``` yaml
# app/config/parameters.yml

parameters:
    http_client_factory_class: Donato\HttpServiceBundle\Factory\ClientFactory
    http_client_config: ~

Below you can see an example for HTTP Proxy with Authentication:, <sub>(*8)</sub>

``` yaml, <sub>(*9)</sub>

app/config/parameters.yml

imports: - { resource: constants.php }, <sub>(*10)</sub>

parameters: # ... your regular parameters ..., <sub>(*11)</sub>

http_client_factory_class: Donato\HttpServiceBundle\Factory\ClientFactory
http_client_config:
    curl:
        %curl.proxy.type%: HTTP
        %curl.proxy.host%: my.proxy.example.com
        %curl.proxy.port%: 1234
        %curl.proxy.auth%: username:password

**Note** that the CURL constants are introduced via **constants.php** as follows:

``` php
<?php
// app/config/constants.php

$container->setParameter('curl.proxy.type', CURLOPT_PROXYTYPE);
$container->setParameter('curl.proxy.host', CURLOPT_PROXY);
$container->setParameter('curl.proxy.port', CURLOPT_PROXYPORT);
$container->setParameter('curl.proxy.auth', CURLOPT_PROXYUSERPWD);

That's it!

Now you can start using the service named http_client_factory. To instantiate a Guzzle\Http\Client you may just do the following:, <sub>(*12)</sub>

``` php <?php // SomeController.php public function someAction() { // ..., <sub>(*13)</sub>

    $clientFactory = $this->get('http_client_factory');
    $client = $clientFactory->getGuzzleClient();

    // ...
}

```, <sub>(*14)</sub>