jafar690 / laravel-api-jwt-starter
Laravel API 模板,带 jwt 认证
Requires
- php: >=5.6.4
- barryvdh/laravel-cors: ^0.9.2
- dingo/api: 1.0.*@dev
- laravel/framework: 5.4.*
- laravel/tinker: ~1.0
- tymon/jwt-auth: 0.5.*
Requires (Dev)
- fzaninotto/faker: ~1.4
- mockery/mockery: 0.9.*
- phpunit/phpunit: ~5.7
This package is not auto-updated.
Last update: 2024-09-29 02:50:31 UTC
README
Laravel API JWT Starter
Laravel API JWT Starter 是一个可以在几秒钟内构建您的第一个 API 的 "启动工具包"。它基于 larave 5.4!
它建立在三个包之上
- JWT-Auth - tymondesigns/jwt-auth
- Dingo API - dingo/api
- Laravel-CORS barryvdh/laravel-cors
我所做的是这三个包的集成和一些认证和凭证恢复方法的配置。
安装
- 运行
composer create-project jafar690/laravel-api-jwt-starter yourProjectName; - 喝杯咖啡,这里没有什么可做的;
一旦项目创建过程完成,运行 php artisan migrate 命令来安装所需的表。
主要功能
现成的认证控制器
您不必再担心认证和密码恢复了。我在 App\Http\Controllers\Auth\ 中创建了四个控制器,您可以在其中找到执行这些操作。
每个控制器在 routes/api.php 文件中都有一个已设置的路线
POST api/auth/login,用于登录并获取您的访问令牌;POST api/auth/register,用于将新用户添加到您的应用程序中;POST api/auth/recovery,用于恢复您的凭证;POST api/auth/reset,在恢复后重置您的密码;
单独的路线文件
所有 API 路由都可以在 routes/api.php 文件中找到。这也遵循 Laravel 5.3 的约定。
在创建项目命令时
每次您从这个存储库创建新项目时,都会执行 php artisan jwt:generate 命令。
配置
这个模板基于 dingo/api 和 tymondesigns/jwt-auth 包。因此,您可以在这里 和 这里 找到有关配置的许多信息。
我在 config/api.php 中的 DINGO API 配置文件中做了一些小的修改
sign_up.release_token:如果希望在注册过程后立即发布令牌,将其设置为true;reset_password.release_token:如果希望在密码重置过程后立即发布令牌,将其设置为true;
我还为每个操作(登录、注册、恢复和重置)创建了表单请求。请随时根据您的需求进行自定义。
创建端点
您可以以使用单个 dingo/api 包的方式创建端点。您可以阅读其文档以获取详细信息。毕竟,这只是一个模板! :)
然而,我在 routes/api.php 文件中添加了一些示例路由,以便您立即有一个想法。
跨源资源共享
如果您想为特定路由或路由组启用 CORS,只需在这些路由上使用 cors 中间件即可。
多亏了 barryvdh/laravel-cors 包,您可以轻松处理 CORS。只需检查此页面的文档以获取更多信息。
反馈
如有任何问题或反馈,请随时通过以下邮箱发送给我:kgakami690@gmail.com