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

举报
lxw1844912514 发表于 2022/03/27 03:54:50 2022/03/27
【摘要】 如何优雅的写代码,我想是每位程序员的心声。自从15年初第一次接触 Laravel 4.2 开始,我就迷上使用 Laravel 框架了。我一直都想找个时间好好写写有关 Laravel 的使用文章,由浅入深的介绍 Laravel 框架。 今天通过使用 laravel-admin 插件,来简单说说怎么优雅的写 ...

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

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

创建 Laravel 项目

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


     
  1. // 使用 Composer 下载 Laravel 安装程序
  2. 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 文件上传

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

安装插件:


     
  1. composer require encore/laravel-admin "1.5.*"
  2. // 发布资源:
  3. php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider" // 安装 php artisan admin:install

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

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

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


     
  1. <?php
  2. 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 代码中,如下:


     
  1. <?php
  2. 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


     
  1. <?php
  2. 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 数据,用于测试


     
  1. // 使用该插件创建 fake 数据
  2. composer require fzaninotto/faker

5.建立 Seeder

php artisan make:seeder MovieTableSeeder 
    

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


     
  1. <?php
  2. use 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,基本不用写什么代码,敲敲几个命令就可以完成一个「功能比较齐全」的资源操作后台。极大的方便了我们的开发。

总体命令行和代码如下


     
  1. php artisan make:model Movie -m
  2. php artisan migrate
  3. composer require fzaninotto/faker
  4. php artisan make:seeder MovieTableSeeder
  5. php artisan db:seed --class=MovieTableSeeder
  6. php artisan admin:make MovieController --model=App\Movie
  7. $router->resource('movies', MovieController::class);

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

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



作者:Coding01
链接:https://www.jianshu.com/p/6c73290e1a0c
來源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

文章来源: blog.csdn.net,作者:lxw1844912514,版权归原作者所有,如需转载,请联系作者。

原文链接:blog.csdn.net/lxw1844912514/article/details/100028146

【版权声明】本文为华为云社区用户转载文章,如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。