README

laravel-admin 是一个可以快速帮你构建后台管理的工具，它提供的页面组件和表单元素等功能，能帮助你使用很少的代码就实现功能完善的后台管理功能。

Demo 账号/密码:admin/admin

Inspired by SleepingOwlAdmin and rapyd-laravel.

英文文档

安装

首先确保安装好了laravel5.4，并且数据库连接设置正确。

仅支持 Laravel 5.4
composer require cyd622/laravel-admin "dev-master"

在config/app.php加入ServiceProvider:

Encore\Admin\Providers\AdminServiceProvider::class

然后运行下面的命令完成安装：

php artisan vendor:publish --tag=laravel-admin
php artisan admin:install

启动服务后，在浏览器打开 http://localhost/admin/ ,使用用户名 admin 和密码 admin登陆.

默认配置

安装完成之后，laravel-admin所有的配置都在config/admin.php文件中。

存储配置

本地上传 先添加存储配置，config/filesystems.php 添加一项disk:

'disks' => [
    ... ,

    'admin' => [
        'driver' => 'local',
        'root' => public_path('upload'),
        'visibility' => 'public',
    ],
],

设置上传的路径为public/upload (public_path('upload'))。

然后选择上传的disk，打开config/admin.php找到：

'upload'  => [

    'disk' => 'admin',

    'directory'  => [
        'image'  => 'image',
        'file'   => 'file',
    ],

    'host' => 'http://localhost:8000/upload/',
],

将disk设置为上面添加的admin，directory.image和directory.file分别为用$form->image($column)和$form->file($column)上传的图片和文件的上传目录

host为图片和文件的网络访问url前缀。

云盘上传 如果需要上传到云存储，需要安装对应laravel storage的适配器，拿七牛云存储举例

首先安装 zgldh/qiniu-laravel-storage

同样配置好disk，在config/filesystems.php 添加一项:

'disks' => [
    ... ,
    'qiniu' => [
        'driver'  => 'qiniu',
        'domains' => [
            'default'   => 'xxxxx.com1.z0.glb.clouddn.com', //你的七牛域名
            'https'     => 'dn-yourdomain.qbox.me',         //你的HTTPS域名
            'custom'    => 'static.abc.com',                //你的自定义域名
         ],
        'access_key'=> '',  //AccessKey
        'secret_key'=> '',  //SecretKey
        'bucket'    => '',  //Bucket名字
        'notify_url'=> '',  //持久化处理回调地址
    ],
],

然后修改Laravel-Admin的上传配置，打开config/admin.php找到：

'upload'  => [

    'disk' => 'qiniu',

    'directory'  => [
        'image'  => 'image',
        'file'   => 'file',
    ],

    'host' => 'http://of8kfibjo.bkt.clouddn.com/',
],

disk选择上面配置的qiniu，host配置为七牛云存储的测试域名。

使用文档

• 快速开始
• 路由配置
• 菜单配置
• 显示布局
• 数据模型表格
• 数据模型表单
  • 图片/文件上传
  • form组件管理
• 组件
  • 表格
  • 表单
  • 盒子
  • 信息盒子
  • 选项卡
  • 滑动相册
  • 折叠容器
  • 数据图表 TODO
• 权限控制

目录结构

安装完成之后，后台的安装目录为app/Admin，之后大部分的后台开发编码工作都是在这个目录下进行。

app/Admin
├── Controllers
│   ├── ExampleController.php
│   └── HomeController.php
└── routes.php

app/Admin/routes.php文件用来配置后台路由，详细使用请阅读路由配置。

app/Admin/Controllers目录用来存放后台路由器文件，该目录下的HomeController.php文件是后台首页的显示控制器，ExampleController.php为实例文件。

快速开始

用Laravel自带的users表举例,表结构为：

CREATE TABLE `users` (
  `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `email` varchar(255) COLLATE utf8_unicode_ci NOT NULL,
  `password` varchar(60) COLLATE utf8_unicode_ci NOT NULL,
  `remember_token` varchar(100) COLLATE utf8_unicode_ci DEFAULT NULL,
  `created_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
  `updated_at` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',
  PRIMARY KEY (`id`),
  UNIQUE KEY `users_email_unique` (`email`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci

对应的数据模型为文件 App\User.php

laravel-admin可以通过使用以下几步来快速生成users表的CURD操作页面：

1.添加路由器

使用下面的命令来创建一个对应App\User模型的路由器

php artisan admin:make UserController --model=App\\User

上面的命令会创建路由器文件app/Admin/Controllers/UserController.php.

2.添加路由配置

在laravel-admin的路由配置文件app/Admin/routes.php里添加一行：

$router->resource('users', UserController::class);

3.添加左侧菜单栏连接

打开http://localhost:8000/admin/auth/menu,添加对应的menu

然后就能在后台管理页面的左侧边栏看到用户管理页面的链接入口了。

4.创建表格表单

剩下的工作就是构建数据表格和表单了，打开 app/Admin/Contollers/UserController.php,找到form()和grid()方法，然添加构建代码,更多详细使用请查看model-grid和model-form。

其它

laravel-admin 基于以下组件或者服务:

• Laravel
• AdminLTE
• Datetimepicker
• CodeMirror
• font-awesome
• moment
• Google map
• Tencent map
• bootstrap-fileinput
• jquery-pjax
• Nestable
• noty
• X-editable
• bootstrap-number-input