PHPackages                             e282486518/yii2admin - 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. [Admin Panels](/categories/admin)
4. /
5. e282486518/yii2admin

ActiveProject[Admin Panels](/categories/admin)

e282486518/yii2admin
====================

通用的yii2后台，基于Yii2的advanced应用程序模板，采用metronic4.5.6作为前后台模板，整合RBAC、Menu、Config、Migration多语言、RESTfull等等

v1.3.2(8y ago)62352253[10 issues](https://github.com/e282486518/yii2admin/issues)BSD-3-ClauseCSSPHP >=5.4.0

Since Nov 19Pushed 4y ago75 watchersCompare

[ Source](https://github.com/e282486518/yii2admin)[ Packagist](https://packagist.org/packages/e282486518/yii2admin)[ Docs](http://www.yiiframework.com/)[ RSS](/packages/e282486518-yii2admin/feed)WikiDiscussions master Synced 2mo ago

READMEChangelogDependencies (17)Versions (6)Used By (0)

成型后的系统包括文章、商城、单页、广告、购物车、订单、标签、评论、推荐位、艾特@、消息、支付和回调、后台rbac、后台行为日志、数据可视化、配置管理等、前台用户中心、会员积分等功能。关注的朋友可以先给个Star。。

特别说明，这是一个学习型的项目（注释会尽量详细，尽量将yii2提供的大部分功能都用一遍）。有什么建议可以联系我：

如遇bug请告诉作者哦，花你一分钟时间就可以让项目更易使用.^\_^.

github :

oschina :  （国内可以下载这个）

交流： （遇到bug不愿发邮件的可以贴到这里）

全站打包： （不定期更新，安装出错的朋友可以试试这个）

一、开发基础说明
--------

[](#一开发基础说明)

- 系统配置文件为.env文件。
- gii生成的模型统一放在 `common\modelsgii`下，模型统一继承 `common\core\BaseActiveRecord` 方便扩展yii核心；
- 所有公共模型放在 `common\models` 下，并继承 `common\modelsgii` 对应模型；
- 所有表单模型都继承 `common\core\BaseModel`；
- 所有控制器都继承 `common\core\Controller` ，每个应用下面应有一个`BaseController`控制器，做为该应用的父控制器，方便做一些公共操作；
- 所有 自定义助手函数都放在 `common\helpers\` 且方法都未`static`方法；
- 公共别名在`common/config/bootstarp.php`中定义，使用`Yii::getAlias()`访问；
- 超级管理员在`\backend\comfig\params.php`的“admin”项中定义其UID，超级管理员不需要进行RBAC权限检查；
- 关于后台中的配置项目，实际是经过转化后(通常在BaseController控制器的init构造函数中转化)，变为`Yii::$app->params['web']`中；

```
Yii::$app->params['web'] = Config::lists();
```

- 在后台的`BaseController`中有一些通用的方法，例如`saveRow`（添加或编辑一行）、`delRow`（删除一行）、`error`（错误提示）、`success`（成功提示）、`setForward`（标记当前列表url，通常在列表中标记）、`getForward`（获取列表url方便跳转，通常结合error或success使用）；
- 多语言配置在`/common/config/main.php`中“i18n”项中，源语言设置的是中文，具体可自行查看；
- 后台项目的js和css资源文件放在`/common/metronic`中；
- 由于我使用的是模板自带的jQuery和bootstrap，所以我再后台`main.php`的assetManager项中清空了系统自带的jQuery和bootstrap，为了模板全局的js/css放在其他插件的前面，这里我设置了yii\\web\\JqueryAsset依赖backend\\assets\\AppAsset，这里要注意循环依赖的问题；
- RBAC权限系统没有使用第三方扩展，其实现大致思路为：一个后台用户对于一个用户组，用户权限和后台栏目一一对应；
- API接口主要使用模块做版本控制，使用RESTfull标准，权限及接口限制参考`/api/models/User.php`；
- 关于后台权限问题，后台权限是与Menu绑定的，在添加功能时先在后台【系统-菜单管理】中添加列表、增、删、改等菜单，然后到【用户-后台用户-权限管理】中【授权】，可以看到刚刚添加的菜单，勾选并提交后对应的用户组就有了该权限；

二、上传图片说明
--------

[](#二上传图片说明)

#### 1、上传单图和多图

[](#1上传单图和多图)

- 图片上传使用`/common/widgets/images`，需要扩展的可以自行修改，使用的是ajax将图片转化为`base64`编码后上传的；
- 图片存储在`storage/web/image`目录下面。如果服务器解析到`/web`目录，则图片上传地址须修改，详情参考`/web`目录；
- 图片上传配置文件在`/common/config/params`的`upload`配置项中；
- 后台图片上传使用的是`backend/controllers/PbulicController`控制器，上传成功后返回“`201610/123456789123.jpg`”。结合`Yii::$app->params['upload']`就可以生成图片路径。
- 同时也可以使用`\common\helpers\Html::src()`方法生成图片路径。这个函数还可以生成类似“`URL/index.php?path=201910/123456789123.jpg&w=100&h=100&fit=crop`”的裁剪后的图片。其中URL可以是完整的路径，包含http，其配置在`common/config/bootstarp.php`的“`@storageUrl`”中配置。

#### 2、编辑器使用UEditer(百度的编辑器)

[](#2编辑器使用uediter百度的编辑器)

- 百度编辑器使用的是大裤衩的扩展，请自行查看；
- 百度编辑器的上传路径配置在`\common\comfig\params.php`的`ueditorConfig`配置项；

三、服务器配置
-------

[](#三服务器配置)

- Apache: [点击查看](https://github.com/e282486518/yii2admin/blob/master/doc/htaccess.txt)
- Nginx: [点击查看](https://github.com/e282486518/yii2admin/blob/master/doc/nginx.conf)

四、安装
----

[](#四安装)

一键安装方法如下：

```
1、下载源文件或git clone https://github.com/e282486518/yii2admin.git
2、composer install #安装依赖扩展
3、php ./yii install #配置环境、配置数据库并安装数据库
4、参照 doc 目录下的Nginx和Apache配置文件，配置服务器，并设置hosts文件。

超级管理员账号： admin 123456
普通管理员： guanli 123456
编辑人员： feifei 123456

```

五、常见错误
------

[](#五常见错误)

1、 `[Composer\Repository\InvalidRepositoryException]` 问题。 执行

```
composer self-update
composer global require "fxp/composer-asset-plugin"

```

2、`bower-asset/jquery` 等前端资源包无法找到的问题

```
composer global require "fxp/composer-asset-plugin"

```

并在composer.json文件中加入

```
    "repositories": [
        {
            "type": "composer",
            "url": "https://asset-packagist.org"
        }
    ]

```

六、预览
----

[](#六预览)

[![登录](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/login.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/login.png)[![首页](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/index.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/index.png)[![管理员](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/admin.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/admin.png)[![权限](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/auth.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/auth.png)[![配置](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/config.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/config.png)[![数据库](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/database.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/database.png)[![列表](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/order.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/order.png)[![编辑](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/order_edit.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/order_edit.png)[![配置皮肤](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/shop.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/shop.png)[![手机版](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/order_edit1.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/order_edit1.png)[![接口调用](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/api.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/api.png)[![前台](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/frontend.png)](https://raw.githubusercontent.com/e282486518/yii2admin/master/doc/preview/frontend.png)

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community26

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 97.2% 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 ~92 days

Total

5

Last Release

3090d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/034ea8435a7398ee911f8c2bdf6a6986052c6c1a755eb8f757f35e1e9b81b53e?d=identicon)[e282486518](/maintainers/e282486518)

---

Top Contributors

[![e282486518](https://avatars.githubusercontent.com/u/4495092?v=4)](https://github.com/e282486518 "e282486518 (141 commits)")[![aaronlei](https://avatars.githubusercontent.com/u/16218247?v=4)](https://github.com/aaronlei "aaronlei (3 commits)")[![pangxieke](https://avatars.githubusercontent.com/u/11242962?v=4)](https://github.com/pangxieke "pangxieke (1 commits)")

---

Tags

adminyii2yii2adminmetronic

### Embed Badge

![Health badge](/badges/e282486518-yii2admin/health.svg)

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

###  Alternatives

[dmstr/yii2-adminlte-asset

AdminLTE backend theme asset bundle for Yii 2.0 Framework

1.1k1.8M67](/packages/dmstr-yii2-adminlte-asset)[yiister/yii2-gentelella

Free admin template for backend

277278.3k5](/packages/yiister-yii2-gentelella)

PHPackages © 2026

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