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

注册用户示例

初次安装发布

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

概述

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

特点：

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

报错信息

composer update

概述

Elasticsearch服务提供了对 Elasticsearch 的完整操作支持，包括索引管理、文档CRUD、搜索查询以及批量操作等功能。

安装

use YouHuJun\Tool\App\Facades\V1\Es\EsFacade;

一、项目整体定位与技术基线

1. 项目名称：游鹄生态
2. 核心框架：Laravel 13 + PHP 8.3
3. 运行环境约束：【node.js22,imagick,redis,memcached,swoole,laravel-echo(websocket),supervisor,ES】
4. 核心自研组件：
   • laravel-fast-api-youhujun：API 快速开发核心组件=>youhu-base微服务(开源)
   • php-tool-youhujun：工具集（开源）
   • youhu：游鹄生态核心=>youhu微服务(私有不开源)
   • yohushop：游鹄生态电商=>youhushop微服务(私有不开源)
   • xuehu-xueer-youhujun：雪鹄城堡专属AI交互组件=>xuehu微服务(私有不开源,提供私有AI模型训练,对话交互)

概述

ShardHelperFacade 是游鹄生态系统中处理分库分表操作的核心门面服务，封装了分片路由、查询、缓存等所有底层逻辑，提供简洁易用的 API 接口。

特点：

• ✅ 支持单体和微服务架构平滑切换
• ✅ 自动适配 youhu/youhushop/youhujun 不同模块配置
• ✅ 内置 Redis Hash 缓存，提升查询性能
• ✅ 全表遍历支持提前退出优化
• ✅ 缓存自动失效机制

版本: v1
作者: youhujun & xueer
更新日期: 2026-03-04

📖 概述

ApiRequestFacade 是游鹄生态中用于微服务之间API通信的安全请求门面服务。它提供了跨服务的加密请求、认证和响应处理功能。

核心特点

• ✅ AES 加密通信：请求参数使用 AES 加密传输
• ✅ 服务认证管理：自动获取和管理各服务的认证信息
• ✅ 统一请求封装：统一的请求头格式和参数加密
• ✅ 日志记录：自动记录请求和响应日志
• ✅ 多服务支持：支持 youhu-base、shard-map、youhu、youhushop、xuehu 等服务

概述

密钥管理服务提供了安全密钥生成功能,支持自定义字符类型和长度,使用密码学安全的随机数生成器。

安装

use YouHuJun\Tool\App\Facades\V1\Utils\Sign\KeyManagerFacade;

概述

认证签名服务提供了 HMAC-SHA256 签名生成功能,用于API接口认证、数据完整性校验等场景。

安装

use YouHuJun\Tool\App\Facades\V1\Utils\Sign\AuthSignFacade;