PHPackages                             agunbuhori/responder - 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. [Utility & Helpers](/categories/utility)
4. /
5. agunbuhori/responder

ActiveLibrary[Utility & Helpers](/categories/utility)

agunbuhori/responder
====================

Laravel settings manager package

v1.0(8mo ago)17MITPHP

Since Sep 12Pushed 8mo agoCompare

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

READMEChangelogDependenciesVersions (2)Used By (0)

Laravel Responder
=================

[](#laravel-responder)

A simple and flexible responder package for Laravel to standardize API responses.
It helps you return consistent **JSON responses** with optional transformers, status codes, and messages.

---

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

[](#-installation)

```
composer require agunbuhori/responder
```

---

⚙️ Setup
--------

[](#️-setup)

The package binds `ResponderInterface` into the container.
You can use it via:

- The global helper `responder()`
- The `HasResponder` trait
- Directly resolving `ResponderInterface` from the service container

---

🚀 Usage
-------

[](#-usage)

### 1. Using the `responder()` helper

[](#1-using-the-responder-helper)

```
use App\Models\User;

public function show(User $user)
{
    return responder()
        ->data($user)
        ->status(200)
        ->message("User retrieved successfully")
        ->send();
}
```

---

### 2. With Transformer

[](#2-with-transformer)

```
namespace App\Transformers;

use App\Models\User;
use Agunbuhori\Responder\Transformer;

class UserTransformer extends Transformer
{
    public function handle(User $user): array
    {
        return [
            'id'   => $user->id,
            'name' => $user->name,
            'email' => $user->email,
        ];
    }
}
```

```
use App\Models\User;
use App\Transformers\UserTransformer;

public function show(User $user)
{
    return responder()
        ->data($user, UserTransformer::class)
        ->status(200)
        ->message("User retrieved successfully")
        ->send();
}
```

---

### 3. Using `HasResponder` trait

[](#3-using-hasresponder-trait)

```
use Agunbuhori\Responder\Traits\HasResponder;

class UserController extends Controller
{
    use HasResponder;

    public function index()
    {
        return $this->success(User::all());
    }

    public function show(User $user)
    {
        return $this->success($user);
    }

    public function store()
    {
        return $this->error(422, "Validation failed");
    }
}
```

---

### 4. Without Wrapper

[](#4-without-wrapper)

```
return responder()
    ->data($user)
    ->withoutWrapper()
    ->send();
```

---

📚 Response Format
-----------------

[](#-response-format)

**Default wrapped response:**

```
{
  "data": { /* your transformed data */ },
  "status": 200,
  "message": "success"
}
```

**Without wrapper:**

```
{
  "id": 1,
  "name": "John Doe"
}
```

---

⚡ Exception Response
--------------------

[](#-exception-response)

```
responder()
    ->data(['error' => 'Not Found'])
    ->status(404)
    ->message('Resource not found')
    ->exception();
```

---

🔨 Artisan Command
-----------------

[](#-artisan-command)

This package provides a command to **generate Transformer classes**.

### Usage

[](#usage)

```
php artisan make:responder-transformer {name} {--model=}
```

- `{name}` → The name of the transformer class
- `--model` (optional) → Bind the transformer to an Eloquent model

### Examples

[](#examples)

**Without model:**

```
php artisan make:responder-transformer UserTransformer
```

Generates:

```