# Saloon

Saloon is a PHP library that helps you rapidly build third party API integrations or SDKs. It's configured to be production-ready by default, offers a simple, standardised development flow for your whole team and has utilities to help test your API integrations before you ship to production. Saloon is loved by thousands of developers and downloaded over 2 million times.

[![Build Status](https://github.com/saloonphp/saloon/actions/workflows/tests.yml/badge.svg)](https://img.shields.io/github/actions/workflow/status/saloonphp/saloon/tests.yml?label=tests)![](https://img.shields.io/packagist/dm/saloonphp/saloon)![](https://img.shields.io/github/stars/saloonphp/saloon)

<figure><img src="https://2077574264-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAnnOFZ5KwPjnXI3FPOQw%2Fuploads%2FHWiSnEu4W13lqJJ6oG7W%2FIntroducing%20Saloon%20v3.png?alt=media&#x26;token=582f2f0b-59b3-4dc5-b860-fec4b1e24190" alt=""><figcaption><p>Introducing Saloon v3</p></figcaption></figure>

### Key Features

* Lightweight, only depends on one library - Guzzle.
* Offers "Connector" and "Request" classes to encapsulate API integrations into files
* Allows you to record real requests in your tests so you have accurate testing data for your assertions.
* Works in any PHP framework, or just regular PHP applications (with Composer)
* Comes with powerful plugins to handle caching, rate limits, data transfer objects, XML, and more

{% content-ref url="the-basics/installation" %}
[installation](https://docs.saloon.dev/the-basics/installation)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.saloon.dev/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
