tmkzmu / fortress
处理Laravel应用程序中的API的基本认证操作
v1.0.5
2022-04-21 13:03 UTC
Requires (Dev)
- phpunit/phpunit: ^9.5
README
此软件包提供了一种简单优雅的方式来创建Laravel应用程序注册和授权API所需的所有必要端点。
- 用户注册
- 登录
- 电子邮件验证
- 更新
- 密码重置
安装
从composer安装包
composer require tmkzmu/fortress
发布操作
php artisan vendor:publish --provider="Tmkzmu\Fortress\FortressServiceProvider"
此命令将所有操作类发布到 app\Actions\Fortress 文件夹。有几个操作
注册登录电子邮件验证密码重置更新密码更新个人资料
它们都有自己的默认逻辑。其余(端点、控制器、迁移)由软件包提供。
运行迁移
执行 php artisan migrate 以运行迁移。
添加特质
如果您想使用电子邮件验证,请将 Tmkzmu\Fortress\Traits\VerifyEmailTrait 特质和Laravel的 MustVerifyEmail 接口添加到您的 User 模型。
配置
配置文件(fortress.php)存储在 config 文件夹中。
有几个配置
features- 开启的操作数组。controller_class- 处理所有请求的默认控制器。如果您想使用自己的控制器,请在此处设置类名并实现接口Tmkzmu\Fortress\Controllers\FortressControllerInterface。routes- 路由的几个配置prefix- 定义路由的前缀(例如api/v1)middleware- 所有路由的中间件auth_middleware- 仅受保护端点的中间件名称throttle- 对端点请求进行节流登录电子邮件验证重置密码
paths- 操作的端点路径
认证verification_expire- 邮件验证URL的过期时间
emails- 邮件端点配置callback_url- 邮件操作的URLemail_verification_prefix- 电子邮件验证端点的路径password_reset_prefix- 密码重置端点的路径
测试
所有端点都已测试。您可以通过扩展测试类 Tmkzmu\Fortress\Feature\FortressTest 来使用软件包测试。
许可证
MIT