Laravel自带的后台laravel-admin安装过程问题和详解记录-摩杜云开发者社区

Laravel-admin可以快速构建一个简单的后台，方便快速开发。以下内容记录简单使用laravel-admin，以及遇到小错误的解决方法。Laravel-admin 依赖以下环境Nginx+PHP+MYSQL+Composer，需要提前装好(安装的Laravel-admin版本为1.8.19)，PHP、Composer需要设置好系统环境变量。

1.通过 Composer 安装Laravel框架

如果你的本地操作系统已经安装了 PHP 和 Composer，还可以直接通过 Composer 命令来安装 Laravel 应用，安装完成后，可以使用 Artisan CLI 命令 serve 启动 Laravel 本地开发服务器：

composer create-project laravel/laravel Laravel-demo

Laravel自带的后台laravel-admin安装过程问题和详解记录_Laravel

cd Laravel-demo

php artisan serve

Laravel自带的后台laravel-admin安装过程问题和详解记录_Laravel_02

浏览器打开http://127.0.0.1:8000/可以正常访问成功

Laravel自带的后台laravel-admin安装过程问题和详解记录_Laravel_03

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

2.新建Laravel数据库

使用数据库管理软件新建一个数据库：laravel（自己随意取名），数据库建好后，打开Laravel-demo目录，修改该目录下的.env文件，修改配置数据库参数:DB_DATABASE（数据库名），DB_USERNAME（数据库账号），DB_PASSWORD（数据库密码）

DB_CONNECTION=mysql

DB_HOST=127.0.0.1

DB_PORT=3306

DB_DATABASE=laravel

DB_USERNAME=root

DB_PASSWORD=root

3.通过 Composer 安装Laravel-admin

官方文档地址：https://laravel-admin.org/

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

composer require encore/laravel-admin:1.*

Laravel自带的后台laravel-admin安装过程问题和详解记录_Laravel-admin_04

然后运行下面的命令来发布资源：

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

Laravel自带的后台laravel-admin安装过程问题和详解记录_Laravel-admin_05

在该命令会生成配置文件config/admin.php，可以在里面修改安装的地址、数据库连接、以及表名，建议都是用默认配置不修改。

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

php artisan admin:install

Notice

运行这个命令的时候，如果遇到了下面的错误:

Laravel自带的后台laravel-admin安装过程问题和详解记录_Laravel-admin_06

SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 1000 bytes (SQL: alter tableusersadd uniqueusers_email_unique(email))

参考这个issue来解决 https://github.com/z-song/laravel-admin/issues/1541

上面的网站打不开就直接看这里解决方法:

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

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\Schema; //add fixed sql

class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        Schema::defaultStringLength(191); //add fixed sql
    }

    /**
     * Register any application services.
     *
     * @return void
     */
    public function register()
    {
        //
    }
}

再进入数据库管理软件将laravel数据库里面的表全删除，再执行命令

php artisan admin:install

Laravel自带的后台laravel-admin安装过程问题和详解记录_Laravel_07

如果没有遇到错误，则无需修改文件也无需执行命令。至此，Laravel-admin已经安装完成。运行命令php artisan serve，可以在浏览器打开：http://127.0.0.1:8000/admin/auth/login 访问进入后台。账号及密码为：admin。