# Connectors

From the Quick start guide, you have learned how to send a request without defining an HTTP client. However in real world use cases, typically you need to customize your HTTP client with options such as custom authorization header, timeout, etc...

Within your connector, you can create your own HTTP client, set up the pipeline to run middleware, and define default middleware.

To create your own HTTP client, use the defaultClient method.

<?php

use Fansipan\Contracts\ConnectorInterface;
use Fansipan\Traits\ConnectorTrait;
use Fansipan\Request;
use GuzzleHttp\Client;
use Psr\Http\Client\ClientInterface;

final class MyConnector implements ConnectorInterface
{
    use ConnectorTrait;

    private $token;

    public function __construct(string $token)
    {
        $this->token = $token;
    }

    public static function baseUri(): ?string
    {
        return 'https://my-service.api';
    }

    protected function defaultClient(): ClientInterface
    {
        return new Client([
            'timeout' => 10,
            'headers' => [
                'Authorization' => 'Bearer '.$this->token,
            ],
        ]);
    }
}

As an end-user, you can override the client by using withClient method

$connector = (new MyConnector())->withClient(new Client());

Then you can start sending your request.

$connector = new GithubConnector(token: 'github-token');

$connector->send(new GetUserRepoRequest('phanxipang/fansipan');

This allows you to have constructor arguments on the connector, perfect for API tokens or configuration and also utilizes the powerful middleware pipeline feature.

Furthermore, it is possible to bind your connector to a PSR-11 container. By doing so, you can inject your connector into your service whenever you need to send requests.

Please visit the Digging Deeper chapter to explore additional usage of connector.