安装 Laravel-Admin

在window中安装 Laravel-Admin整理的笔记

目录

前提条件

安装步骤

[准备 Laravel 项目](#准备 Laravel 项目)

创建数据库

[安装 Laravel 项目](#安装 Laravel 项目)

[创建 Laravel 8 项目](#创建 Laravel 8 项目)

[配置 Laravel 数据库](#配置 Laravel 数据库)

[安装 laravel-admin](#安装 laravel-admin)

发布资源文件

执行数据库迁移

执行迁移出错

解决方案：

[访问 laravel-admin 后台](#访问 laravel-admin 后台)

访问后台地址

网站首页

登录页

后台首页

总结

---

前提条件

在开始安装前，请先在 phpstudy_pro 中确认以下环境满足要求：

PHP 版本 ≥ 7.3（推荐 7.4 或 8.0，laravel-admin 最新版对 PHP 8.1+ 也兼容）

已启用 PHP 扩展：fileinfo、openssl、PDO、mbstring、tokenizer、XML、ctype、JSON

已配置好 MySQL 数据库

已开启 composer （phpstudy_pro 一般自带，也可手动配置）

安装步骤

准备 Laravel 项目

首先需要有一个基础的 Laravel 项目（laravel-admin 是基于 Laravel 的后台扩展）。

打开 phpstudy_pro，启动对应的 PHP 和 MySQL 服务。

点击 phpstudy_pro 面板的「网站」→「创建网站」，填写：

域名：例如 local.admin.com (也可以不设置域名 直接运行项目)

根目录：例如 D:\phpstudy_pro\WWW\laravel

PHP 版本：选择 7.4 或 8.0

创建数据库

数据库：创建一个新的数据库 laravel

安装 Laravel 项目

打开 phpstudy_pro 的「终端」，进入项目根目录：

cd D:\phpstudy_pro\WWW

创建 Laravel 8 项目

命令如下：

composer create-project --prefer-dist laravel/laravel:8.*

配置 Laravel 数据库

打开项目根目录下的 .env 文件，修改数据库配置：

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel  # 数据库名
DB_USERNAME=root   # 用户名
DB_PASSWORD=root   # 密码

安装 laravel-admin

在终端中执行安装命令（laravel-admin 适配 Laravel 8+）：

composer require encore/laravel-admin:^1.8

发布资源文件

发布 laravel-admin 的资源文件，命令如下：

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

执行数据库迁移

创建 laravel-admin 所需的数据表：

php artisan admin:install

执行迁移出错

SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too
long; max key length is 1000 bytes (SQL: alter table `users` add unique `users_e
mail_unique`(`email`))

解决方案：

原因是 MySQL 数据库的默认字符集（utf8）和索引长度限制导致的。

打开项目根目录下的 app/Providers/AppServiceProvider.php 文件，在 boot() 方法中添加索引长度限制的代码：

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
// 新增这行，引入 Schema 类
use Illuminate\Support\Facades\Schema;

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

    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        // 新增这行，设置默认字符串长度
        Schema::defaultStringLength(191);
    }
}

执行完成后，会自动创建 admin_users 等数据表。

若已经执行数据库迁移报错后，可以把数据表删除后重新执行。

访问 laravel-admin 后台

启动 Laravel 内置服务器（或直接通过配置的域名访问）：

php artisan serve

访问后台地址

内置服务器：http://127.0.0.1:8000/admin

自定义域名：http://local.laravel.test/admin

默认登录账号：admin，默认密码：admin。

网站首页

登录页

后台首页

总结

在window中安装 Laravel-Admin到访问后台整体的笔记