安装

完成安装

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

composer require encore/laravel-admin:2.*

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

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

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

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

php artisan admin:install
Notice

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

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

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

生成的文件

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

配置文件

安装完成之后,laravel-admin所有的配置都在config/admin.php文件中,其中配置项详情请参考配置文件

后台应用文件

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

app/Admin
├── Controllers
│   ├── AuthController.php
│   ├── ExampleController.php
│   └── HomeController.php
├── bootstrap.php
└── routes.php

app/Admin/routes.php文件用来配置后台路由。

app/Admin/bootstrap.phplaravel-admin的启动文件, 使用方法请参考文件里面的注释.

app/Admin/Controllers目录用来存放后台控制器文件,该目录下的:

  • HomeController.php文件是后台首页默认的显示控制器。
  • AuthController.php文件是后台的登录认证控制器,可以在这里覆盖父类方法,来修改登录页,或者修改登录逻辑。
  • ExampleController.php为示例文件。

前端静态资源文件

管理后台所需的前端静态文件发布在/public/vendor/laravel-admin目录下.