PHPackages                             faresnassar09/api-vault - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Caching](/categories/caching)
4. /
5. faresnassar09/api-vault

ActiveLibrary[Caching](/categories/caching)

faresnassar09/api-vault
=======================

A fluent Laravel package for standardized API responses, smart pagination, and page-aware caching.

v1.0.0(2mo ago)08MITPHPPHP ^8.2CI passing

Since Feb 13Pushed 2mo agoCompare

[ Source](https://github.com/faresnassar09/faresnassar09-api-vault)[ Packagist](https://packagist.org/packages/faresnassar09/api-vault)[ RSS](/packages/faresnassar09-api-vault/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

[![Run Tests](https://github.com/faresnassar09/faresnassar09-api-vault/actions/workflows/tests.yml/badge.svg)](https://github.com/faresnassar09/faresnassar09-api-vault/actions/workflows/tests.yml)

🔐 API Vault
===========

[](#-api-vault)

**API Vault** is a lightweight Laravel utility for building clean, consistent, and chainable API responses with optional caching, callbacks, headers, and response customization.

It helps you avoid repetitive response logic and keeps your controllers clean and readable.

---

✨ Features
----------

[](#-features)

- Fluent method chaining for API responses
- Optional caching support
- Lazy data execution using callbacks (with or without caching)
- Unified response structure
- Custom headers & JSON options support
- Clean and expressive syntax

---

📦 Installation
--------------

[](#-installation)

```
composer require faresnassar09/api-vault
```

---

🚀 Usage Examples
----------------

[](#-usage-examples)

### 1️⃣ Basic data response

[](#1️⃣-basic-data-response)

```
use FaresNassar\ApiVault\Formatter;

$formatter = new Formatter();

return $formatter
    ->success(true)
    ->message('Users Retrieved Successfully')
    ->data(User::all())
    ->code(200)
    ->send();
```

### 2️⃣ Using callback() with caching

[](#2️⃣-using-callback-with-caching)

```
return $formatter
    ->success(true)
    ->message('Users Retrieved And Cached Successfully')
    ->cache('users_cache_key', 600)
    ->callback(fn () => User::where('id', '