Giter VIP home page Giter VIP logo

saloon's Introduction

saloon's branding hero

Saloon – Your Lone Star of your API integrations

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

Build Status

Click here to read the documentation

Introduction

Saloon offers a fluent, object-oriented wrapper to build your next API integration or PHP SDK. It makes sharing API requests throughout your application a breeze. You don’t have to configure a HTTP client, so you can start sending requests really quickly.

If you need request faking for your tests, Saloon has it out of the box alongside many other useful tools like OAuth2 boilerplate and caching. If you use Laravel, there's also a dedicated Laravel package with artisan console commands to help you build even faster.

<?php

use App\Http\Saloon\Requests\GetForgeServerRequest;

$request = new GetForgeServerRequest(serverId: '123456');

$response = $request->send();
$data = $response->json();

Features

  • Simple and easy to learn syntax that standardises the way you interact with APIs
  • Abstract API integrations into classes so you can keep your code DRY
  • Configuration is fast and can be shared across all your requests
  • Built on top of Guzzle, one of the most popular PHP HTTP clients.
  • Framework agnostic
  • Mocking requests for testing
  • Great for building your own PHP SDKs
  • Authentication & OAuth2 boilerplate already built for you
  • Scalable with lots of API integrations across many team members

Documentation

Click here to read the documentation

Why Saloon?

Building API integrations can be time consuming. After you have found an API client to use, you’re faced with lots of configuration to remember and it’s hard to repeat requests without copying and pasting, and then when you introduce patterns like OAuth2 everything gets complicated. You’ll often find yourself writing the same boilerplate code over and over again.

We’ve standardised the way we talk to APIs with PSR-7 and PSR-18 but we haven’t got a standard structure to build API integrations.

Saloon aims to solve this.

Contributing

Please see here for more details about contributing.

Security

Please see here for our security policy.

Credits

And a special thanks to Caneco for the logo ✨

Support This Project

Buy Me a Coffee at ko-fi.com

saloon's People

Contributors

ajthinking avatar ashleyhood avatar caneco avatar gummibeer avatar leo108 avatar ronnievisser avatar sammyjo20 avatar szepeviktor avatar yurirnascimento avatar

Stargazers

 avatar  avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.