注意
建议在实际开发中可以参照laravel-fast-api,组件化开发自己的业务逻辑.这样便于后续维护以及扩展
组件包命令
自定义门面代理和门面服务命令
生成门面代理以及门面服务(Generate a facade agent and a facade service)
php artisan call:facade 路径/名称2026/1/12大约 4 分钟
- 本篇内容为权限篇,主要讲解如何使用laravel-fast-api组件包的权限管理功能
注意
在我们实际项目开发过程中,尤其是现代项目大多是前后端分离,因此laravel自带的web登录验证和权限往往不适用.这个时候就需要自定义,因为这里所说的权限管理,包含着中间件,控制器,授权策略.所以放到此篇来讲
一登录验证
下面我们以后台api接口为例,先看登录验证
2026/1/12大约 3 分钟
如何使用laravel-fast-api-youhujun组件包的自定义验证规则
介绍:
背景:
- 虽然laravel自带了很多验证规则,并且验证不通过的时候返回422.然而在一些开发工具中例如 ApiPost 中 或者 uniapp中无法接收到验证不通过的信息
- 基于上述情况,解决策略是通过自定义验证规则,在验证不通过的时候,通过封装的验证规则异常,截断正常的response响应,直接抛出.
2026/1/12大约 2 分钟
主要介绍如何使用laravel-fast-api-youhujun组件包的事件
事件
注意
选择用事件来处理,可以简单快速复用代码逻辑.便于后续代码的维护
通用事件
通用事件用户注册 CommonUserRegisterEvent
前提引用CommonUserRegisterEvent
use App\Events\Common\V1\User\User\CommonUserRegisterEvent;2026/1/12小于 1 分钟
laravel-fast-api 分别在 分别封装了后台和前端以及公共和验证规则的异常处理
- App\Exceptions\Admin\CommonException.php 后台异常处理
- App\Exceptions\Phone\CommonException.php 用户异常处理
- App\Exceptions\Common\CommonException.php 通用异常处理
- App\Exceptions\Common\RuleException.php 表单验证异常处理
提示
为了方便快速定位异常位置,统一在自定义配置文件处,统一定义异常及事件码.同时为了方便维护,根据业务不同业务逻辑和模块,分开定义异常和事件码
2026/1/12大约 1 分钟
提示
laravel-fast-api预置了基础数据的填充
填充命令
php artisan db:seed --class=DatabaseSeeder2026/1/12小于 1 分钟
安装
yum install -y supervisor2026/1/12大约 2 分钟
提示
laravel手册有详细的介绍,这里只是基于laravel做的快速使用示例.
Laravel 的命令行调度器允许在 Laravel 中清晰明了地定义命令调度。在使用这个任务调度器时，只需要在服务器上创建单个 Cron 入口。任务调度在 app/Console/Kernel.php 的 schedule 方法中进行定义.
前提
提示
laravel12的调度任务已经放置到routes/console.php和bootstrap/app.php中
2026/1/12大约 1 分钟
门面定义划分方式
-
门面定义的划分方式一般是在组件包内 版本\后端或者前端\功能模块\后端或前端+功能模块+Facade
-
除此之外有一些无论是前端或者后台都会频繁使用到的公共业务逻辑,就会提炼封装到Common目录下,叫做
通用门面 -
最后一种是与业务逻辑代码无关的涉及到例如微信登录,短信验证码,二维码等第三方功能,这种都提炼封装在Pub目录下,原则上要与业务逻辑代码解耦,叫做
公共门面
提示
现在已经有php-tool-youhujun 组件包,提炼了公共门面,可以直接使用,所以对于公共门面的封装需要谨慎,如非必要可以不封装公共门面.
2026/1/12大约 2 分钟
提示
通用门面是根据业务需要提炼封装的,后续会持续补充完善,这里介绍重点和常用的通用门面
通用用户门面
通用用户门面 CommonUserFacade
前提引用CommonUserFacade
use App\Facades\Common\V1\User\User\CommonUserFacade;2026/1/12大约 1 分钟