安装

未匹配的标注

安装

环境

  • PHP >= 7.1
  • Laravel 5.5.0 ~ 9.*
  • Fileinfo PHP Extension

开始安装

首先需要安装laravel框架,如已安装可以跳过此步骤。如果您是第一次使用laravel,请务必先阅读文档 安装《Laravel 9 中文文档》

composer create-project --prefer-dist laravel/laravel 项目名称 9.*
# 或
composer create-project --prefer-dist laravel/laravel 项目名称

安装完laravel之后需要修改.env文件,设置数据库连接设置正确

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=dcat-admin
DB_USERNAME=root
DB_PASSWORD=

安装dcat-admin

cd {项目名称}

composer require dcat/laravel-admin:"2.*" -vvv

如果上一步出现报错,则更改composer.json的参数minimum-stability的值为dev

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

php artisan admin:publish

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

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

{tip} 执行这一步命令可能会报以下错误Specified key was too long ... 767 bytes,如果出现这个报错,请在app/Providers/AppServiceProvider.php文件的boot方法中加上代码\Schema::defaultStringLength(191);,然后删除掉数据库中的所有数据表,再重新运行一遍php artisan admin:install命令即可。

php artisan admin:install

上述步骤操作完成之后就可以配置web服务了,注意需要把web目录指向public目录!如果用的是nginx,还需要在配置中加上伪静态配置

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

启动服务后,在浏览器打开 http://localhost/admin,使用用户名 admin 和密码 admin登陆。

生成的文件

安装完成之后,会在项目目录中生成以下的文件:

配置文件

安装完成之后,dcat-admin所有的配置都在config/admin.php文件中。

后台项目文件

安装完成之后,后台的安装目录为app/Admin,之后大部分的后台开发编码工作都是在这个目录下进行。

app/Admin
├── Controllers
│   ├── AuthController.php
│   └── HomeController.php
├── Metrics
│   └── Examples
│       ├── NewDevices.php
│       ├── NewUsers.php
│       ├── ProductOrders.php
│       ├── Sessions.php
│       ├── Tickets.php
│       └── TotalUsers.php
├── bootstrap.php
└── routes.php
  1. app/Admin/routes.php文件用来配置后台路由。
  2. app/Admin/bootstrap.phpdcat-admin的启动文件, 使用方法请参考文件里面的注释.
  3. app/Admin/Controllers目录用来存放后台控制器文件,该目录下的HomeController.php文件是后台首页的显示控制器,AuthController.php为后台管理员登录鉴权控制器。
  4. app/Admin/Metrics/Examples里面存放的是数据统计卡片(Metric Card)的示例代码.

静态文件

后台所需的前端静态文件在/public/vendor/dcat-admin目录下。

数据表迁移文件

对应的数据表迁移文件在/database/migrations目录下。

语言包

语言包文件在/resources/lang目录下。

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
贡献者:6
讨论数量: 7
发起讨论 查看所有版本


福寿绵绵
laravel10安装dcat-admin
0 个点赞 | 15 个回复 | 分享 | 课程版本 2.x
wilson_tw_0423
安裝完成dcat admin,但實際運行後台時沒有樣式
0 个点赞 | 9 个回复 | 问答 | 课程版本 2.x
zz52998
安装Dcat Admin 使用算SQL Server 数据库报错
0 个点赞 | 3 个回复 | 问答 | 课程版本 2.x
yanglp
laravel7+ Dcat 部署到阿里云虚拟主机,无法访问!!!
0 个点赞 | 3 个回复 | 问答 | 课程版本 2.x
h2346760
[请教][dcat-admin]安装过程中提示出现这个问题
0 个点赞 | 2 个回复 | 问答 | 课程版本 2.x
张惠众
PHP artisan admin:publish 资源找不到
0 个点赞 | 2 个回复 | 问答 | 课程版本 2.x
张惠众
Laravel - admin 安装 1071 Specified key was too long;
0 个点赞 | 1 个回复 | 分享 | 课程版本 2.x