jenky / laravel-api
Laravel API
7.2.0
2021-02-20 05:42 UTC
Requires
- php: ^7.2|^8.0
- illuminate/config: ^7.0|^8.0
- illuminate/contracts: ^7.0|^8.0
- illuminate/support: ^7.0|^8.0
Requires (Dev)
- orchestra/testbench: ^5.0|^6.0
- phpunit/phpunit: ^8.0|^9.0
Suggests
- spatie/laravel-fractal: An easy to use Fractal wrapper built for Laravel applications.
- spatie/laravel-query-builder: Easily build Eloquent queries from API requests.
- 7.x-dev
- dev-master / 7.x-dev
- 7.2.0
- 7.1.4
- 7.1.3
- 7.1.2
- 7.1.1
- 7.1.0
- 7.0.0
- 6.x-dev
- 6.4.2
- 6.4.1
- 6.4.0
- 6.3.3
- 6.3.2
- 6.3.1
- 6.3.0
- 6.2.0
- 6.1.1
- 6.1.0
- 6.0.1
- 6.0.0
- 5.x-dev
- 5.0.4
- 5.0.3
- 5.0.2
- 5.0.1
- 5.0.0
- 4.x-dev
- 4.0.0
- 3.x-dev
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- 2.x-dev
- 2.0.2
- 2.0.1
- 2.0.0
- 1.x-dev
- 1.0.7
- 1.0.6
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- dev-exception
- dev-route-macro
This package is auto-updated.
Last update: 2024-09-21 01:24:09 UTC
README
该包提供了一种优雅且简单的方式来定义API路由和格式化JSON错误响应。
安装
安装
您可以使用Composer将此包安装到您的Laravel项目中
$ composer require jenky/laravel-api
安装后,使用vendor:publish
Artisan命令发布其资源。
php artisan vendor:publish
或者
php artisan vendor:publish --provider="Jenky\LaravelAPI\ApiServiceProvider"
配置
发布Laravel API的资源后,其主配置文件位于config/api.php
。此配置文件允许您配置API路由和错误响应格式,每个配置选项都包含其目的的描述,因此请务必彻底研究此文件。
对于头版本,如果请求没有包含正确格式的
Accept
头,则将使用配置中的默认版本。
使用
错误响应
在构建API时处理错误可能会很痛苦。您无需手动构建错误响应,只需抛出异常,API将为您处理响应。只需将特性ExceptionResponse
添加到您的app/Exceptions/Handler
中,该包将自动捕获抛出的异常并将其转换为JSON表示。
<?php namespace App\Exceptions; use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler; use Jenky\LaravelAPI\Exception\ExceptionResponse; class Handler extends ExceptionHandler { use ExceptionResponse; }
您可以在
config/api.php
文件中更改默认错误响应格式。
变更日志
有关最近更改的更多信息,请参阅变更日志。
测试
$ composer test
贡献
安全
如果您发现任何与安全相关的问题,请通过电子邮件contact@lynh.me联系,而不是使用问题跟踪器。
鸣谢
许可证
MIT许可证(MIT)。有关更多信息,请参阅许可证文件。