简单使用Laravel-admin构建一个功能强大的后台管理

2019-02-17 18:53:42

围观(9444)

Laravel-admin可以快速构建一个功能强大的后台，方便快速开发。

以下内容记录简单使用Laravel-admin，以及遇到小错误的解决方法。

Laravel-admin 依赖以下环境需要提前装好(安装的Laravel-admin版本为1.5)

Apache+PHP+MYSQL (这个不作解释... 注意需要PHP 7+ 推荐使用phpstudy集成环境)
Laravel (5.5+)
Composer

以上环境如PHP/Composer需要设置好系统环境变量

先使用Composer命令安装Laravel ,命令如下(用cmd或者Git先进入到想要安装的目录)

composer create-project --prefer-dist laravel/laravel Laravel-admin 5.7.*

如果觉得安装速度慢，可以改一下镜像地址参考：https://pkg.phpcomposer.com/

安装完成即显示：

然后在安装时指定的目录会有一个Laravel-admin文件夹此时需要设置一下Apache 网站目录设置为Laravel-admin下的public

使用的是phpstudy集成环境，所以在phpstudy中点击[其他选项菜单]=>[站点域名管理] 设置内容：

接下来需要设置一下系统hosts，使用集成环境phpstudy可以在[其他选项菜单]=>[打开host]

也可以手动打开该文件，该文件路径为：

C:Windows\System32\driversetc\hosts

在hosts文件最底下添加一行代码:

127.0.0.1	www.laravel-admin.test

保存好文件，打开浏览器输入www.laravel-admin.test即可看到Laravel页面:

如果不能显示这个界面，请检查是否漏掉了上面某个步骤。

接下来需要设置Laravel的数据库

先使用浏览器打开localhost/phpmyadmin/ 此数据库管理系统是phpstudy自带了

使用账号/密码root登录进去

新建一个数据库：

数据库建好后，打开Laravel-admin目录，修改该目录下的.env文件，修改配置数据库参数:

接下来就是安装Laravel-admin，打开Git或者cmd指定到Laravel-admin目录下，然后输入以下代码(也可打开Laravel-admin官方参考官方文档安装)：

composer require encore/laravel-admin

完成后:

使用命令发布资源:

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

最后使用命令完成安装

php artisan admin:install

如果出现错误：

1   DoctrineDBALDriverPDOException::("SQLSTATE[42000]: Syntax error or access violation: 1071 Spec
ified key was too long; max key length is 1000 bytes")
      
  2   PDOException::("SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too lon
g; max key length is 1000 bytes")

解决方法:

修改laravel-admin/app/Providers目录下的AppServiceProvider.php文件:

代码:

use Illuminate\Support\Facades\Schema;
Schema::defaultStringLength(191);

再进入数据库管理系统 localhost/phpmyadmin/ 将laravel_admin数据库里面的表全删除

再执行命令:

php artisan admin:install

如果没有遇到错误，则无需修改文件也无需执行命令。

至此，Laravel-admin已经安装完成

可以在浏览器打开：www.laravel-admin.test/admin 访问进入后台。账号及密码为：admin

假如数据库中有一个文章表，如何使用Laravel-admin管理文章？

接下来简单使用Laravel-admin管理文章。

先在laravel_admin数据库建立一个文章表表取名为:Article，

需要的字段有:

id(设置为主键并自增),

title(文章标题,VARCHAT类型长度32),

content(文章内容,TEXT类型),

updated_at(修改时间,TIMESTAMP类型),

created_at(创建时间,TIMESTAMP类型)

--此处犯了个错误，表名不该使用大写开头，应该使用全小写(开发规范) 大家引以为戒。

此时打开后台，会发现都是英文，需要修改配置文件(laravel-admin目录下)config/app.php:

找到代码:

'locale' => 'en',

修改为:

'locale' => 'zh-CN',

此时打开后台依然会发现左侧导航存在英文

点击左侧导航中的[Admin]=>[Menu]，即可修改导航为中文(需要一个一个修改左侧导航)。

回到重点，需要创建一个菜单，为文章管理

此时刷新页面，会发现左侧导航有一个【文章管理】，如果点击【文章管理】会发现报404错误，这是因为没有设置路由。

打开文件(laravel-admin目录下)app/Admin/routes.php

添加一句代码:

$router->resource('/article', ArticleController::class);

进入laravel-admin目录下app/Admin/Controllers

复制控制器文件ExampleController.php为ArticleController.php

修改类名：

class ExampleController extends Controller

将类名修改为ArticleController

如:

class ArticleController extends Controller

创建文章表模型，在cmd或者Git使用命令：

php artisan make:model Article

此时会生成一个名为Article.php的文件并存放于laravel-admin目录下app目录中。

需要为此文件的Article类中添加代码:

protected $table = 'Article';

添加后Article.php文件的代码如:

<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Article extends Model
{
    protected $table = 'Article';
}

继续修改laravel-admin目录下app/Admin/Controllers/ArticleController.php文件

将所有写着YourModel的地方修改为Article

别忘了需要在文件顶部引入文章模型，引入代码:

use App\Article;

此时后台左侧导航的文章管理已经能正常打开不会报404错误

为了这个界面好看点，在app/Admin/Controllers/ArticleController.php文件的grid函数修改如下:

protected function grid()
{
    $grid = new Grid(new Article);

    $grid->id('ID')->sortable();
    $grid->title('文章标题');
    $grid->created_at('创建时间');
    $grid->updated_at('修改时间');

    return $grid;
}

此时刷新界面再点击右上角【新建】

需要修改form函数:

protected function form()
{
    $form = new Form(new Article);

    $form->text('title','文章标题');
    $form->textarea('content','文章内容');

    $form->display('id', '文章ID');
    $form->display('created_at', '创建时间');
    $form->display('updated_at', '修改时间');

    return $form;
}

此时再刷新页面，发现有了一些组件，可以正常写文章并提交保存到数据库。

返回到文章管理的页面，点击右侧【操作】中的“眼睛”按钮查看文章详情，发现并没有文章详情，这是因为需要修改detail函数:

protected function detail($id)
{
    $show = new Show(Article::findOrFail($id));

    $show->id('文章ID');
    $show->title('文章标题');
    $show->content('文章内容');
    $show->created_at('创建时间');
    $show->updated_at('修改时间');

    return $show;
}

laravel-admin目录下app/Admin/Controllers/ArticleController.php控制器全部代码:

<?php

namespace AppAdminControllers;

use App\Http\Controllers\Controller;
use Encore\Admin\Controllers\Has\Resource\Actions;
use Encore\Admin\Form;
use Encore\Admin\Grid;
use Encore\Admin\Layout\Content;
use Encore\Admin\Show;
use App\Article;

class ArticleController extends Controller
{
    use Has\Resource\Actions;

    /**
     * Index interface.
     *
     * @param Content $content
     * @return Content
     */
    public function index(Content $content)
    {
        return $content
            ->header('Index')
            ->description('description')
            ->body($this->grid());
    }

    /**
     * Show interface.
     *
     * @param mixed   $id
     * @param Content $content
     * @return Content
     */
    public function show($id, Content $content)
    {
        return $content
            ->header('Detail')
            ->description('description')
            ->body($this->detail($id));
    }

    /**
     * Edit interface.
     *
     * @param mixed   $id
     * @param Content $content
     * @return Content
     */
    public function edit($id, Content $content)
    {
        return $content
            ->header('Edit')
            ->description('description')
            ->body($this->form()->edit($id));
    }

    /**
     * Create interface.
     *
     * @param Content $content
     * @return Content
     */
    public function create(Content $content)
    {
        return $content
            ->header('Create')
            ->description('description')
            ->body($this->form());
    }

    /**
     * Make a grid builder.
     *
     * @return Grid
     */
    protected function grid()
    {
        $grid = new Grid(new Article);

        $grid->id('ID')->sortable();
        $grid->title('文章标题');
        $grid->created_at('创建时间');
        $grid->updated_at('修改时间');

        return $grid;
    }

    /**
     * Make a show builder.
     *
     * @param mixed   $id
     * @return Show
     */
    protected function detail($id)
    {
        $show = new Show(Article::findOrFail($id));

        $show->id('文章ID');
        $show->title('文章标题');
        $show->content('文章内容');
        $show->created_at('创建时间');
        $show->updated_at('修改时间');

        return $show;
    }

    /**
     * Make a form builder.
     *
     * @return Form
     */
    protected function form()
    {
        $form = new Form(new Article);

        $form->text('title','文章标题');
        $form->textarea('content','文章内容');

        $form->display('id', '文章ID');
        $form->display('created_at', '创建时间');
        $form->display('updated_at', '修改时间');

        return $form;
    }
}

至此，文章管理中的CRUD(增删查改)均实现。

但仔细看，后台中的新建文章的文章内容使用的是textarea而不是富文本编辑器。

官方文档有详细使用富文本编辑器的教程：https://laravel-admin.org/docs/zh/model-form-field-management

后续如果有需要再写富文本编辑器的文章吧。