asiasea-ai/hf3

hf3核心依赖

v0.9.0 2026-06-25 14:38 UTC

Requires

• php: >=8.5
• ext-bcmath: *
• ext-curl: *
• ext-imagick: *
• ext-json: *
• ext-libxml: *
• ext-mbstring: *
• ext-openssl: *
• ext-pdo: *
• ext-posix: *
• ext-simplexml: *
• ext-zip: *
• alibabacloud/captcha-20230305: ~1.1.3
• alibabacloud/darabonba-openapi: ~0.2.17
• alibabacloud/devops-20210625: ~5.0.3
• alibabacloud/dms-enterprise-20181101: ~3.0.0
• alibabacloud/dypnsapi-20170525: ~2.0.0
• alibabacloud/dysmsapi-20170525: ~4.5.1
• alibabacloud/dyvmsapi-20170525: ~5.5.0
• alibabacloud/imageenhan-20190930: ~2.0.0
• alibabacloud/imageseg-20191230: ~4.0.1
• alibabacloud/quickbi-public-20220101: ~1.16.0
• alibabacloud/sdk: ~1.8.2343
• alibabacloud/sts-20150401: ~1.2.0
• alibabacloud/tea-utils: ~0.2.22
• bepsvpt/secure-headers: ~9.1.0
• casbin/casbin: ~4.2.0
• casbin/database-adapter: ~2.1.0
• casbin/swoole-redis-watcher: ~2.0.0
• chillerlan/php-qrcode: ~6.0.1
• cium/weworkapi: ~1.0.1
• doctrine/sql-formatter: ~1.5.4
• firebase/php-jwt: ~7.1.0
• flc/dysms: ~1.0.3
• gai871013/ip-location: ~1.1.251204
• hyperf/amqp: ~3.2.0
• hyperf/async-queue: ~3.2.0
• hyperf/cache: ~3.2.0
• hyperf/command: ~3.2.0
• hyperf/config: ~3.2.0
• hyperf/constants: ~3.2.0
• hyperf/crontab: ~3.2.0
• hyperf/database: ~3.2.0
• hyperf/db-connection: ~3.2.0
• hyperf/engine: ~2.15.0
• hyperf/filesystem: ~3.2.0
• hyperf/flysystem-oss: ^1.4
• hyperf/framework: ~3.2.0
• hyperf/grpc-client: ~3.2.0
• hyperf/grpc-server: ~3.2.0
• hyperf/guzzle: ~3.2.0
• hyperf/http-server: ~3.2.0
• hyperf/json-rpc: ~3.2.0
• hyperf/kafka: ~3.2.0
• hyperf/logger: ~3.2.0
• hyperf/memory: ~3.2.0
• hyperf/metric: ~3.2.0
• hyperf/process: ~3.2.0
• hyperf/rate-limit: ~3.2.0
• hyperf/redis: ~3.2.0
• hyperf/rpc-client: ~3.2.0
• hyperf/rpc-server: ~3.2.0
• hyperf/snowflake: ~3.2.0
• hyperf/tracer: ~3.2.0
• hyperf/translation: ~3.2.0
• hyperf/validation: ~3.2.0
• monolog/monolog: ~3.10.0
• nesbot/carbon: ~3.11.4
• nikic/fast-route: ~1.3.0
• phpoffice/phpspreadsheet: ~5.8.0
• phpoffice/phpword: ~1.4.0
• picqer/php-barcode-generator: ~3.2.4
• pimple/pimple: ~3.6.2
• promphp/prometheus_client_php: ~2.15.1
• psr/log: ~3.0.2
• psr/simple-cache: ~3.0.0
• qcloud_sts/qcloud-sts-sdk: ~3.0.12
• ritaswc/zx-ip-address: ~2.0.68
• shieldon/shieldon: ~2.1.1
• smalot/pdfparser: ~2.12.5
• smarty/smarty: ~5.8.0
• symfony/config: ~8.1.0
• symfony/dotenv: ~8.1.0
• symfony/mailer: ~8.1.0
• symfony/uid: ~8.1.0
• symfony/validator: ~8.1.0
• tecnickcom/tcpdf: ~6.11.3
• victorybiz/geoip-location: ~1.1.2

Suggests

• ext-pdo_mysql: Required to use MySQL Client.
• ext-redis: Required to use Redis Client.

MIT

• asiasea-ai

• framework
• php
• coroutine
• Microservice
• swoole
• hyperf

Published on Packagist.org on 2026-06-25 15:15 UTC

README

基于 Hyperf 3.2 / Swoole 协程的微服务基础库。

Hf3\ 命名空间下的框架级基础设施，为基于 Hyperf 3.2（Swoole 协程，PHP 8.5+）的微服务提供统一的分层骨架、鉴权、限流、异常体系与文档生成能力。

环境要求

• PHP >= 8.5
• Swoole / Hyperf 3.2 运行时

安装

composer require asiasea-ai/hf3

核心能力

模块	说明
Spl / Dao / Service / Gateway / Model	Controller → Gateway → Service → Dao → Model 分层基类，DTO/VO 基类（SplDto / SplVo）
Middleware	核心中间件：Hf3Core（响应信封包装）、Auth（JWT 鉴权）、RateLimit（限流）、Trace（链路追踪）
Identity	JWT 签发与校验（HS256）
Throwable	统一异常体系、错误码映射、PSR 日志桥接
Db	表结构内省（物理表名 → 字段类型字典）、SQL 构建工具
Doc	路由收集与 OpenAPI 文档自动生成
Policy	基于 Casbin 的访问控制网关
Whitelist	路由白名单与 CIDR 匹配
Curl	协程 HTTP / RPC 客户端
Crontab / Process	定时任务与自定义进程基类
Helper	协程、环境变量、Redis、身份等全局辅助函数

响应信封

由 Hf3Core 中间件自动包装：

{ "code": 100000, "result": { "data": {} }, "msg": "执行成功", "trace_id": "...", "process_time": "..." }

许可协议

MIT