推荐一个 Laravel admin 后台管理插件

如何优雅的写代码,我想是每位程序员的心声。自从15年初第一次接触 Laravel 4.2 开始,我就迷上使用 Laravel 框架了。我一直都想找个时间好好写写有关 Laravel 的使用文章,由浅入深的介绍 Laravel 框架。

今天通过使用 laravel-admin 插件,来简单说说怎么优雅的写 Laravel 代码。

创建 Laravel 项目

只要跟着官方文档走,创建一个 Laravel 项目还是很简单的:

// 使用 Composer 下载 Laravel 安装程序

composer global require "laravel/installer"

// 创建 web 项目

laravel new web

具体配置数据库等:略 安装 Laravel 看官网: https://d.laravel-china.org/docs/5.5/installation 如何安装 Composer,可以看看我之前的文章 一步一步搭建 PHP 服务器环境

安装 laravel-admin

laravel-admin 是一个可以快速帮你构建后台管理的工具,它提供的页面组件和表单元素等功能,能帮助你使用很少的代码就实现功能完善的后台管理功能。 注:当前版本(1.5)需要安装 PHP 7+和 Laravel 5.5

看看 laravel-admin 的特性:

  • 内置用户和权限系统
  • model-grid 支持快速构建数据表格
  • model-form 支持快速构建数据表单
  • model-tree 支持快速构建树状数据
  • 内置 40+ 种 form 元素组件、以及支持扩展组件
  • 支持 Laravel 的多种模型关系
  • mysql、mongodb、pgsql 等多数据库支持
  • 支持引入第三方前端库
  • 数据库和 artisan 命令行工具的 web 实现
  • 支持自定义图表
  • 多种常用 web 组件
  • 支持本地和 oss 文件上传

有了这些功能,开发一个后台管理系统就变得相对简单了。

安装插件:

composer require encore/laravel-admin "1.5.*"

// 发布资源:

php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"

// 安装

php artisan admin:install

简单的三条命令,即可配置好一个简单的后台管理系统,账号和密码都是 admin

代码主要集中在\APP\Admin中

默认系统提供一个 Dashboard 界面:

<?php

namespace App\Admin\Controllers;
use App\Http\Controllers\Controller;
use Encore\Admin\Facades\Admin;
use Encore\Admin\Layout\Column;
use Encore\Admin\Layout\Content;
use Encore\Admin\Layout\Row;

class HomeController extends Controller {    
    public function index() {        
        return Admin::content(function (Content $content) {
            $content->header('Test Dashboard');            
            
            $content->description('Description...');            
            
            $content->row(Dashboard::title());            
            
            $content->row(function (Row $row) {                
                $row->column(4, function (Column $column) {                    
                    $column->append(Dashboard::environment());
                });                
                    
                $row->column(4, function (Column $column) {                    
                    $column->append(Dashboard::extensions());
                });                
                
                $row->column(4, function (Column $column) {   
                    $column->append(Dashboard::dependencies());
                });
            });
        });
    }
}

结合界面和代码,可以看出界面主要分成这么几个部分:header、description、两个 row,后一个 row 包含三个 column 模块;具体的代码放在 Dashboard 代码中,如下:

<?php

namespace Encore\Admin\Controllers;

use Encore\Admin\Admin;

class Dashboard{   
     /**
      * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public static function title() {        
         return view('admin::dashboard.title');
    }    
         
     /**
     * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public static function environment() {        
        $envs = [
            ['name' => 'PHP version',       'value' => 'PHP/'.PHP_VERSION],
            ['name' => 'Laravel version',   'value' => app()->version()],
            ['name' => 'CGI',               'value' => php_sapi_name()],
            ['name' => 'Uname',             'value' => php_uname()],
            ['name' => 'Server',            'value' => array_get($_SERVER, 'SERVER_SOFTWARE')],

            ['name' => 'Cache driver',      'value' => config('cache.default')],
            ['name' => 'Session driver',    'value' => config('session.driver')],
            ['name' => 'Queue driver',      'value' => config('queue.default')],

            ['name' => 'Timezone',          'value' => config('app.timezone')],
            ['name' => 'Locale',            'value' => config('app.locale')],
            ['name' => 'Env',               'value' => config('app.env')],
            ['name' => 'URL',               'value' => config('app.url')],
        ];        
        return view('admin::dashboard.environment', compact('envs'));
    }    
        
    /**
     * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public static function extensions() {        
        $extensions = [            
            'helpers' => [                
                'name' => 'laravel-admin-ext/helpers',                
                'link' => 'https://github.com/laravel-admin-extensions/helpers',                
                'icon' => 'gears',
             ],            
            'log-viewer' => [                
                'name' => 'laravel-admin-ext/log-viewer',                
                'link' => 'https://github.com/laravel-admin-extensions/log-viewer',                
                'icon' => 'database',
            ],            
            'backup' => [                
                'name' => 'laravel-admin-ext/backup',                
                'link' => 'https://github.com/laravel-admin-extensions/backup',                
                'icon' => 'copy',
            ],            
             'config' => [                
                 'name' => 'laravel-admin-ext/config',                
                 'link' => 'https://github.com/laravel-admin-extensions/config',                
                 'icon' => 'toggle-on',
            ],            
             'api-tester' => [                
                 'name' => 'laravel-admin-ext/api-tester',                
                 'link' => 'https://github.com/laravel-admin-extensions/api-tester',                
                 'icon' => 'sliders',
            ],            
             'media-manager' => [                
                 'name' => 'laravel-admin-ext/media-manager',                
                 'link' => 'https://github.com/laravel-admin-extensions/media-manager',                
                 'icon' => 'file',
            ],           
             'scheduling' => [                
                 'name' => 'laravel-admin-ext/scheduling',                
                 'link' => 'https://github.com/laravel-admin-extensions/scheduling',                
                 'icon' => 'clock-o',
            ],            
             'reporter' => [                
                 'name' => 'laravel-admin-ext/reporter',                
                 'link' => 'https://github.com/laravel-admin-extensions/reporter',                
                 'icon' => 'bug',
            ],            
             'translation' => [                
                 'name' => 'laravel-admin-ext/translation',                
                 'link' => 'https://github.com/laravel-admin-extensions/translation',                
                 'icon' => 'language',
            ],
        ];       
        foreach ($extensions as &$extension) {            
            $name = explode('/', $extension['name']);            
            $extension['installed'] = array_key_exists(end($name), Admin::$extensions);
        }        
        return view('admin::dashboard.extensions', compact('extensions'));
    }    
    
    /**
     * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public static function dependencies() {        
        $json = file_get_contents(base_path('composer.json'));        
        $dependencies = json_decode($json, true)['require'];        
        return view('admin::dashboard.dependencies', compact('dependencies'));
    }
}

这样我们就把代码分块的组织在一起。具体布局类看:class Content implements Renderable

其它的静态资源文件放在 /public/vendor/laravel-admin 目录下

更多内容参考 laravel-admin 官网: http://laravel-admin.org/docs/#/zh/

写一个 demo

有了这个 laravel-admin 插件,要写一个 movies 列表,只需要几个命令行就可以完成了,非常简单:

1.建立模型,并创建 Migrations:

php artisan make:model Movie -m 

2.在 Migrations,增加一个字段:name

<?php

use Illuminate\Support\Facades\Schema;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Database\Migrations\Migration;

class CreateMoviesTable extends Migration{    
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('movies', function (Blueprint $table) {            
            $table->increments('id');            
            $table->string('name', 50)->unique();            
            $table->timestamps();
        });
    }    
    
    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down() {
        Schema::dropIfExists('movies');
    }
}

3.运行 Migrations,创建对应数据库:

php artisan migrate

4.有了数据表,就需要往表里插入 fake 数据,用于测试

// 使用该插件创建 fake 数据

composer require fzaninotto/faker 

5.建立 Seeder

php artisan make:seeder MovieTableSeeder 

在该类中,建立1000条假数据:

<?phpuse Illuminate\Database\Seeder;class MovieTableSeeder extends Seeder{    /**
     * Run the database seeds.
     *
     * @return void
     */
    public function run()
    {        //
        $faker = Faker\Factory::create();        
        for($i = 0; $i < 1000; $i++) {
            App\Movie::create([                
                'name' => $faker->name
            ]);
        }
    }
}

运行:

php artisan db:seed --class=MovieTableSeeder 

是不是很简单,数据表直接填充 1000 条假数据:

6.建立资源 Controller

php artisan admin:make MovieController --model=App\\Movie 

这样就直接有了基础的增删改查和 movie 列表功能的 Controller 了。

7.建立 route

$router->resource('movies', MovieController::class);

8.加入到 admin 的 menu 中

其中路径处需要注意的是:

其中uri填写不包含路由前缀的的路径部分,比如完整路径是http://localhost:8000/admin/demo/users, 那么就填demo/users,如果要添加外部链接,只要填写完整的url即可,比如http://laravel-admin.org/.

上图也是加了左侧 movies 菜单的效果。

这就完成了简单的 movie 资源的后台管理了,在浏览器输入链接: http://web.app/admin/movies

就能看到一个较为完整的 movie 列表:

具体有新增、导出、筛选、操作 (删除)、撤销、分页、修改、删除等常规功能,如下几个截图:

总结

有了 Laravel 和 laravel-admin,基本不用写什么代码,敲敲几个命令就可以完成一个「功能比较齐全」的资源操作后台。极大的方便了我们的开发。

总体命令行和代码如下

php artisan make:model Movie -m

php artisan migrate

composer require fzaninotto/faker

php artisan make:seeder MovieTableSeeder

php artisan db:seed --class=MovieTableSeeder

php artisan admin:make MovieController --model=App\\Movie

$router->resource('movies', MovieController::class);

框架和开源插件,有时候确实是能方便我们开发,所以寻找优质的框架和开源库也是促进我们生产力的。

laravel-admin 代码是如何组织的,可以具体参考网站开发。先根据官网的介绍,利用好 laravel-admin,然后学习它的源码和代码设计,最后取其精华,为你所用。

「完」


原文发布于微信公众号 - coding01(coding01)

原文发表时间:2017-10-21

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏小古哥的博客园

gulp的安装和使用

安装nodejs -> 全局安装gulp -> 项目安装gulp以及gulp插件 -> 配置gulpfile.js -> 运行任务 1、去nodejs官网安装n...

29850
来自专栏Python与爬虫

爬虫入门到精通-网页的下载

本文章属于爬虫入门到精通系统教程第四讲 在爬虫入门到精通第二讲中,我们了解了HTTP协议 http://mp.weixin.qq.com/s?__biz=M...

29950
来自专栏IT可乐

HTML中的超链接

超链接:也叫URL(Uniform Resource Locator),就是统一资源定位器。一般效果是我们点击网页上某个地方,网页会自动跳转到另外一个地方。 一...

39650
来自专栏Java开发

CentOS 6.X 安装VNC Server实现图形化访问

48920
来自专栏陈仁松博客

UWP基础教程 - App多语言支持

UWP实现本地化非常简单,所谓本地化表现最为直观的就是UI上文字和布局方式了,针对文字,提供不同的语言资源文件即可,而针对布局方式,比如在 阿拉伯地区 阅读顺序...

37960
来自专栏前端儿

前端代码乱糟糟?是时候引入代码质量检查工具了

为了统一团队的代码规范,除了一纸规范说明之外,还需要引入工具进行限制。虽说工具并不能完全实现规范中的规则,但至少能够在一定程度上缓解代码不统一的局面。

40010
来自专栏Java技术分享

基于Metronic的Bootstrap开发框架经验总结(7)--数据的导入、导出及附件的查看处理

在很多系统模块里面,我们可能都需要进行一定的数据交换处理,也就是数据的导入或者导出操作,这样的批量处理能给系统用户更好的操作体验,也提高了用户录入数据的效率。我...

27670
来自专栏Youngxj

EMLOG蜘蛛记录插件2.0

32230
来自专栏coder修行路

Go实现海量日志收集系统(二)

一篇文章主要是关于整体架构以及用到的软件的一些介绍,这一篇文章是对各个软件的使用介绍,当然这里主要是关于架构中我们agent的实现用到的内容 关于zookeep...

1.8K100
来自专栏码生

Vue2.0 新手完全填坑攻略——从环境搭建到发布

Homebrew 1.0.6(Mac)、Node.js 6.7.0、npm 3.10.3、webpack 1.13.2、vue-cli 2.4.0、Atom 1...

21850

扫码关注云+社区

领取腾讯云代金券