安装

当前版本(1.5)需要安装PHP 7+Laravel 5.5, 如果你使用更早的版本,请参考文档: 1.4

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

  1. composer require encore/laravel-admin

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

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

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

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

  1. 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 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,之后大部分的后台开发编码工作都是在这个目录下进行。

  1. app/Admin
  2. ├── Controllers
  3. ├── ExampleController.php
  4. └── HomeController.php
  5. ├── bootstrap.php
  6. └── routes.php

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

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

app/Admin/Controllers目录用来存放后台控制器文件,该目录下的HomeController.php文件是后台首页的显示控制器,ExampleController.php为实例文件。

静态文件

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