PHPackages jinxing/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. jinxing/yii2-admin ActiveYii2-extension[Authentication & Authorization](/categories/authentication) jinxing/yii2-admin ================== RBAC Auth manager for Yii2 1.2.21(4y ago)381.0k↓77.8%111BSD-3-ClausePHP Since Nov 13Pushed 4y ago3 watchersCompare [ Source](https://github.com/myloveGy/yii2-admin)[ Packagist](https://packagist.org/packages/jinxing/yii2-admin)[ RSS](/packages/jinxing-yii2-admin/feed)WikiDiscussions master Synced 3w ago READMEChangelog (10)Dependencies (5)Versions (20)Used By (1) Yii2 Ace Admin 后台扩展模块 ===================== [](#yii2-ace-admin-后台扩展模块) [![Progress](https://camo.githubusercontent.com/6bec38c95d3bc5cef451bec1575a98a2d810fddde9db1bb88847e98ccbad5950/687474703a2f2f70726f677265737365642e696f2f6261722f3130303f7469746c653d636f6d706c65746564)](https://camo.githubusercontent.com/6bec38c95d3bc5cef451bec1575a98a2d810fddde9db1bb88847e98ccbad5950/687474703a2f2f70726f677265737365642e696f2f6261722f3130303f7469746c653d636f6d706c65746564)[![Latest Stable Version](https://camo.githubusercontent.com/754e43d54347116f4f68c7c57bd73126a3ab104677100a08cb0beaa9be4edf55/68747470733a2f2f706f7365722e707567782e6f72672f6a696e78696e672f796969322d61646d696e2f762f737461626c65)](https://packagist.org/packages/jinxing/yii2-admin)[![Total Downloads](https://camo.githubusercontent.com/4390edc75a28af5611cbd11bca661f297f7fb5e17db9d04681fbdff97fb1ae72/68747470733a2f2f706f7365722e707567782e6f72672f6a696e78696e672f796969322d61646d696e2f646f776e6c6f616473)](https://packagist.org/packages/jinxing/yii2-admin)[![Latest Unstable Version](https://camo.githubusercontent.com/8a038fdf64a62a1e50660d7d0d3da771ebe7a1f5246ef763e7cffad7fa42092e/68747470733a2f2f706f7365722e707567782e6f72672f6a696e78696e672f796969322d61646d696e2f762f756e737461626c65)](https://packagist.org/packages/jinxing/yii2-admin)[![GitHub issues](https://camo.githubusercontent.com/18e5ef3cfa734069d34abccfedf62d9bb0956869ffaa99d4a1e19076bb4c6ece/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f6d796c6f766547792f796969322d61646d696e2e737667)](https://github.com/myloveGy/yii2-admin/issues)[![GitHub forks](https://camo.githubusercontent.com/b68feb0bef7b92da85f23cbc652f39932b1455e45b05e6130d7b90097ad2438b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f666f726b732f6d796c6f766547792f796969322d61646d696e2e737667)](https://github.com/myloveGy/yii2-admin/network)[![GitHub stars](https://camo.githubusercontent.com/2dd7033ca7165d54c21da75646a6ae1b31ae3d4bdb128e38f0bcc4e837b84a62/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6d796c6f766547792f796969322d61646d696e2e737667)](https://github.com/myloveGy/yii2-admin/stargazers)[![GitHub license](https://camo.githubusercontent.com/4628ef51e5b2ca4b4ade8e72aaaea0f7b00da1d94432a1e4d6a295365941db50/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d796c6f766547792f796969322d61646d696e2e737667)](https://github.com/myloveGy/yii2-admin/blob/master/LICENSE.md) [change to English](https://mylovegy.github.io/yii2-admin/?page=home.en-us) 作者博客 ---- [](#作者博客) [作者博客](https://mylovegy.github.io/blog/) 简介 -- [](#简介) 使用的 [ace admin](http://ace.jeka.by/) 前端框架, 为`yii2`开发的一个后台模块; 对于二次开发比较方便，包含了基本的后台功能 [说明文档](https://mylovegy.github.io/yii2-admin/) 功能特性 ---- [](#功能特性) - 包含基本的后台功能 - 管理员管理: 登录、登出、修改密码等 - 菜单管理: 可视化动态菜单、根据权限显示菜单 - 权限管理: 角色、权限、用户的管理 - 使用`yii2`自带的`RBAC`权限管理 - 对于二次开发比较方便 - 定义基本控制器(封装了基本的`CURD`操作), 后续开发基于基础控制器继承修改 - 拥有代码生成功能(类似于`gii`), 可视化生成代码模板, 简单操作即可生成 控制器`controller`、模型`model`, 视图`views`文件，提高开发效率 安装 -- [](#安装) ### 安装要求 [](#安装要求) - PHP >= 5.4 - MySQL ### 全新项目安装 [](#全新项目安装) 全新项目安装可以直接使用[liujx/yii2-app-advanced](https://packagist.org/packages/liujx/yii2-app-advanced) ### 在已有项目中安装 [](#在已有项目中安装) 使用 `composer` 下载包文件 ``` composer require jinxing/yii2-admin ``` ### 配置模块信息 [](#配置模块信息) 在你的 `main.php` 配置文件中添加下面配置 ``` return [ 'modules' => [ 'admin' => [ 'class' => 'jinxing\admin\Module', // 使用的登录用户组件 'user' => 'admin', // 配置退出登录地址 'logoutUrl' => 'default/logout', // 默认就是default/logout // 验证码验证地址 'captchaAction' => 'default/captcha', // 默认值为null 使用的就是default/captcha ] ], 'components' => [ // 后台登录用户组件信息 'admin' => [ 'class' => 'yii\web\User', 'identityClass' => 'jinxing\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' => '@jinxing/admin/messages' ], ], ], // 配置权限使用数据库 'authManager' => [ 'class' => 'yii\rbac\DbManager', ], ] ]; ``` 在你的 `params.php` 配置文件添加如下配置信息 ``` return [ // 这个配置是为了导入权限信息需要配置的，就是配置后台模块的路径 'admin_rule_prefix' => 'admin', // 登录成功首页是否需要显示其他信息 'projectOpenOther' => true, // 项目信息 'projectName' => 'Yii2 后台管理系统', 'projectTitle' => 'Yii2 后台管理系统', 'companyName' => ' Liujinxing Yii2 Admin 项目 © 2016-2018', ]; ``` #### [高级版本配置参考](https://mylovegy.github.io/yii2-admin/?page=module#%3Ccode%3Eyii2%3C/code%3E%E9%AB%98%E7%BA%A7%E7%89%88%E5%90%8E%E5%8F%B0%E9%85%8D%E7%BD%AE%E6%A8%A1%E6%9D%BF) [](#高级版本配置参考) #### [基础版本配置参考](https://mylovegy.github.io/yii2-admin/?page=module#%3Ccode%3Eyii2%3C/code%3E%E5%9F%BA%E7%A1%80%E7%89%88%E5%90%8E%E5%8F%B0%E9%85%8D%E7%BD%AE%E6%A8%A1%E6%9D%BF) [](#基础版本配置参考) ### 使用数据库迁移、导入后台所需的数据库信息、需要顺序执行下面命令 [](#使用数据库迁移导入后台所需的数据库信息需要顺序执行下面命令) #### 需要配置 `console` [](#需要配置-console) 在 `console` 配置中的 `components` 组件中加入权限配置信息 ``` return [ 'components' => [ // 权限配置 'authManager' => [ 'class' => 'yii\rbac\DbManager', ], ], ]; ``` - 高级版本的配置文件在 `console/config/main.php`中 - 基础版本的配置文件在 `config/console.php`中 #### 导入权限表信息 [](#导入权限表信息) ``` php yii migrate --migrationPath=@yii/rbac/migrations ``` #### 导入后台表信息和默认权限、菜单信息 [](#导入后台表信息和默认权限菜单信息) ``` php yii migrate --migrationPath=@jinxing/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. 控制器继承`jinxing\admin\controllers\Controller` - 定义控制器使用的布局文件为 `@jinxing/admin/views/layouts/main` - 定义上传文件表单类使用自己的 ，例如：`backend\models\forms\UploadForm` 2. 如果要记录操作日志和权限验证，定义行为 - 记录日志行为类： `jinxing\admin\behaviors\Logging` 默认只会记录： create, update, delete, delete-all, editable, upload 操作的日志， 需要添加或者修改，定义`needLogActions` 属性 - 权限验证行为类： `yii\filters\AccessControl` [类的属性和配置参考](https://www.yiichina.com/doc/api/2.0/yii-filters-accesscontrol) 例子： ``` namespace backend\controllers; use jinxing\admin\behaviors\Logging; use jinxing\admin\controllers\Controller as BaseController; use yii\filters\AccessControl; /** * Class Controller 后台的基础控制器 * @package backend\controllers */ class Controller extends BaseController { /** * @var string 使用 yii2-admin 的布局 */ public $layout = '@jinxing/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(), ], ]; } } ``` ### `Yii2` 基础版本中使用 [](#yii2-基础版本中使用) `yii2` 基础版本需要为后台定义一个模块，这个模块可以直接继承`jinxing\admin\Module` 例子： ``` namespace app\modules\admin; use Yii; use jinxing\admin\Module; /** * admin module definition class */ class Admin extends Module { /** * {@inheritdoc} */ public $controllerNamespace = 'app\modules\admin\controllers'; /** * {@inheritdoc} */ public function init() { parent::init(); Yii::$app->errorHandler->errorAction = $this->getUniqueId() . '/admin/default/error'; } } ``` > 如果不使用模块继承方式，配置参考高级版本 使用文档 ---- [](#使用文档) ### [文档说明](https://mylovegy.github.io/yii2-admin/) [](#文档说明) ### [模块配置说明](https://mylovegy.github.io/yii2-admin/?page=module) [](#模块配置说明) ### [控制器配置说明](https://mylovegy.github.io/yii2-admin/?page=controller) [](#控制器配置说明) ### [前端`MeTables`配置说明](https://mylovegy.github.io/yii2-admin/?page=me-table) [](#前端metables配置说明) 后台预览 ---- [](#后台预览) 1. 登录页面 [![登录页](https://camo.githubusercontent.com/4123e5a6958cbeca86598ff30ec2fd9a7f76dee60b94889705b479f13b261332/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d6c6f67696e2e706e67)](https://camo.githubusercontent.com/4123e5a6958cbeca86598ff30ec2fd9a7f76dee60b94889705b479f13b261332/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d6c6f67696e2e706e67) 2. 数据显示 [![数据显示](https://camo.githubusercontent.com/70e3228659ba0140b22cbeecd677f3a7ed0ff75313c7f924672d327a9c6ef11b/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d646174612e706e67)](https://camo.githubusercontent.com/70e3228659ba0140b22cbeecd677f3a7ed0ff75313c7f924672d327a9c6ef11b/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d646174612e706e67) 3. 数据编辑 [![数据显示](https://camo.githubusercontent.com/5d73603a5c1ba78a79b2ad9bc27b9fd3f1147020d054c852411f003a3418f130/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d7570646174652e706e67)](https://camo.githubusercontent.com/5d73603a5c1ba78a79b2ad9bc27b9fd3f1147020d054c852411f003a3418f130/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d7570646174652e706e67) 4. 权限分配 [![权限分配](https://camo.githubusercontent.com/ad750dbbc423bfd886bbc8a09a8c7724663e374162d356f101753154c8f36ca3/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d617574682e706e67)](https://camo.githubusercontent.com/ad750dbbc423bfd886bbc8a09a8c7724663e374162d356f101753154c8f36ca3/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d617574682e706e67) 5. 代码生成 [![代码生成](https://camo.githubusercontent.com/51df9177f6624eb7b8eaeb42df5db9096025592d708f3db49654d54a768db6fd/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d636f64652e706e67)](https://camo.githubusercontent.com/51df9177f6624eb7b8eaeb42df5db9096025592d708f3db49654d54a768db6fd/68747470733a2f2f6d796c6f766567792e6769746875622e696f2f796969322d61646d696e2f646f63732f696d616765732f646f63732d636f64652e706e67) ### Health Score 37 — LowBetter than 81% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity27 Limited adoption so far Community19 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 97.4% 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 ~67 days Recently: every ~153 days Total 17 Last Release 1709d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a622f6dcae0baf206ab50e361b5860394855eda8c05f8818735f5f379318ae57?d=identicon)[jinxing.liu](/maintainers/jinxing.liu) ![](https://www.gravatar.com/avatar/17c7d64ecd58e40fd34953e3dd8d6ed0292edd070c73e00f98b0764b5f71ec97?d=identicon)[he5127](/maintainers/he5127) --- Top Contributors [![myloveGy](https://avatars.githubusercontent.com/u/11523869?v=4)](https://github.com/myloveGy "myloveGy (263 commits)")[![he5127](https://avatars.githubusercontent.com/u/39181590?v=4)](https://github.com/he5127 "he5127 (6 commits)")[![tanliang](https://avatars.githubusercontent.com/u/1677660?v=4)](https://github.com/tanliang "tanliang (1 commits)") --- Tags ace-adminyii2yii2-adminyii2-extensionauthrbacyii2adminace-admin ### Embed Badge ![Health badge](/badges/jinxing-yii2-admin/health.svg) ``` [![Health](https://phpackages.com/badges/jinxing-yii2-admin/health.svg)](https://phpackages.com/packages/jinxing-yii2-admin) ``` ### Alternatives [liujx/yii2-app-advanced Yii2 ace-admin RBAC management background 1301.4k](/packages/liujx-yii2-app-advanced)[windhoney/yii2-rest-rbac RBAC Auth manager for Yii2 RESTful 811.2k](/packages/windhoney-yii2-rest-rbac)[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)