unk-fy/laravel-api-response

Laravel API Response helpers for standardized API responses

1.2.4 2025-06-11 15:22 UTC

Requires

• php: ^7.3|^8.0
• illuminate/http: ^8.0|^9.0|^10.0
• illuminate/pagination: ^8.0|^9.0|^10.0
• illuminate/support: ^8.0|^9.0|^10.0

Requires (Dev)

• phpunit/phpunit: ^9.0|^10.0

Suggests

• yajra/laravel-datatables-oracle: Required for using the HttpResponseWithDataTables trait

MIT

README

The upcoming version of this package will include several improvements to enhance developer experience and API consistency:

• ✅ Auto-detect Laravel API Resources or Collections and wrap them automatically in success responses.
• ✅ Debug mode support (toggled via .env) to include exception trace info in error responses (local/dev environments only).
• ✅ Laravel localization integration using __() helper for translatable response messages.
• ✅ Predefined constants or enums for HTTP status codes, e.g., self::NOT_FOUND, self::CREATED, for cleaner syntax.
• ✅ Static testing helpers like HttpResponse::mockSuccess() and mockError() for writing cleaner API tests.
• ✅ Macro support to enable response()->success($data) and response()->error($message) via Laravel service provider.
• ✅ Response-wrapping middleware that auto-converts all controller return data into standardized API formats (unless opted out).
• ✅ Optional JSON:API compatible output mode, supporting { data: ..., errors: ..., meta: ... } structure for advanced clients.

feedback, and ideas are welcome NB: This package is primarily built for my personal use.