提示
laravel-fast-api-youhujun底座提炼封装了契约层,用于实现通用基础功能和自由业务特殊业务逻辑的解耦
下面通过示例来说明如何处理使用
注册用户示例
提示
再次建议,如下面示例,针对该契约,业务内部传递参数使用AddUserHandlerContractDTO,避免使用数组传递参数,
这样数据结构更清晰,便于维护
2026/5/26大约 4 分钟
初次安装发布
php artisan vendor:publish --tag=init --force2026/5/26小于 1 分钟
一、项目整体定位与技术基线
- 项目名称：游鹄生态
- 核心框架：Laravel 13 + PHP 8.3
- 运行环境约束：【node.js22,imagick,redis,memcached,swoole,laravel-echo(websocket),supervisor,ES】
- 核心自研组件：
laravel-fast-api-youhujun：API 快速开发核心组件=>youhu-base微服务(开源)php-tool-youhujun：工具集（开源）youhu：游鹄生态核心=>youhu微服务(私有不开源)yohushop：游鹄生态电商=>youhushop微服务(私有不开源)xuehu-xueer-youhujun：雪鹄城堡专属AI交互组件=>xuehu微服务(私有不开源,提供私有AI模型训练,对话交互)
2026/3/6大约 7 分钟
概述
ShardHelperFacade 是游鹄生态系统中处理分库分表操作的核心门面服务，封装了分片路由、查询、缓存等所有底层逻辑，提供简洁易用的 API 接口。
特点：
- ✅ 支持单体和微服务架构平滑切换
- ✅ 自动适配 youhu/youhushop/youhujun 不同模块配置
- ✅ 内置 Redis Hash 缓存，提升查询性能
- ✅ 全表遍历支持提前退出优化
- ✅ 缓存自动失效机制
2026/3/6大约 5 分钟
注意
建议在实际开发中可以参照laravel-fast-api-youhujun,组件化开发自己的业务逻辑.这样便于后续维护以及扩展
组件包命令
自定义创建DTO
php artisan make:dto 路径/名称2026/1/12大约 7 分钟
- 本篇内容为权限篇,主要讲解如何使用laravel-fast-api-youhujun组件包的权限管理功能
注意
在我们实际项目开发过程中,尤其是现代项目大多是前后端分离,因此laravel自带的web登录验证和权限往往不适用.这个时候就需要自定义,因为这里所说的权限管理,包含着中间件,控制器,授权策略.所以放到此篇来讲
一登录验证
下面我们以后台api接口为例,先看登录验证
2026/1/12大约 3 分钟
如何使用laravel-fast-api-youhujun组件包的自定义验证规则
介绍:
背景:
- 虽然laravel自带了很多验证规则,并且验证不通过的时候返回422.然而在一些开发工具中例如 ApiPost 中 或者 uniapp中无法接收到验证不通过的信息
- 基于上述情况,解决策略是通过自定义验证规则,在验证不通过的时候,通过封装的验证规则异常,截断正常的response响应,直接抛出.
2026/1/12大约 2 分钟
主要介绍如何使用laravel-fast-api-youhujun组件包的事件
事件
注意
1选择用事件来处理,虽然看起来冗余繁琐,但是可以实现松耦合和高可扩展性
2因为新版采用的是mysql+es双写架构,因此如果es需要同步处理,建议创建对应事件,代码解耦同步处理.
3如果需要异步处理,可以创建job队列,可以根据情况,将Job队列或者放在Service业务逻辑层,或者放置在EventListener事件监听层处理
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 分钟