PHPackages                             hyperf-admin/hyperf-admin - 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. hyperf-admin/hyperf-admin

ActiveLibrary

hyperf-admin/hyperf-admin
=========================

hyperf-admin

v0.3.2(4y ago)4283.0k↓100%74[7 issues](https://github.com/hyperf-admin/hyperf-admin/issues)PHPPHP &gt;=7.3

Since Nov 23Pushed 2y ago9 watchersCompare

[ Source](https://github.com/hyperf-admin/hyperf-admin)[ Packagist](https://packagist.org/packages/hyperf-admin/hyperf-admin)[ RSS](/packages/hyperf-admin-hyperf-admin/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (27)Versions (9)Used By (0)

`HyperfAdmin`是前后端分离的后台管理系统, 前端基于`vue`的 `vue-admin-template`, 针对后台业务`列表`, `表单`等场景封装了大量业务组件, 后端基于`hyperf`实现, 整体思路是后端定义页面渲染规则, 前端页面渲染时首先拉取配置, 然后组件根据具体配置完成页面渲染, 方便开发者仅做少量的配置工作就能完成常见的`CRUD`工作, 同时支持自定义组件和自定义页面, 以开发更为复杂的页面.

[详细文档](https://hyperf-admin.github.io/hyperf-admin/)

[演示站点](http://hyperf-admin.daodao.run/) `用户名`: daodao, `密码`: a1a1a1

> 演示站点部署在`亚马逊免费主机`, 国内访问可能会慢

[![HyperfAdmin架构](https://camo.githubusercontent.com/2a796bfd088df3e8e3302ec2f653b94a9ff3cdf65aad7cace2521c23a676f09a/68747470733a2f2f67697465652e636f6d2f64616f64616f39372f61737365742f7261772f6d61737465722f755069632f734a614a74692e706e67)](https://camo.githubusercontent.com/2a796bfd088df3e8e3302ec2f653b94a9ff3cdf65aad7cace2521c23a676f09a/68747470733a2f2f67697465652e636f6d2f64616f64616f39372f61737365742f7261772f6d61737465722f755069632f734a614a74692e706e67)

前端为`vue multiple page`多页模式, 可以按模块打包, 默认包含两个模块`default` 默认模块, `system`系统管理模块, 绝大部分业务组件在`src/components`目录

后端为`composer包`模式, 目前包含组件

- 基础组件
    - `composer require hyperf-admin/base-utils` hyperf-admin的基础组件包, 脚手架主要功能封装
    - `composer require hyperf-admin/validation` 参数验证包, 对规则和参数提示做了较多优化
    - `composer require hyperf-admin/alert-manager` 企微/钉钉机器人报警包
    - `composer require hyperf-admin/rule-engine` 规则引擎
    - `composer require hyperf-admin/event-bus` mq/nsq/kafka消息派发器
    - `composer require hyperf-admin/process-manager` 进程管理组件
- 业务组件 (业务组件为包含特定业务功能的包)
    - `composer require hyperf-admin/admin` 系统管理业务包
    - `composer require hyperf-admin/dev-tools` 开发者工具包, 主要是代码生成, 辅助开发
    - `composer require hyperf-admin/cron-center` 定时任务管理, 后台化管理任务
    - `composer require hyperf-admin/data-focus` 数据面板模块, 帮你快速制作数据大盘

前端的安装
-----

[](#前端的安装)

```
# 环境依赖
# 1.  node ^v11.2.0 https://nodejs.org/zh-cn/download/
# 2.  npm ^6.4.1
git clone https://github.com/hyperf-admin/hyperf-admin-frontend.git
cd hyperf-admin-frontend
npm i
npm run dev
```

请根据实际情况修改`vue.config.js`中的代理 `proxy.target`地址

```
# 打包
npm run build:prod
npm run build:test
```

后端的安装
-----

[](#后端的安装)

#### 1. 初始化一个`hypef`项目

[](#1-初始化一个hypef项目)

```
# 环境依赖 php ^7.2 composer swoole
composer create-project hyperf/hyperf-skeleton hyperf-admin
cd hyperf-admin
```

#### 2. 移除`hyperf-skeleton`中的日志配置, 因为 `admin` 底层已配置

[](#2-移除hyperf-skeleton中的日志配置-因为-admin-底层已配置)

```
rm config/autoload/logger.php
```

#### 3. 安装`hyperf-admin`的依赖DB信息

[](#3-安装hyperf-admin的依赖db信息)

hyperf-admin 为分包的模式, 此处引入的是完整仓库, 实际项目请按需引入

全部的`mysql` 表结构及及基础数据详见 [demo/db](https://github.com/hyperf-admin/hyperf-admin-demo/tree/master/docker/db)

#### 4. 修改项目`.env`

[](#4-修改项目env)

```
APP_NAME=hyperf-admin
ENV=dev

# Redis链接信息
REDIS_HOST=localhost
REDIS_AUTH=(null)
REDIS_PORT=6379
REDIS_DB=0

# hyperf-admin 依赖的核心db
HYPERF_ADMIN_DB_HOST=localhost
HYPERF_ADMIN_DB_PORT=3306
HYPERF_ADMIN_DB_NAME=hyperf_admin
HYPERF_ADMIN_DB_USER=root
HYPERF_ADMIN_DB_PWD=root

LOCAL_DB_HOST=localhost
```

#### 5. 安装`hyperf-admin`扩展包

[](#5-安装hyperf-admin扩展包)

```
composer require hyperf-admin/hyperf-admin
```

hyperf-admin 为分包模式, 实际应用中请根据情况安装

#### 6. 初始化`validation`的依赖文档

[](#6-初始化validation的依赖文档)

```
php bin/hyperf.php vendor:publish hyperf/translation
php bin/hyperf.php vendor:publish hyperf/validation
```

#### 7. 设置用户密码的加密`key`, 配置节点`password.salt`

[](#7-设置用户密码的加密key-配置节点passwordsalt)

```
// config/config.php

'password' => [
    'salt' => env('HYPERF_ADMIN_PWD_SALT', 'c093d70f088499c3a837cae00c042f14'), // 用 md5(time()) 获取 salt
```

#### 8. 启动

[](#8-启动)

```
# 启动 热重启参考 https://github.com/daodao97/hyperf-watch
composer watch
```

nginx配置
-------

[](#nginx配置)

```
upstream backend {
    server 127.0.0.1:9511;
}

server {
    listen 80;
    server_name hyperf-admin.com; # 设置自己的 domain
    index index.html;
    root /opt/www/hyperf-admin-front/dist;
    access_log /usr/local/var/log/nginx/hyperf-admin.access.log;
    error_log /usr/local/var/log/nginx/hyperf-admin.error.log;

    location ~ /api/(.*) {
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host hyperf-admin.com;
        proxy_pass http://backend/$1$is_args$args;
    }

    location / {
        root /opt/www/hyperf-admin-front/dist/default;
        index index.html;
    }

    location ~ /(.*) {
        set $module $1;
        if ($module ~* '^$') {
            set $module default;
        }
        try_files $uri $uri/ /$module/index.html;
    }
}
```

浏览器打开  即可访问

默认账号 `daodao`, 密码 `a1a1a1`

###  Health Score

34

—

LowBetter than 79% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity41

Moderate usage in the ecosystem

Community27

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 76% 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

Every ~40 days

Recently: every ~33 days

Total

8

Last Release

1667d ago

PHP version history (2 changes)0.1.0PHP &gt;=7.2

0.2.0PHP &gt;=7.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/e55b41d178c416c46f36c652ef67893ff9d31a97e88084db276966ae0dd5d370?d=identicon)[daodao97](/maintainers/daodao97)

---

Top Contributors

[![daodao97](https://avatars.githubusercontent.com/u/15009280?v=4)](https://github.com/daodao97 "daodao97 (95 commits)")[![jyiL](https://avatars.githubusercontent.com/u/19472992?v=4)](https://github.com/jyiL "jyiL (7 commits)")[![feraner](https://avatars.githubusercontent.com/u/12883116?v=4)](https://github.com/feraner "feraner (4 commits)")[![DongyunLee](https://avatars.githubusercontent.com/u/22876282?v=4)](https://github.com/DongyunLee "DongyunLee (3 commits)")[![wxfjamdc](https://avatars.githubusercontent.com/u/15729498?v=4)](https://github.com/wxfjamdc "wxfjamdc (3 commits)")[![itxiao6](https://avatars.githubusercontent.com/u/20547806?v=4)](https://github.com/itxiao6 "itxiao6 (2 commits)")[![jonny77](https://avatars.githubusercontent.com/u/1962170?v=4)](https://github.com/jonny77 "jonny77 (2 commits)")[![lujihong](https://avatars.githubusercontent.com/u/31462984?v=4)](https://github.com/lujihong "lujihong (2 commits)")[![sy-records](https://avatars.githubusercontent.com/u/33931153?v=4)](https://github.com/sy-records "sy-records (2 commits)")[![bbc-123](https://avatars.githubusercontent.com/u/6288654?v=4)](https://github.com/bbc-123 "bbc-123 (1 commits)")[![daijunooo](https://avatars.githubusercontent.com/u/15965716?v=4)](https://github.com/daijunooo "daijunooo (1 commits)")[![daydaygo](https://avatars.githubusercontent.com/u/3986303?v=4)](https://github.com/daydaygo "daydaygo (1 commits)")[![ban-shi-yi-sheng](https://avatars.githubusercontent.com/u/28346321?v=4)](https://github.com/ban-shi-yi-sheng "ban-shi-yi-sheng (1 commits)")[![jobinli](https://avatars.githubusercontent.com/u/59111601?v=4)](https://github.com/jobinli "jobinli (1 commits)")

---

Tags

adminhyperfhyperf-adminswoolevuevue-admin

### Embed Badge

![Health badge](/badges/hyperf-admin-hyperf-admin/health.svg)

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

###  Alternatives

[xmo/mine-core

mineadmin core package

1683.1k1](/packages/xmo-mine-core)[mineadmin/mineadmin

Quickly build a background management system for web applications

1.2k2.0k](/packages/mineadmin-mineadmin)

PHPackages © 2026

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