README

安装

composer require laravel-vue-admin

配置

添加提供者到config/app.php。

'providers' => [

    //...

    Tymon\JWTAuth\Providers\LaravelServiceProvider::class,
    Spatie\Permission\PermissionServiceProvider::class,
    Cameron\Admin\AdminServiceProvider::class,
]

发布资源

php artisan vendor:publish --force
// 选择发布Tymon\JWTAuth\Providers\LaravelServiceProvider和Cameron\Admin\AdminServiceProvider

数据库配置

在数据库中新好数据库，在.env中进行配置

...
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=123456
...

配置config/auth.php

// 在guards中增加admin
    'guards' => [
        'admin' => [
            'driver' => 'jwt',
            'provider' => 'admin_users',
        ],
       
    ],
...
// 在providers中增加admin_users
    'providers' => [
        'admin_users' => [
             'driver' => 'eloquent',
             'model' => Cameron\Admin\Models\Auth\AdminUser::class,
                ],
    ]

导入数据

运行如下命令导入后台数据表

php artisan admin:import

生成jwt秘钥

php artisan jwt:secret

配置中间件

需要在app/Http/Kernel.php中增加如下中间件

 // 1. 一定要注释掉$middleware中将空字符串转换为null的中间件
    protected $middleware = [
        \App\Http\Middleware\TrustProxies::class,
        \Fruitcake\Cors\HandleCors::class,
        \App\Http\Middleware\CheckForMaintenanceMode::class,
        \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
        \App\Http\Middleware\TrimStrings::class,
        //注释这一行↓
//        \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
    ];

 // 2. 在$middlewareGroups数组中的api下面增加
   ...
'api' => [
    \Cameron\Admin\Middleware\LogOperation::class,
],
...
 // 3. 在$routeMiddleware增加如下中间件
...
    'service' => \Cameron\Admin\Middleware\HasService::class,
    'permission' => \Cameron\Admin\Middleware\CheckPermission::class,
...

命令

一键生成命令

php artisan admin:generate table_name --model=TableName --module=Admin --view --force

--model 命名模型
--module 模块名称，如Admin、Api
--view 此参数存在表示生成视图文件，在resources/page/view下
--force 此参数存在则表示强制覆盖

重置管理员密码

php artisan admin:password account password
// 如
php artisan admin:password admin 123456

测试运行

需要在数据库中创建一个数据表，如test，数据迁移如下：

Schema::create('test', function (Blueprint $table) {
    $table->id();
    $table->string('name', '15');
    $table->string('status')->comment('状态:0=否,1=是');
    $table->timestamps();
});

迁移数据

php artisan migrate

运行生成命令

php artisan admin:generate test --model=Test

在routes/admin.php中会生成对应的路由，需要给它们加上service中间件，建议放在group下面，就不用每一个都写一个->middleware('service')，可以参考vendor/frey/laravel-vue-admin/routes/route.php路由配置，例：

Route::middleware(['service'])->group(function() {
    // Test
    Route::resource('test', 'TestController');

});

permission中间件为权限验证中间件，使用时需要传入守卫名称，如permission:admin，每一个路由都是一个操作，他们的标识符为路由名称。资源路由默认以“接口名称.index”形式作为路由名称。

浏览器访问: http://yourdomain.php/admin/test 就可以看到效果了。

文件系统设置

在.env里面配置文件系统驱动

FILESYSTEM_DRIVER=public

然后运行命令

php artisan storage:link

其他配置

jwt默认生命周期为1小时，也就是60分钟，如果想要调整，需要在.env中配置

# 单位为分钟
JWT_TTL=1440

前端

前端视图页面放在resources/page里面，需要在根目录中的.env中加入如下配置：

# 接口基础路径
VUE_APP_BASE_API=/admin
# 图片显示域名
VUE_APP_ASSETS_URL=http://yourdomain.com/

运行：

npm install
npm run dev

代理配置在根目录下的vue.config.js中，可以运行npm run build:prod编译，需要在routes/web.php 中修改路由，

Route::get('/', function () {
    return view('index');
});

编译之后就可以通过访问域名来访问后台了。

组件使用

主要的两大组件为：PowerfulTable、PowerfulForm。一个用于表格显示，一个用于表单显示。他们位于resources/page/components下，应用参考views/auth或者views/system页面组件。

meilunzhi / laravel-vue-admin

Maintainers

Details