PHPackages                             music-man-hl/administrator - 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. music-man-hl/administrator

ActiveLibrary[Admin Panels](/categories/admin)

music-man-hl/administrator
==========================

Admin system based on Laravel 5.5

2.0(9y ago)08MITJavaScriptPHP >=5.5.9

Since Jun 30Pushed 8y ago1 watchersCompare

[ Source](https://github.com/Music-man-hl/administrator)[ Packagist](https://packagist.org/packages/music-man-hl/administrator)[ Docs](https://github.com/aishan/ForoneAdministrator)[ RSS](/packages/music-man-hl-administrator/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependencies (7)Versions (2)Used By (0)

ForoneAdministrator 是一款基于Laravel5.1封装的后台管理系统，集成了[Entrust](https://github.com/Zizaco/entrust)权限管理，并针对业务的增删改查进行了视图和业务层的封装，有助于进行后台管理系统的快速研发。

- [安装初始化](#init)
- [forone配置](#config)
- [权限控制](#permission)
- [1分钟完成分类模块](#demo)
- [视图控件](#controllers)
    - [数据列表头 - Html::list\_header](#list_header)
    - [数据列表 - Html::datagrid](#datagrid)
    - [下拉列表选择 - Form::form\_select](#form_select)
    - [单选Radio - Form::form\_radio](#form_radio)
    - [时间控件 - Form::form\_time](#form_time)
    - [日期控件 - Form::form\_date](#form_date)
    - [单行文本输入框 - From::form\_text](#form_text)
    - [多行文本输入框 - From::form\_area](#form_area)
    - [单文件上传 - Form::single\_file\_upload](#single_upload)
    - [多文件上传 - Form::multi\_file\_upload](#multi_upload)
    - [富文本编辑器 - Form::ueditor](#ueditor)
- [提高研发效率的几个自定义命令](#commands)

### 效果图

[](#效果图)

#### PC端

[](#pc端)

[![](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/login.png)](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/login.png)[![](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/roles-index.jpg)](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/roles-index.jpg)

#### 移动端

[](#移动端)

[![](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/mobile-login.png)](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/mobile-login.png)[![](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/mobile-roles-index.jpg)](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/mobile-roles-index.jpg)[![](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/mobile-aside.jpg)](https://raw.githubusercontent.com/ForoneTech/screenshots/master/laravel-admin/mobile-aside.jpg)

[](#init)

[](#init)

### 安装初始化

[](#安装初始化)

系统要求:

- Laravel 5.1+
- PHP 5.5.9+

由于不可抗力因素，最好在`compoer.json`里加入如下配置后再开始安装，设置国内的`composer`镜像同时也可设置直接从国内git服务器上下载。 由于使用的entrust还处于dev状态，所以需要将composer.json里的`minimum-stability` 设置为 `dev`

```
"repositories": [
  {"type": "git", "url": "http://git.forone.co/mani/ForoneAdministrator.git"},
  {"type": "composer", "url": "http://packagist.phpcomposer.com"},
  {"packagist": false}
],
"minimum-stability" : "dev"
```

> 由于启用了 `"minimum-stability" : "dev"`，Laravel的`dev`版本会导致paginate出错，请在`composer.json`里将laravel版本设置为`5.1.4`

使用composer进行安装

```
composer require forone/administrator:~1.0.0

```

编辑 `config/app.php` 注册 `providers` 和 `aliases`

```
'providers' => [
    Forone\Admin\Providers\ForoneServiceProvider::class
]
```

```
'aliases' => [
    'Form'      => Illuminate\Html\FormFacade::class,
    'Html'      => Illuminate\Html\HtmlFacade::class,
    'Entrust'   => Zizaco\Entrust\EntrustFacade::class
]
```

发布资源，运行下面命令会自动生成默认的配置文件并复制静态文件和数据库文件

```
php artisan vendor:publish

```

修改`.env`通过环境变量设置初始管理员账号密码

`ADMIN_EMAIL`默认为`admin@admin.com``ADMIN_PASSWORD`默认为`admin`

系统初始化

```
php artisan forone:init

```

为`App\User`添加Entrust的Trait，以便使用一些封装的方法

```
use Authenticatable, CanResetPassword, EntrustUserTrait;

```

使用`EntrustUserTrait`的时候注意需要引入该类：

```
use Zizaco\Entrust\Traits\EntrustUserTrait;

```

现在就可以使用`.env`里的管理员账号密码登陆了

[](#config)

### forone配置

[](#forone配置)

```
return [
    'site_config'                 => [
        'site_name'   => '站点名称',
        'title'       => '站点标题',
        'description' => '站点描述',
        'logo'        => '站点logo地址'
    ],
    'RedirectAfterLoginPath'      => 'admin/roles', // 登录后跳转页面
    'RedirectIfAuthenticatedPath' => 'admin/roles', // 如果授权后直接跳转到指定页面

    'menus'                       => [
        '系统设置' => [
            'icon'       => 'mdi-toggle-radio-button-on', //菜单icon
            'permission' => 'admin',                      //菜单显示所需权限
            'children'   => [                             //菜单的子菜单数组
                '角色管理'  => [
                    'uri' => 'roles',                     //菜单对应的uri
                ],
                '权限管理'  => [
                    'uri' => 'permissions',
                ],
                '管理员管理' => [
                    'uri' => 'admins',
                ]
            ],
        ],
    ],

    'qiniu'                       => [
        'host'       => 'http://share.u.qiniudn.com',               //your qiniu host url
        'access_key' => '-S31BNj77Ilqwk5IN85PIBoGg8qlbkqwULiraG0x', //for test
        'secret_key' => 'QoVdaBFZITDp9hD7ytvUKOMAgohKaB8oa11FJdxN', //for test
        'bucket'     => 'share'
    ]
];
```

[](#permission)

### 权限控制

[](#权限控制)

权限控制主要分两部分，一部分是控制菜单是否显示，通过菜单的`permission`属性即可完成，另一部分是控制路由，通过`admin.permission`中间件传参来进行控制即可，主要有两种使用场景：

- 在routes里进行权限控制，这种用法是直接使用middleware进行自动判定的，更多的别的路由过滤的用法请看`entrust`文档

```
Route::group(['prefix' => 'admin', 'middleware' => ['admin.auth', 'admin.permission:admin']], function () {
```

- 在Controller里对Controller的所有请求进行权限控制

```
function __construct()
{
    parent::__construct('admins', '管理员');
    $this->middleware('admin.permission:admin|test'); //需要admin及test的权限才可以访问该Controller
}
```

[](#demo)

### 1分钟完成分类管理模块

[](#1分钟完成分类管理模块)

> 以最简单的模块为实例，假设数据库已建好，需要创建一个分类管理模块

1. 复制`PermissionsController`并粘贴更名为`CategoriesController`；复制`views/permissions`文件夹并粘贴更名为`views/categories`
2. 编辑`CategoriesController`，修改以下几处：
    - 修改类名为文件名
    - 修改构造函数的uri和name为 `parent::__construct('categories', '分类管理');`
    - 批量修改`Permission`为`Category`
    - 修改`index`里的数据列表显示项
    - `Request`类视情况调整
3. 编辑`views/categories/form.blade.php`，修改输入项及描述名称
4. 编辑`routes.php`添加路由 `Route::resource('categories', 'CategoriesController');`
5. 编辑`forone.php`添加菜单 `"分类管理"=>["uri"=>"categories"]`

> 复杂的模块可能在index或者其它部分有更复杂的改动，总体上来说`Controller`的结构和基本功能代码及`views`的都可以复用

[](#controllers)

### 视图控件

[](#视图控件)

详细描述封装好的便于使用的数据控件

[](#datagrid)

#### 数据列表

[](#数据列表)

用法：`{!! Html::datagrid($results) !!}`

数据：数据源为数组

```
'columns' => [
    ['流水号', 'id', function ($id) {
        return '';
    }],
    ['金额', 'amount'],
    ['操作', 'buttons', 100, function () {
        $buttons = [
            ['查看']
        ];
        return $buttons;
    }],
]
```

数据项参数：

1. 列名称
2. 数据项的属性，其中`buttons`是固定的按钮列使用属性
3. 有以下几种情况：
    - 可以为空，就按默认情况显示
    - 可以为数字，为显示的列宽
    - 可以为函数，用以处理数据项并返回显示结果，包括根据不同权限返回不同结果等，作为函数的时候也可以直接返回`html`代码以显示任意内容
4. 为函数，作为`buttons`项的时候，返回的按钮数组有以下几种情况：
    - `查看`,`编辑`默认会跳转到查看和编辑页面
    - `启用`,`禁用`默认会单独修改数据项的`enabled`字段
    - 点击按钮后需要修改某个字段为某个值，比如审核通过或者驳回之类： `[['name'=>'测试','class'=>'btn-danger'],['tested'=>'true','other'=>'somevalue']]`第一个数组描述按钮的名称和样式，第二个数组描述需要更改的字段和值
    - 点击按钮后需要调用某个接口并传参数：`[['name'=>'测试','class'=>'btn-danger','uri'=>'/api/test','method'=>'POST'],['tested'=>'true','other'=>'somevalue']]`
    - 点击按钮后需要弹出某个弹出框，`['配置','#modal']`，就会弹出来id为`modal`的弹出框

[](#list_header)

#### 数据列表头 - 新增、检索、过滤筛选等

[](#数据列表头---新增检索过滤筛选等)

用法：

```
{!! Html::list_header([
    'new'=>true,
    'search'=>true,
    'title'=>'数据列表标题',
    'filters'=>$results['filters']
    ]) !!}
```

数据项参数：

1. `new` 表示是否显示`新增`按钮，点击后跳转到创建页面
2. `search` 表示是否显示`检索`输入框，输入检索内容后，默认以`keywords`为参数传递到后端接口，相当于`?keywords=xxx`
3. `title` 标题
4. `filters` 数据源为数组，如下：

```
$results['filters'] = [
    'status' => [
        ['label' => '所有状态', 'value'=>''],
        ['label' => '状态1', 'value' => 0]
    ],
    'other' => [
        ['label' => '其它过滤', 'value'=>''],
        ['label' => '过滤1', 'value' => 0]
    }
];
```

`status`和`other`是该数据项的字段名，它们对应的数组是显示出来供选择的选项，选择后会自动提交请求，相当于`?status=''&other=''`。 相应的在Controller的`index`方法里，添加很简单的代码即可实现分页的同时自动加上相应的参数，并根据参数过滤相应的内容，如下：

```
$all = $request->except(['page']);
$paginate = Model::orderBy('id', 'desc');
//如果没有筛选条件直接返回分页数据
if (!sizeof($all)) {
    $paginate = $paginate->paginate();
}else{
    //遍历筛选条件
    foreach ($all as $key => $value) {
        if ($key == 'keywords') { //检索的关键词，定义检索关键词的检索语句
            $paginate->where('name', 'LIKE', '%'.$value.'%');
        }else{
            //可以根据不同的检索条件的不同值进行不同的语句组合，比如状态为7的数据加多筛选条件
            if ($key == 'status' && $value == 7) {
                $paginate->where($key, '=', 1)
                        ->where('time', ' `b` ')
                        ->orWhere($key, '=', $value);
            } else { //正常来说就只加where即可
                $paginate->where($key, '=', $value);
            }
        }
    }
    $paginate = $paginate->paginate();
}
$results = [
    'items' => $paginate->appends($all),
];
```

> 针对简单内容的筛选，基本上检索代码都可以直接Copy使用，仅需修改`Model`即可

[](#form_select)

#### 下拉列表选择

[](#下拉列表选择)

用法：

```
Form::form_select('type_id', '标的类型', [
    ['label'=>'名称', 'value'=>'']
],0.5,false)
```

参数：

1. 字段名
2. 数据项的Label名称
3. 下拉列表数据，label表示显示出来的内容，value表示存储的时候使用的内容
4. 长度，默认是bootstratp整行的一半，等同于`col-md-6`
5. 是否用于`modal`，因为modal样式有些差异，所以加了这个参数

[](#form_radio)

#### 单选radio

[](#单选radio)

用法：

```
{!! Form::form_radio('risk_level', '风险等级', [
[0, 'A', true],
[1, 'B'],
[2, 'C'],
[3, 'D'],
[4, 'E'],
[5, 'F']
], 0.5) !!}
```

参数：

1. 字段名
2. 数据项的Label名称
3. 数据内容，包括
    - 存储时用的数据
    - 显示出来的名称
    - 是否默认选中
4. 长度，默认是bootstratp整行的一半，等同于`col-md-6`，radio因为经常比较多，默认是`1`

[](#form_time)

#### 时间控件

[](#时间控件)

用法：

```
{!! Form::form_time('time','开始时间','如 2015-06-06 08:00:00') !!}
```

参数：

1. 字段名
2. label名称
3. 提示文字

[](#form_date)

#### 日期控件

[](#日期控件)

用法：

```
{!! Form::form_date('date','开始日期','如 2015-06-06') !!}
```

参数：

1. 字段名
2. label名称
3. 提示文字

[](#form_text)

#### 单行文本输入

[](#单行文本输入)

用法：

```
{!! Form::form_text('column','字段名称','提示文字') !!}
```

[](#form_area)

#### 多行文本输入

[](#多行文本输入)

用法：

```
{!! Form::form_area('column','字段名称','提示文字') !!}
```

[](#single_upload)

#### 单文件上传

[](#单文件上传)

用法：

```
{!! Form::single_file_upload('field_name', 'label') !!}
```

参数：

1. 字段名
2. 项名称
3. 项宽度，默认`0.5`
4. 上传平台，目前默认且仅支持`qiniu`

[](#multi_upload)

#### 多文件上传

[](#多文件上传)

用法：

```
{!! Form::multi_file_upload('field_name', 'label') !!}
```

参数：

1. 字段名
2. 项名称
3. 是否显示图片描述输入框
4. 项宽度，默认`0.5`
5. 上传平台，目前默认且仅支持`qiniu`

[](#ueditor)

#### 富文本编辑器

[](#富文本编辑器)

用法：

```
{!! Form::ueditor('name', 'label') !!}
```

参数：

1. 字段名
2. 项名称
3. 项宽度，默认`0.5`

[](#commands)

#### 提高研发效率的几个自定义命令

[](#提高研发效率的几个自定义命令)

- `php artisan forone:init` 系统初始化命令，只可运行一次。
- `php artisan db:backup` 通过`iseed`库自动备份当前数据库的数据到Seeder文件里，解决研发时测试数据同步或临时数据结构变更测试数据面临清空等问题。并可根据migrations的文件顺序进行合理的排序，避免由于依赖关系引起的后续数据填充问题。
- `php artisan db:clear` 清空数据库，心情不爽的时候用一下，感觉棒棒哒。
- `php artisan db:upgrade` 升级数据库，可能加了新的字段等，会自动填充Seeder文件里的数据，升级之前最好先备份下数据。
- `php artisan forone:copy` 可复制一些文件到实际项目里，比如复制routes文件以便自定义route

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

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

3603d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/19572265?v=4)[hl调调](/maintainers/Music-man-hl)[@Music-man-hl](https://github.com/Music-man-hl)

---

Top Contributors

[![aishan](https://avatars.githubusercontent.com/u/5790302?v=4)](https://github.com/aishan "aishan (34 commits)")[![mani95lisa](https://avatars.githubusercontent.com/u/1968989?v=4)](https://github.com/mani95lisa "mani95lisa (19 commits)")[![839891627](https://avatars.githubusercontent.com/u/10300651?v=4)](https://github.com/839891627 "839891627 (1 commits)")[![Music-man-hl](https://avatars.githubusercontent.com/u/19572265?v=4)](https://github.com/Music-man-hl "Music-man-hl (1 commits)")[![sinabs](https://avatars.githubusercontent.com/u/1351257?v=4)](https://github.com/sinabs "sinabs (1 commits)")

---

Tags

laravel 5adminforone

### Embed Badge

![Health badge](/badges/music-man-hl-administrator/health.svg)

```
[![Health](https://phpackages.com/badges/music-man-hl-administrator/health.svg)](https://phpackages.com/packages/music-man-hl-administrator)
```

###  Alternatives

[forone/administrator

Admin system based on Laravel 5.2

4382.0k](/packages/forone-administrator)[dwij/laraadmin

LaraAdmin is a Open source Laravel Admin Panel / CMS which can be used as Admin Backend, Data Management Tool or CRM boilerplate for Laravel with features like CRUD Generation, Module Manager, Media, Menus, Backups and much more

1.6k68.7k](/packages/dwij-laraadmin)[laravelrus/sleepingowl

Administrative interface builder for Laravel.

810219.6k3](/packages/laravelrus-sleepingowl)[appzcoder/laravel-admin

Laravel Admin Panel

747106.3k](/packages/appzcoder-laravel-admin)[slowlyo/owl-admin

基于 laravel、amis 开发的后台框架~

61214.2k26](/packages/slowlyo-owl-admin)[sebastienheyd/boilerplate

Laravel Boilerplate based on AdminLTE 3 with blade components, user management, roles, permissions, logs viewer, ...

28618.2k3](/packages/sebastienheyd-boilerplate)

PHPackages © 2026

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