salient/curler

The curler package of the Salient toolkit

v0.99.63 2024-11-15 09:20 UTC

Requires

• php: >=7.4
• psr/http-client: ^1
• psr/http-message: ^1.1 || ^2
• salient/contracts: v0.99.63
• salient/core: v0.99.63
• salient/http: v0.99.63
• salient/utils: v0.99.63

Provides

• psr/http-client-implementation: ^1

MIT

• Luke Arms

README

The Curler component of the Salient toolkit

salient/curler provides an HTTP client optimised for exchanging data with RESTful API endpoints.

• Simple, fluent interface for sending HEAD, GET, POST, PUT, PATCH and DELETE requests
• Flexible query string and payload handling
• Uses generators to iterate over data from endpoints that use pagination
• Response cache for HEAD, GET and optionally POST requests¹
• Cookie handling and persistence
• Uses PSR-7 request, response and stream interfaces
• Implements PSR-18 (HTTP Client)
• Behaviour can be customised via stackable middleware
• Generates HTTP Archive (HAR) files for debugging and analysis

<?php
$curler = new \Salient\Curler\Curler('https://api.github.com/repos/salient-labs/toolkit/releases/latest');
echo 'Latest release: ' . $curler->get()['tag_name'] . \PHP_EOL;

Documentation

API documentation for salient/curler tracks the main branch of the toolkit's GitHub repository, where further documentation can also be found.