Simple PSR-18 HTTP client.
A simple PSR-18 HTTP client library.
composer require nimbly/shuttle
- Responses create php://temp response body stream and swap to disk when necessary.
- cURL (default) and Stream Context handlers supported.
- Middleware support out of the box.
- Easy body transformations when creating requests with JsonBody, FormBody, and XmlBody helper classes.
- Asynchronous calls.
The quickest and easiest way to begin making requests in Shuttle is to use the HTTP method name:
use Nimbly\Shuttle\Shuttle; $shuttle = new Shuttle; $response = $shuttle->get("https://www.google.com"); $response = $shuttle->post("https://example.com/search", "Form data"));
Shuttle has built-in methods to support the major HTTP verbs: get, post, put, patch, delete, head, and options. However, you can make any HTTP verb request using the request method directly.
$response = $shuttle->request("connect", "https://api.example.com/v1/books");
Responses in Shuttle implement PSR-7 ResponseInterface and as such are streamable resources.
$response = $shuttle->get("https://api.example.com/v1/books"); echo $response->getStatusCode(); // 200 echo $response->getReasonPhrase(); // OK echo $response->isSuccessful(); // true $body = $response->getBody()->getContents();
Shuttle will throw a
RequestException by default if the request failed. This includes things like host name not found, connection timeouts, etc.
Responses with HTTP 4xx or 5xx status codes will not throw an exception and must be handled properly within your business logic.
If code reusability and portability is your thing, future proof your code by making requests the PSR-7 way. Remember, PSR-7 stipulates that Request and Response messages be immutable.
// Build Request message with your favorite PSR-7 library. $request = new Request("get", "https://www.example.com"); // Send the Request. $shuttle = new Shuttle; $response = $shuttle->sendRequest($request);
An easy way to submit data with your request is to use the
\Shuttle\Body\* helper classes. These classes will automatically
transform the data, convert to a BufferStream, and set a default Content-Type header on the request.
The request bodies support are:
JsonBodyConverts an associative array into JSON, sets
FormBodyConverts an associative array into a query string, sets
XmlBodyDoes no conversion of data, sets
To submit a JSON payload with a request:
use Nimbly\Shuttle\Body\JsonBody; $book = [ "title" => "Breakfast Of Champions", "author" => "Kurt Vonnegut", ]; $shuttle->post("https://api.example.com/v1/books", new JsonBody($book));