saxulum/saxulum-http-client-interface

Saxulum Http Client Interface

saxulum-http-client-interface

, _(*1)

Features

• Provides a simple http client interface
• Provides a simple request and response object
• Provides a header converter

Requirements

• PHP 5.3+

Installation

Through Composer as saxulum/saxulum-http-client-interface., _(*2)

Within a library/bundle

``` {.json} { "require": { "saxulum/saxulum-http-client-interface": "~1.0", "saxulum/saxulum-http-client-adapter": "~1.0" } }, <sub>(*3)</sub>

#### Within a project

Replace `saxulum/saxulum-http-client-adapter-buzz` with the adapter you like to use.

``` {.json}
{
    "require": {
        "saxulum/saxulum-http-client-interface": "~1.0",
        "saxulum/saxulum-http-client-adapter-buzz": "~1.0"
    }
}

Usage

``` {.php} $httpClient = new MyHttpClientImplementation; $response = $httpClient->request(new Request( '1.1', Request::METHOD_GET, 'http://en.wikipedia.org', array( 'Connection' => 'close', ) ));, <sub>(*4)</sub>

## Implement

To implement this interface, you need a existing http client and write an adapter for it or use an existing one.

``` {.php}
<?php

namespace Saxulum\HttpClient;

interface HttpClientInterface
{
    /**
     * @param  Request  $request
     * @return Response
     */
    public function request(Request $request);
}

Add the following to your adapter composer.json, <sub>(*5)</sub>

{.json} { "provide": { "saxulum/saxulum-http-client-adapter": "1.0" } }, <sub>(*6)</sub>

Implementations

• saxulum-http-client-adapter-buzz a kriswallsmith/buzz adapter
• saxulum-http-client-adapter-joomla a joomla/http adapter
• saxulum-http-client-adapter-guzzle a guzzle/guzzle adapter
• saxulum-http-client-adapter-vinelab a vinelab/http adapter
• saxulum-http-client-adapter-zend a [zendframework/zend-http][11] adapter