clients.md

Creating a service for your client

There are two ways for creating a service for your client:

• Using the semantic configuration (Beginners)
• Registering your own service (Advanced users)

Creating a client using semantic configuration

Simply write the following code:

csa_guzzle:
    clients:
        github_api:
            config:
                base_url: https://api.github.com
                defaults:
                    headers:
                        Accept: application/vnd.github.v3+json

The previous code will create a new service, called csa_guzzle.client.github_api, that you can use in your controller, or that you can inject in another service:

<?php

use Symfony\Bundle\FrameworkBundle\Controller\Controller;

class MyController extends Controller
{
    public function indexAction()
    {
        $client = $this->get('csa_guzzle.client.github_api');
        // ...
    }
}

Registering your own service

To have a client supported by the bundle, simply tag it as such:

<service id="acme.client" class="%acme.client.class%">
    <tag name="csa_guzzle.client" />
</service>