Saloon 2 is Here

The Saloon package for PHP released version 2, rebuilt from the ground up with faster concurrency, retries, HTTP client agnostic design, solo requests, and more:

📣 Release day! 🎉

Introducing Saloon v2.0 🎉🤠 It’s been an incredible journey building this. Version two is packed full of features and improvements that I think you’ll love. Start building beautiful API integrations and SDKs today 🔥

Enjoy ❤️ https://t.co/Vo4V7kCfmr pic.twitter.com/aldCuhA16u
— Sam Carré 🤠 (@carre_sam) February 20, 2023

Namespace changes (i.e., SaloonRequest -> Request)
Decoupling Guzzle from the Saloon V2 Package
Improved developer experience
Connector-first design
New Middleware pipeline
Request concurrency and pooling
Better interface adoption
Improved interactions with requests, headers, query params, and config
Improved multi-part requests
Improved Laravel support
Improved exception handling
Solo requests
New pagination helpers
And more

Solo requests are perfect for APIs for which you might make one request to the API. Typically, you'd need to define a connector to make requests. With a solo request, you define a class that extends SoloRequest and call send() to use it!

class GetPokemonRequest extends SoloRequest
{
     protected Method $method = Method::GET;
 
     public function resolveEndpoint()
     {
          return 'https://pokeapi.co/api/v2/pokemon';
     }
}
 
// No Connector Needed!
 
$request = new GetPokemonRequest;
$response = $request->send();

Pagination is another new feature that makes it easy to iterate through hundreds of pages without writing any boilerplate code:

$connector = new SpotifyConnector;
 
// Create a paginator and pass in a request class, in this example
// we'll pass in the LikedSongsRequest which will retrieve all
// the liked songs of the authenticated user.
 
$paginator = $connector->paginate(new LikedSongsRequest);
 
// Create a Laravel LazyCollection from the paginator and iterate
// over each of the results. Traditionally, the liked songs endpoint
// only lets you get 50 tracks per request, but the paginator will
// automatically grab every page of results and pass it into a
// single collection! 🔥
 
$collection = $paginator->collect('items')->map(function ($track) {
    return sprintf('%s - %s', $track['artist'], $track['name']);
});
 
// Convert the LazyCollection into an array.
 
$data = $collection->all();

To see everything new in V2, check out What's new in v2 in the official documentation. Congratulations to Sam Carré and all the contributors that worked on Saloon V2!