README

Requestful: A simple PSR compatible HTTP client library

The goal of this library is to provide a short, simple and easy to understand alternative to Guzzle.

• Uses the latest PSR standards and recommendations
  • PSR-7 HTTP Message Interfaces
  • PSR-17 HTTP Factories
  • PSR-18 HTTP Client
• Supports both synchronous and asynchronous HTTP requests
• A+ Promises with a Guzzle compatible interface
• Modern PHP 7 support
• Hard ext-curl requirement

Installation

composer require kwhat/requestful

Usage

You will need a PSR-17 implantation to use this library. Personally I enjoy working with nyholm/psr7, but any library that provides psr/http-factory will be sufficient.

$factory = new Nyholm\Psr7\Factory\Psr17Factory();
$client = new Requestful\Http\Client($factory);
$request = $factory->createRequest(
    "GET", 
    "https://samples.openweathermap.org/data/2.5/weather?q=Los%20Angeles"
);

// Send a synchronous request
$response = $client->sendRequest($request);

var_dump(
    $response->getStatusCode(), // int(200)
    $response->getHeaderLine("content-type"), // string(30) "application/json; charset=utf8"
    $response->getBody() // string(459) "{"coord": {...}, "weather": {...}, ...}"
);

// Send an asynchronous request
$promise = $client->sendRequestAsync($request)
    ->then(function (Psr\Http\Message\ResponseInterface $response): string {
        return "Success: {$response->getStatusCode()}";
    });

var_dump($promise->wait()); // string(12) "Success: 200"