安装 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 的「终端」,进入项目根目录:

bash 复制代码
cd D:\phpstudy_pro\WWW

创建 Laravel 8 项目

命令如下:

bash 复制代码
composer create-project --prefer-dist laravel/laravel:8.*

配置 Laravel 数据库

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

bash 复制代码
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+):

bash 复制代码
composer require encore/laravel-admin:^1.8

发布资源文件

发布 laravel-admin 的资源文件,命令如下:

bash 复制代码
php artisan vendor:publish --provider="Encore\Admin\AdminServiceProvider"

执行数据库迁移

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

bash 复制代码
php artisan admin:install
执行迁移出错
bash 复制代码
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() 方法中添加索引长度限制的代码:

bash 复制代码
<?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 内置服务器(或直接通过配置的域名访问):

bash 复制代码
php artisan serve

访问后台地址

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

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

默认登录账号:admin,默认密码:admin。

网站首页

登录页

后台首页

总结

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

相关推荐
辛迪聊物业数字化3 小时前
智慧物业管理平台架构实践:从SaaS物业云到商管系统的全模块落地
大数据·微服务·php
右耳朵猫AI8 小时前
PHP周刊2026W38 | Laravel AI可观测、Symfony三版本、Webhook零信任、事件溯源架构
后端·php·laravel
专业程序开发源8 小时前
springboot篮球联赛管理系统13635-计算机课程设计、毕业设计
vue.js·spring boot·后端·python·django·php·课程设计
子非鱼a8 小时前
【WEB】cat flag
php
4SAPI9 小时前
大模型 API 聚合平台选型指南:企业与个人用户的接入架构、稳定性与成本评估
人工智能·php·agent
PHP实战开发录10 小时前
PHP Session为什么会拖慢并发请求
系统架构·php·开发
闲云野鹤在人间1 天前
docker 入门 | 第5章 网络详解
网络·docker·架构·华为云·php
PHP实战开发录1 天前
MySQL连接数为什么会打满
系统架构·php·开发
VXbishe1 天前
【课程设计】基于SpringBoot的乡村政务服务系统的设计与实现-计算机毕设77011
javascript·vue.js·spring boot·python·php·课程设计·政务
aixingpan1 天前
aixingpan.cn API开发文档:api_docs_bichart_natalvssolar_return2接口指南
前端·php