kwhat/requestful

A simple PSR compatible HTTP client library

Maintainers

Details

github.com/kwhat/requestful

Homepage

Source

Issues

Installs: 13

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 3

Forks: 1

Open Issues: 0

v0.2.1 2022-06-04 18:24 UTC

Requires

Requires (Dev)

Provides

MIT 7d1992ec2da067c449061f0c965e96ca3eb88743

This package is auto-updated.

Last update: 2024-12-04 23:53:02 UTC

README

Latest Stable Version Latest Unstable Version Build Status Total Downloads License composer.lock available

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
  • 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"