saloonphp/saloon

Build beautiful API integrations and SDKs with Saloon

v3.10.0 2024-08-03 14:11 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.6
• guzzlehttp/promises: ^1.5 || ^2.0
• guzzlehttp/psr7: ^2.0
• psr/http-factory: ^1.0
• psr/http-message: ^1.1 || ^2.0

Requires (Dev)

• ext-simplexml: *
• friendsofphp/php-cs-fixer: ^3.5
• illuminate/collections: ^9.39 || ^10.0
• league/flysystem: ^3.0
• pestphp/pest: ^2.10
• phpstan/phpstan: ^1.11.4
• saloonphp/xml-wrangler: ^1.1
• spatie/ray: ^1.33
• symfony/dom-crawler: ^6.0 || ^7.0
• symfony/var-dumper: ^6.3 || ^7.0

Suggests

• illuminate/collections: Required for the response collect() method.
• saloonphp/xml-wrangler: Required for the response xmlReader() method.
• symfony/dom-crawler: Required for the response dom() method.
• symfony/var-dumper: Required for default debugging drivers.

Conflicts

• sammyjo20/saloon: *

MIT

• Sam Carré

• api
• sdk
• sammyjo20
• saloon
• api-integrations

README

Saloon – Your Lone Star of your API integrations

A PHP package that helps you build beautiful API integrations and SDKs 🤠

Click here to read the documentation

Introduction

Saloon is a PHP library that gives you the tools to build beautifully simple API integrations and SDKs. Saloon moves your API requests into reusable classes so you can keep all your API configurations in one place. Saloon comes with many exciting features out of the box like recording requests in your tests, caching, OAuth2 and pagination. It's a great starting point for building simple, standardised API integrations in your application.

<?php

$forge = new ForgeConnector('api-token');

$response = $forge->send(new GetServersRequest);

$data = $response->json();

Key Features

• Provides a simple, easy-to-learn, and modern way to build clean, reusable API integrations
• Built on top of Guzzle, the most popular and feature-rich HTTP client
• Works great within a team as it provides a standard everyone can follow
• Great for building your next PHP SDK or library
• Packed full of features like request recording, request concurrency, caching, data-transfer-object support, and full Laravel support.
• Framework agnostic
• Lightweight and has few dependencies.

Getting Started

Click here to get started

Contributing

Please see here for more details about contributing.

Security

Please see here for our security policy.

Credits

• Sam Carré
• All Contributors

And a special thanks to Caneco for the logo ✨