PHPackages                             link-cloud/fast-hyperf - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. link-cloud/fast-hyperf

ActiveLibrary[Framework](/categories/framework)

link-cloud/fast-hyperf
======================

LinkCloud Fast Hyperf

v1.0.x-dev(1y ago)241.2k3[1 PRs](https://github.com/LinkedDestiny/fast-hyperf/pulls)1Apache-2.0PHPPHP >=8.0

Since Nov 17Pushed 1y ago3 watchersCompare

[ Source](https://github.com/LinkedDestiny/fast-hyperf)[ Packagist](https://packagist.org/packages/link-cloud/fast-hyperf)[ RSS](/packages/link-cloud-fast-hyperf/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (15)Versions (2)Used By (1)

Fast Hyperf
===========

[](#fast-hyperf)

基于Hyperf框架二次封装的快速开发脚手架

```
说明：
本项目封装沿用了Java风格的对象风格，不喜者，请绕路

```

安装方式
----

[](#安装方式)

普通安装

```
composer requrie link-cloud/fast-hyperf

```

模板安装

```
composer create-project link-cloud/fast-hyperf-demo demo

```

模板创建

常用命令
----

[](#常用命令)

### 快速生成业务代码

[](#快速生成业务代码)

```
php bin/hyperf.php gen:code -p /app -P default -a /api/v1

```

参数名说明示例-p代码路径-p /app-P数据库连接池名称-P default-a接口路径前缀-a /api/v1-t模块名称，如果需要分模块，设置此参数 (比如小程序接口和管理后台接口)-t api -t admin`此命令依赖`config/autoload/generate.php`配置文件，可参考demo项目`

生成的代码结构说明：

目录名称说明Application/Controller接口控制器目录Constants静态枚举类目录，建议再创建Status,Enums,Types三个子目录Constants/Errors错误码目录Config生成器配置目录，可在此目录配置需要生成的实体类以及接口类Entity接口实体类目录Logic逻辑层目录，业务代码在此编写 ，可对外暴露提供RPC接口，实现微服务调用Model数据库实体类目录Repository/Dao/ContractsDAO接口定义Repository/Dao/MySQLDAO的MySQL访问实现Service服务层目录，基础的单表服务，可对外暴露提供RPC接口，实现微服务调用，也可以在此层定义缓存访问等### 多语言翻译文件生成

[](#多语言翻译文件生成)

可以将错误码和枚举类的翻译文件自动生成

```
php bin/hyperf.php translate:gen

```

`此命令依赖`config/autoload/generate.php`配置文件，可参考demo项目`

常用组件
----

[](#常用组件)

### 枚举类

[](#枚举类)

基于 `marc-mabe/php-enum` 封装的枚举类对象，方便枚举类传递和定义，再也不用到处问代码里的1234是什么意思了 枚举类定义

```
use LinkCloud\Fast\Hyperf\Annotations\EnumMessage;
use LinkCloud\Fast\Hyperf\Framework\Entity\ErrorCode;

/**
 * @method static BaseStatus NORMAL()
 * @method static BaseStatus FROZEN()
 */
class BaseStatus extends BaseEnum
{
    #[EnumMessage(message: '正常')]
    public const NORMAL = 1;

    #[EnumMessage(message: '冻结')]
    public const FROZEN = 2;
}
```

使用：

```
$status = BaseStatus::NORMAL();
var_dump($status->getValue()); // 获取数字值
var_dump($status->getMessage()); // 获取关联信息

// 函数定义时可指定类型
function judge(BaseStatus $status)
{

}

judge(BaseStatus::NORMAL()); // 函数传参

// 类的成员变量定义
class Object
{
    protected BaseStatus $status;
}
```

### 基本对象

[](#基本对象)

框架定义了`BaseObject`对象，用于方便在数组和对象之间互相转换

定义一个对象

```
use LinkCloud\Fast\Hyperf\Common\BaseObject;
use LinkCloud\Fast\Hyperf\Annotations\ArrayType;

class User extends BaseObject
{
    public string $userId;

    public string $userName;

    public UserStatus $status;

    #[ArrayType(valueType: UserBalance::class)]
    public array $balances;
}

class UserBalance extends BaseObject
{
    public string $amount;
}

// 从数组转换过来
$user = new User([
    'user_id' => 1,
    'user_name' => 'account',
    'status' => 1,
    'balances' => [
        ['amount' => '100'],
        ['amount' => '200'],
    ],
]);

var_dump($user->userId);
var_dump($user->balances);

// 转回数组
var_dump($user->toArray());
```

`ArrayType` 是一个新的注解，当需要声明一个指定类型的数组时，可以使用此注解定义

```
    #[ArrayType(valueType: UserBalance::class)]
    public array $balances;
```

### Swagger接口文档

[](#swagger接口文档)

服务启动后，可直接访问 `http://127.0.0.1:9501/swagger` 查看swagger文档页面。 可通过配置文件关闭此功能

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance44

Moderate activity, may be stable

Popularity25

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

547d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/235d302f1bf927ede884773311f8fd819bf736a9641babe81a5cd67fc1468768?d=identicon)[LinkedDestiny](/maintainers/LinkedDestiny)

---

Top Contributors

[![Dederi-Group](https://avatars.githubusercontent.com/u/162277504?v=4)](https://github.com/Dederi-Group "Dederi-Group (8 commits)")[![Dannieeth](https://avatars.githubusercontent.com/u/142962463?v=4)](https://github.com/Dannieeth "Dannieeth (1 commits)")[![LinkedDestiny](https://avatars.githubusercontent.com/u/5689061?v=4)](https://github.com/LinkedDestiny "LinkedDestiny (1 commits)")

### Embed Badge

![Health badge](/badges/link-cloud-fast-hyperf/health.svg)

```
[![Health](https://phpackages.com/badges/link-cloud-fast-hyperf/health.svg)](https://phpackages.com/packages/link-cloud-fast-hyperf)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)