sfn/httpclient

A simple PSR-7 client

v0.1.1 2017-08-26 15:14 UTC

Requires

• php: ^7.0
• http-interop/http-factory: ^0.3.0
• psr/http-message: ~1.0

Suggests

• http-interop/http-factory-diactoros: ^0.3.0
• http-interop/http-factory-guzzle: ^0.3.1
• http-interop/http-factory-slim: ^0.3.0

MIT

• Sfn

• http
• client
• psr-7
• psr-17

README

Just a simple and little PSR7 client. It is still a work-in-progress but, more or less, it works.

Table of Contents

• Requirements
• Installation
  • Zend Diactoros support
  • Guzzle support
  • Slim support
• Usage
  • Create a client instance
  • Send a request
  • Methods for REST API
  • Base URI
• To-do
• License

Requirements

• PHP 7.0 or higher
• php-curl or allow_url_fopen set to true
• A PSR7 implementation.

Sfn\HttpClient needs a PSR-7 implementation. It supports Zend Diactoros, Guzzle and Slim at the moment.

Of course you can write your own HTTP Factory implementation for any PSR-7 implementation, look here for PSR-17 Http Factory interfaces.

Installation

Install using Composer.

composer require sfn/httpclient

Zend Diactoros support

composer require http-interop/http-factory-diactoros

Guzzle support

composer require http-interop/http-factory-guzzle

Slim support

composer require http-interop/http-factory-slim

Usage

Create a client instance

With the ClientFactory::make() method you can create the correct instance of the client. If it finds curl installed, it creates a client with a curl backend, otherwise it create a client who send request via php's file_get_contents.

ClientFactory::make() accepts an associative array with the client configuration. You must specify at least your PSR-17 HTTP Factory implementation. Here you can find the complete list of parameters in you can set in the configuration array.

// Zend Diactoros
$config = [
    'requestfactory'  => new Http\Factory\Diactoros\RequestFactory,
    'responsefactory' => new Http\Factory\Diactoros\ResponseFactory,
    'urifactory'      => new Http\Factory\Diactoros\UriFactory,
];

// Guzzle
$config = [
    'requestfactory'  => new Http\Factory\Guzzle\RequestFactory,
    'responsefactory' => new Http\Factory\Guzzle\ResponseFactory,
    'urifactory'      => new Http\Factory\Guzzle\UriFactory,
];

// Slim
$config = [
    'requestfactory'  => new Http\Factory\Slim\RequestFactory,
    'responsefactory' => new Http\Factory\Slim\ResponseFactory,
    'urifactory'      => new Http\Factory\Slim\UriFactory,
];

$client = Sfn\HttpClient\ClientFactory::make($config);

Send a request

First of all, you must create a request with your preferred Psr\Http\Message\RequestInterface implementation. Then you simply call the send() method of the client.

$request = (new Zend\Diactoros\Request())
    ->withUri(new Zend\Diactoros\Uri('http://api.example.com/path'))
    ->withMethod('GET')
    ->withAddedHeader('Content-Type', 'application/json');

$response = $client->send($request); // Return a ResponseInterface

Helper methods for REST API

There are get(), post(), put(), delete() and patch() helper methods. You can pass a second parameter, with an array of options. Here you can find a complete list of request parameters.

// GET request
$response = $client->get('http://api.example.com/path');

// POST request
$response = $client->post(
    'http://api.example.com/path',
    ['body' => http_build_query(['foo' => 'bar'])]
);

Base URI

You can also specify a base uri in the client configuration.

$config = [
    'requestfactory'  => new Http\Factory\Diactoros\RequestFactory,
    'responsefactory' => new Http\Factory\Diactoros\ResponseFactory,
    'urifactory'      => new Http\Factory\Diactoros\UriFactory,
    'baseuri'         => 'http://api.example.com'
];
$client = Sfn\HttpClient\ClientFactory::make($config);

// GET request
$response = $client->get('path'); // GET http://api.example.com/path

To-Do

• Cookies support
• SSL authentication
• Examples
• Better documentation

License

MIT License