mojtabarks / api-response
一个轻量级包,用于创建合适的响应
v2.1.0
2021-07-13 18:40 UTC
This package is auto-updated.
Last update: 2024-09-14 02:20:06 UTC
README
一个轻量级包,用于在 laravel 或 lumen 中创建和传递响应
先决条件
laravel 或 lumen > v5.4
安装
$ composer require mojtabarks/api-response
用法
您可以在项目中使用 Facade 或依赖注入
Facade 示例
use Mojtabarks\ApiResponse\ApiResponse;
ApiResponse::successResponse()
// ->setCode(xxxx)
// ->setMessage("blah blah blah blah !")
// ->setSuccessStatus(--boolean !!!--)
// ->setResponseKey('data')
// ->setResponseValue(--array-- => [ // --------------> SET DATA METHOD IS ONLY AVAILABLE FOR SUCCESS RESPONSE
'projectName' => 'my awesome project',
.
.
.
])
->render();
ApiResponse::failureResponse()
// ->setCode(xxxx)
// ->setMessage("blah blah blah blah !")
// ->setSuccessStatus(--boolean !!!--)
// ->setResponseKey('error')
// ->setResponseValue(--array-- => [ // --------------> SET ERROR METHOD IS ONLY AVAILABLE FOR ERROR RESPONSE
'error text' => 'looks like something went wrong',
.
.
.
])
->render();
ApiResponse::customResponse()
// ->setCode(xxxx)
// ->setMessage("blah blah blah blah !")
// ->setSuccessStatus(--boolean !!!--)
// ->setResponseKey('additional')
// ->setResponseValue(--array-- => [ // --------------> SET ADDITIONAL METHOD IS ONLY AVAILABLE FOR CUSTOM RESPONSE
// 'custom message' => 'custom message goes here',
// .
// .
// .
// ])
->render();
依赖注入示例
1. 首先将您的类注入到构造函数中
use Mojtabarks\ApiResponse\Responses\CustomResponse;
use Mojtabarks\ApiResponse\Responses\SuccessResponse;
use Mojtabarks\ApiResponse\Responses\FailureResponse;
__construct(
SuccessResponse $successResponse,
ErrorResponse $errorResponse,
CustomResponse $customResponse
) {
$this->successResponse
$this->errorResponse
$this->customResponse
}
2. 在您需要的地方使用注入的类!
$successResponse = $this->successResponse
// ->setCode(xxxx)
// ->setMessage("blah blah blah blah !")
// ->setSuccessResponse(--boolean !!!--)
// ->setResponseKey('data')
// ->setResponseValue(--array-- => [ // --------------> SET DATA METHOD IS ONLY AVAILABLE FOR SUCCESS RESPONSE
'projectName' => 'my awesome project',
.
.
.
])
->render();
$errorResponse = $this->errorResponse
// ->setCode(xxxx)
// ->setMessage("blah blah blah blah !")
// ->setSuccessResponse(--boolean !!!--)
// ->setResponseKey('error')
// ->setResponseValue(--array-- => [ // --------------> SET ERROR METHOD IS ONLY AVAILABLE FOR ERROR RESPONSE
'error text' => 'looks like something went wrong',
.
.
.
])
->render();
$customResponse = $this->customResponse
// ->setCode(XXXXX)
// ->setMessage('BLAH BLAH BLAH !')
// ->setSuccessStatus(BOOLEAN)
// ->setResponseKey('additional')
// ->setResponseValue([
// 'custom text' => 'custom message here',
.
.
.
//])
->render();
作者
- Mojtaba Rakhisi - 初始工作 - github
许可证
本项目采用 MIT 许可证 - 有关详细信息,请参阅 LICENSE.md 文件