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
composer require kwhat/requestfulYou 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"