README

是基于 Laravel 开发的 Admin (https://github.com/osi/airs) 的后端服务。

要求

• Laravel >= 7.0.0
• PHP >= 7.2.0

安装

首先安装laravel,并且确保你配置了正确的数据库连接。

composer require osi/airs

然后运行以下命令来发布资源

php artisan airs:install

命令执行成功后会生成配置文件，数据迁移和构建SPA的文件。

修改 app/Http/Kernel.php ：

class Kernel extends HttpKernel
{
    protected $routeMiddleware = [
        ...
        'airs.permission' => \Osi\Airs\Http\Middleware\Authenticate::class,
    ];

    protected $middlewareGroups = [
            ...
            'api' => [
                ...
                \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
            ],
        ];
}

执行数据迁移和数据填充

php artisan migrate

php artisan db:seed --class="Osi\Airs\Database\AirsTableSeeder"

后台登录账号 admin ，密码 secret

路由中间件

• auth:sanctum 用于鉴权
• .permission 权限验证

airs.php 可选配置

return [
    'guards' => [
        // laravel-permission 相对应的 guard
        'admin' => [
            'model' => \Osi\Airs\Models\AdminUser::class, //登录鉴权的模型
            'login_fields' => [	// 登录验证的字段，支持多个
                'username',
            ],
            'conditions' => [ // 登录验证的额外条件
                ['status', '=', 1]
            ]
        ]
    ]
];

依赖扩展包

• spatie/laravel-permission
• laravel/sanctum

常见错误

• csrf token 缺失或错误，请修改 sanctum.php 中的 stateful，例如 vite 使用的 localhost:3000 去除即可。更多详细请访问laravel/sanctum文档。