游鹄君博客

PHP重回巅峰!基于 Laravel13 打造的新一代企业级 API 框架,youhujun 开源生态全家桶2.0面世

项目简介

laravel-fast-api-youhujun 2.0版本 是基于 Laravel13 构建的企业级全栈快速开发底座，配套 vue3-element-admin-youhujun 后台管理端、uniappx-youhujun 移动端，形成一套完整、规范、可商用的全栈解决方案。

项目旨在解决市面多数开源项目架构混乱、耦合度高、难以长期迭代、承载能力弱等痛点。主打渐进式架构、高安全、高解耦、强类型规范、亿级扩容能力，彻底打破 PHP 仅适用于小型项目的刻板印象，可平稳支撑从初创项目到亿级流量的大型商业系统。

游鹄君2026/5/28大约 6 分钟

契约篇

提示

laravel-fast-api-youhujun底座提炼封装了契约层,用于实现通用基础功能和自由业务特殊业务逻辑的解耦

下面通过示例来说明如何处理使用

注册用户示例

提示

再次建议,如下面示例,针对该契约,业务内部传递参数使用AddUserHandlerContractDTO,避免使用数组传递参数,
这样数据结构更清晰,便于维护

游鹄君2026/5/26大约 4 分钟

特别发布篇

初次安装发布

php artisan vendor:publish --tag=init --force

游鹄君2026/5/26小于 1 分钟

EsQueryFacade 使用手册

概述

EsQueryFacade 是游鹄生态系统中 Elasticsearch 查询的封装门面，提供 Laravel 风格的链式查询语法，自动将常见查询条件转换为 ES DSL 语法。

特点：

✅ 链式调用，语法接近 Laravel Query Builder
✅ 自动转换 =、>、>=、<、<=、!=、like、in、between、null/notNull 等常用操作符
✅ 支持 orWhere、orWhereLike 逻辑查询
✅ 自动区分 keyword/text 字段，智能添加 .keyword 后缀
✅ 支持分页（返回 Laravel 标准 LengthAwarePaginator）和普通查询
✅ 支持排序和计数统计
✅ ES 连接自动初始化

游鹄君2026/5/26大约 5 分钟

vue3的基础使用(三)

事件总线-非父子组件通信

安装

pnpm install mitt

游鹄君2026/5/16大约 1 分钟

TypeScript

游鹄君2026/5/13小于 1 分钟

typescript基础

游鹄君2026/5/13小于 1 分钟

typescript基础

类型声明,限定和断言

类型推断

下面这种示例是ts自动推断

let str = '123'
str = 123 // 类型错误：不能将类型"number"分配给类型"string"

游鹄君2026/5/13大约 1 分钟

vue3的基础使用(一)

ref()和reactive()

ref()

在组合式 API 中，推荐使用 ref() 函数来声明响应式状态：

可以看出，ref() 函数返回一个可变的响应式 ref 对象，它包含一个名为 value 的属性，我们可以通过 .value 访问其中的值：

//初始化加载样式
const loading = ref(true);
//是否开启弹窗
const dialogVisible = ref(false);
//弹窗标题
const dialogTitle = ref("");

//添加用户
const handleAddUser = () => {
  dialogTitle.value = "添加顶级用户";
  dialogType.value = 10;
  dialogVisible.value = true;
};

游鹄君2026/5/13大约 2 分钟

vue3的基础使用(二)

计算属性,defineModel(),watch()侦听器

示例用户列表的分页(父组件)

下面代码父组件定义计算属性和侦听器

src\pages\laravel-fast-api\v1\user\user\userList\index.vue

<!-- 分页区开始 -->
<template #paginate>
<div>
	<YhPaginate
	v-model:current-page="currentPage"
	v-model:page-size="pageSize"
	v-model:total="total"
	:page-sizes="[5, 10, 20, 30, 40, 50,100]"
	/>
</div>
</template>
<!-- 分页区结束 -->

<script setup lang="ts">
//搜索查询条件
const where = ref({
  //查找内容
  find: "",
  //查找下标
  findSelectIndex: 0,
  //时间范围
  timeRange: [],
  //是否禁用
  switch: null,
  //排序方式
  sortType: 2,
  // 0 不导出 1导出
  isExport: 0,
  // 导出类型 1本页 2全部
  exportType: 1,
  // 分页
  currentPage: 1,
  //每页条数
  pageSize: 10,
  //数据总数
  total: 0,
});
//将分页处理定义为计算属性
//当前页
const currentPage = computed({
  get() {
    return where.value.currentPage;
  },
  set(newValue) {
    where.value.currentPage = newValue;
  },
});
//页面条数
const pageSize = computed({
  get() {
    return where.value.pageSize;
  },
  set(newValue) {
    where.value.pageSize = newValue;
  },
});
//计算总数
const total = computed({
  get() {
    return where.value.total;
  },
  set(newValue) {
    where.value.total = newValue;
  },
});

//侦听分页变化
watch([currentPage, pageSize], () => 
{
	getUserList()
})
</script>

游鹄君2026/5/13大约 6 分钟