PHPackages                             ho3inpgmer/laravel-api-wrapper - 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. [API Development](/categories/api)
4. /
5. ho3inpgmer/laravel-api-wrapper

ActiveLibrary[API Development](/categories/api)

ho3inpgmer/laravel-api-wrapper
==============================

A Laravel package for managing API responses with a fluent interface

v1.0.2(6mo ago)01MITPHPPHP ^8.1|^8.2|^8.3

Since Oct 24Pushed 6mo agoCompare

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

READMEChangelogDependencies (4)Versions (4)Used By (0)

Laravel API Wrapper
===================

[](#laravel-api-wrapper)

A Laravel package for managing API responses with a fluent, elegant interface.

[![Latest Version on Packagist](https://camo.githubusercontent.com/18d9f23d8a6b2738c3f69a2f8f31f9251484eef04a0a815c7c81f7f50fb673a2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686f33696e70676d65722f6c61726176656c2d6170692d777261707065722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ho3inpgmer/laravel-api-wrapper)[![Total Downloads](https://camo.githubusercontent.com/147888deba0293b4fa9957e0aaa41d315cf6650e326367c687bb6d8df1791d8e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f686f33696e70676d65722f6c61726176656c2d6170692d777261707065722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ho3inpgmer/laravel-api-wrapper)

Installation
------------

[](#installation)

Install via Composer:

```
composer require ho3inpgmer/laravel-api-wrapper
```

Configuration
-------------

[](#configuration)

Publish the configuration file (optional):

```
php artisan vendor:publish --tag=api-wrapper-config
```

Usage
-----

[](#usage)

### Success Response

[](#success-response)

```
use Ho3inpgmer\ApiWrapper\ApiResponse;

// Basic success response
return ApiResponse::success(['user' => $user]);

// With custom message
return ApiResponse::success($data, 'User created successfully', 201);

// Without data
return ApiResponse::success()->withoutData();

// Add extra fields
return ApiResponse::success($data)
    ->add('meta', ['page' => 1])
    ->add('links', ['next' => 'url']);
```

### Error Response

[](#error-response)

```
// Basic error response
return ApiResponse::error(['email' => 'Invalid email']);

// With custom status and message
return ApiResponse::error($errors, 404, 'Resource not found');

// Without errors field
return ApiResponse::error()->withoutErrors();
```

### Method Chaining

[](#method-chaining)

```
return ApiResponse::success($data)
    ->withStatus(201)
    ->add('meta', $meta)
    ->withoutMessage();
```

Response Format
---------------

[](#response-format)

Success response:

```
{
    "ok": true,
    "message": "عملیات با موفقیت انجام شد",
    "data": {}
}
```

Error response:

```
{
    "ok": false,
    "message": "خطا در انجام عملیات",
    "errors": []
}
```

Available Methods
-----------------

[](#available-methods)

- `success($data, $message, $status)` - Create a success response
- `error($errors, $status, $message)` - Create an error response
- `withoutMessage()` - Remove message from response
- `withoutData()` - Remove data from response
- `withoutErrors()` - Remove errors from response
- `withStatus($status)` - Set custom HTTP status code
- `add($key, $value)` - Add extra fields to response

Testing
-------

[](#testing)

```
composer test
```

License
-------

[](#license)

MIT License. Please see [License File](LICENSE) for more information.

Credits
-------

[](#credits)

- [Ho3inpgmer](https://github.com/ho3inpgmer)

Contributing
------------

[](#contributing)

Contributions are welcome! Please feel free to submit a Pull Request.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance66

Regular maintenance activity

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

200d ago

PHP version history (2 changes)v1.0.0PHP ^8.1

v1.0.1PHP ^8.1|^8.2|^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/5ffccafb52ccbf203fa8d338758d09a6e57f4ebae7d945eaefe8bf6564a5bea0?d=identicon)[ho3inpgmer](/maintainers/ho3inpgmer)

---

Top Contributors

[![ho3inpgmer](https://avatars.githubusercontent.com/u/96419195?v=4)](https://github.com/ho3inpgmer "ho3inpgmer (4 commits)")

---

Tags

responsejsonapilaravelwrapper

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ho3inpgmer-laravel-api-wrapper/health.svg)

```
[![Health](https://phpackages.com/badges/ho3inpgmer-laravel-api-wrapper/health.svg)](https://phpackages.com/packages/ho3inpgmer-laravel-api-wrapper)
```

###  Alternatives

[dragon-code/laravel-json-response

Automatically always return a response in JSON format

1118.6k1](/packages/dragon-code-laravel-json-response)[obiefy/api-response

Simple Laravel package to return Json responses.

17324.6k](/packages/obiefy-api-response)[kennedy-osaze/laravel-api-response

Renders consistent HTTP JSON responses for API-based projects

654.5k](/packages/kennedy-osaze-laravel-api-response)[djurovicigoor/larajsonresponse

Laravel API wrapper for returning JSON response.

116.8k](/packages/djurovicigoor-larajsonresponse)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)