PHPackages                             gxcok/yii2-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. [Authentication & Authorization](/categories/authentication)
4. /
5. gxcok/yii2-admin

ActiveYii2-extension[Authentication & Authorization](/categories/authentication)

gxcok/yii2-admin
================

RBAC Auth manager for Yii2

v1.0.0(11mo ago)03BSD-3-ClauseJavaScript

Since Jul 23Pushed 11mo agoCompare

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

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Yii2 Ace Admin 后台扩展模块
=====================

[](#yii2-ace-admin-后台扩展模块)

作者博客
----

[](#作者博客)

[作者博客](https://www.faxwo.com/)

简介
--

[](#简介)

使用的 [ace admin](http://ace.jeka.by/) 前端框架, 为`yii2`开发的一个后台模块; 对于二次开发比较方便，包含了基本的后台功能

功能特性
----

[](#功能特性)

- 包含基本的后台功能

    - 管理员管理: 登录、登出、修改密码等
    - 菜单管理: 可视化动态菜单、根据权限显示菜单
    - 权限管理: 角色、权限、用户的管理
- 使用`yii2`自带的`RBAC`权限管理
- 对于二次开发比较方便

    - 定义基本控制器(封装了基本的`CURD`操作), 后续开发基于基础控制器继承修改
    - 拥有代码生成功能(类似于`gii`), 可视化生成代码模板, 简单操作即可生成 控制器`controller`、模型`model`, 视图`views`文件，提高开发效率

安装
--

[](#安装)

### 安装要求

[](#安装要求)

- PHP >= 7.4
- MySQL

### 全新项目安装

[](#全新项目安装)

先使用命令安装yii2-app-advanced

```
composer create-project --prefer-dist yiisoft/yii2-app-advanced yii2-advanced

```

再安装

```
composer require gxcok/yii2-admin

```

### 在已有项目中安装

[](#在已有项目中安装)

使用 `composer` 下载包文件

```
composer require gxcok/yii2-admin

```

### 配置模块信息

[](#配置模块信息)

在你的 `main.php` 配置文件中添加下面配置

```
return [
    'modules' => [
        'admin' => [
            'class' => 'gxcok\admin\Module',
            // 使用的登录用户组件
            'user' => 'admin',
            // 配置退出登录地址
            'logoutUrl' => 'default/logout', // 默认就是default/logout
            // 验证码验证地址
            'captchaAction' => 'default/captcha', // 默认值为null 使用的就是default/captcha
        ]
    ],
    'components' => [

        // 后台登录用户组件信息
        'admin' => [
            'class'           => 'yii\web\User',
            'identityClass'   => 'gxcok\admin\models\Admin',
            'enableAutoLogin' => true,
            'loginUrl'        => ['/admin/admin/default/login'],
            'idParam'         => '_adminId',
            'identityCookie'  => ['name' => '_admin', 'httpOnly' => true],
        ],

        // 后台使用的语言配置信息
        'i18n' => [
            'translations' => [
                'admin' => [
                    'class'          => 'yii\i18n\PhpMessageSource',
                    'sourceLanguage' => 'en',
                    'basePath'       => '@gxcok/admin/messages'
                ],
            ],
        ],

        // 配置权限使用数据库
        'authManager'  => [
            'class' => 'yii\rbac\DbManager',
        ],

    ]
];
```

在你的 `params.php` 配置文件添加如下配置信息

```
return [
    // 这个配置是为了导入权限信息需要配置的，就是配置后台模块的路径
    'admin_rule_prefix' => 'admin',

    // 登录成功首页是否需要显示其他信息
    'projectOpenOther' => true,

    // 项目信息
    'projectName'      => 'Yii2 后台管理系统',
    'projectTitle'     => 'Yii2 后台管理系统',
    'companyName'      => ' gxcok  Yii2 Admin 项目 © 2025',
];
```

### 使用数据库迁移、导入后台所需的数据库信息、需要顺序执行下面命令

[](#使用数据库迁移导入后台所需的数据库信息需要顺序执行下面命令)

#### 需要配置 `console`

[](#需要配置-console)

在 `console` 配置中的 `components` 组件中加入权限配置信息

```
return [
    'components' => [
        // 权限配置
        'authManager'  => [
            'class' => 'yii\rbac\DbManager',
        ],
    ],
];
```

- 高级版本的配置文件在 `console/config/main.php`中

#### 导入权限表信息

[](#导入权限表信息)

```
php yii migrate --migrationPath=@yii/rbac/migrations

```

#### 导入后台表信息和默认权限、菜单信息

[](#导入后台表信息和默认权限菜单信息)

```
php yii migrate --migrationPath=@gxcok/admin/migrations

```

### 你可以愉快的使用了

[](#你可以愉快的使用了)

访问地址

```
// 登录地址、域名需要根据你的域名修改
http://localhost/path/to?index.php?r=admin/default/login

```

#### 默认的账号和密码

[](#默认的账号和密码)

1. 超级管理员

    - username: super
    - password: admin123
2. 普通管理员

    - username: admin
    - password: admin888

在自己模块中使用
--------

[](#在自己模块中使用)

### `Yii2` 高级版本中使用

[](#yii2-高级版本中使用)

定义一个基础控制，其他控制器都继承基础控制器

1. 控制器继承`gxcok\admin\controllers\Controller`
    - 定义控制器使用的布局文件为 `@gxcok/admin/views/layouts/main`
    - 定义上传文件表单类使用自己的 ，例如：`backend\models\forms\UploadForm`
2. 如果要记录操作日志和权限验证，定义行为
    - 记录日志行为类： `gxcok\admin\behaviors\Logging`

        默认只会记录： create, update, delete, delete-all, editable, upload 操作的日志， 需要添加或者修改，定义`needLogActions` 属性
    - 权限验证行为类： `yii\filters\AccessControl`

例子：

```
namespace backend\controllers;

use gxcok\admin\behaviors\Logging;
use gxcok\admin\controllers\Controller as BaseController;
use yii\filters\AccessControl;

/**
 * Class Controller 后台的基础控制器
 * @package backend\controllers
 */
class Controller extends BaseController
{
    /**
     * @var string 使用 yii2-admin 的布局
     */
    public $layout = '@gxcok/admin/views/layouts/main';

    /**
     * @var string 使用自己定义的上传文件处理表单
     */
    public $uploadFromClass = 'backend\models\forms\UploadForm';

    /**
     * 定义使用的行为
     *
     * @return array
     */
    public function behaviors()
    {
        return [
            'access' => [
                'class' => AccessControl::className(),
                'rules' => [
                    [
                        'allow'       => true,
                        'permissions' => [$this->action->getUniqueId()],
                    ],
                ],
            ],

            'logging' => [
                'class' => Logging::className(),
            ],
        ];
    }
}
```

后台预览
----

[](#后台预览)

1. 登录页面 [![登录页](https://camo.githubusercontent.com/d0883686986a88123a059cac3aa851908b4b88bd2a3d3746148c542b12cc0b95/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f6c6f67696e2e706e67)](https://camo.githubusercontent.com/d0883686986a88123a059cac3aa851908b4b88bd2a3d3746148c542b12cc0b95/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f6c6f67696e2e706e67)
2. 数据显示 [![数据显示](https://camo.githubusercontent.com/e3022be0036cfd7d7f51e88fa5df475ddcddd8b7419ca8d6b22b84f4495eb475/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f766965772e706e67)](https://camo.githubusercontent.com/e3022be0036cfd7d7f51e88fa5df475ddcddd8b7419ca8d6b22b84f4495eb475/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f766965772e706e67)
3. 数据编辑 [![数据显示](https://camo.githubusercontent.com/dd2ecc410fe7e30ea79830e4fe17caca58ef61a1ad2403f038b0a969792527c7/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f7570646174652e706e67)](https://camo.githubusercontent.com/dd2ecc410fe7e30ea79830e4fe17caca58ef61a1ad2403f038b0a969792527c7/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f7570646174652e706e67)
4. 权限分配 [![权限分配](https://camo.githubusercontent.com/9b5d2fdf02e5486a78a994fc4ab3f79b63f0b2b2447e2838195ebee2121d25e9/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f617574682e706e67)](https://camo.githubusercontent.com/9b5d2fdf02e5486a78a994fc4ab3f79b63f0b2b2447e2838195ebee2121d25e9/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f617574682e706e67)
5. 代码生成 [![代码生成](https://camo.githubusercontent.com/58a18ba9b3cc9b9deeea396ee6cbe2f857bd683f94653e02c9f28c13aedc35ec/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f6769692e706e67)](https://camo.githubusercontent.com/58a18ba9b3cc9b9deeea396ee6cbe2f857bd683f94653e02c9f28c13aedc35ec/68747470733a2f2f7777772e666178776f2e636f6d2f796969322d61646d696e2f6769692e706e67)

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance51

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

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

345d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16069458?v=4)[gxcok](/maintainers/gxcok)[@gxcok](https://github.com/gxcok)

---

Tags

authrbacyii2adminace-admin

### Embed Badge

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

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

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[jinxing/yii2-admin

RBAC Auth manager for Yii2

391.0k1](/packages/jinxing-yii2-admin)[liujx/yii2-app-advanced

Yii2 ace-admin RBAC management background

1301.4k](/packages/liujx-yii2-app-advanced)[izyue/yii2-admin

RBAC Auth manager for Yii2

401.8k1](/packages/izyue-yii2-admin)

PHPackages © 2026

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