larium/http-client

An http client implemention compatible with psr-7 http message.

PSR-7 PHP Http Client

An http client wrapping curl php extension, compatible with PSR-7 Http Message interfaces., _(*1)

• Installation
  • Composer from command line
  • Composer from composer.json
• Set Up
• Basic Usage
  • Using message factory discovery

Installation

You can install this library using Composer, _(*2)

Composer from command line

In root directory of your project run through a console:, _(*3)

$ composer require "larium/http-client":"~1.0"

Composer from composer.json

Include require line in your composer.json file, _(*4)

{
    "require": {
        "larium/http-client": "~1.0"
    }
}

and run from console in the root directory of your project:, _(*5)

$ composer update

Set up

After installation you must require autoload file from composer in to your boot php script., _(*6)

<?php
require_once 'vendor/autoload.php';

Basic usage

Using message factory discovery

You can use factory discovery to find any Request class that implements PSR-7 HTTP Message interfaces, to create the Request instance., _(*7)

<?php

use Larium\Http\Client;
use Http\Discovery\Psr17FactoryDiscovery;
use Psr\Http\Client\ClientExceptionInterface;

$request = Psr17FactoryDiscovery::findRequestFactory()->createRequest('GET', 'http://www.example.com');
$client = new Client();
try {
    $response = $client->sendRequest($request);
    # Response is a Psr\Http\Message\ResponseInterface instance implementation.
} catch (ClientExceptionInterface $e) {
    //Resolve exception from client.
}