README

Voyager API - Laravel 示例

Laravel 管理员 & BREAD 系统（支持 Passport 和 Swagger）

工作示例

您可以在以下位置尝试 Laravel 示例：https://joy-voyager-api.herokuapp.com/api/documentation。

安装步骤

1. 克隆仓库/使用 Composer 安装

您可以使用以下命令克隆/安装 Voyager API Laravel 示例：

git clone git@github.com:rxcod9/joy-voyager-api-laravel-demo.git
cd joy-voyager-api-laravel-demo

# OR Install using composer
composer create-project joy/voyager-api-laravel-demo
cd voyager-api-laravel-demo

2. 添加数据库凭证 & APP_URL

接下来，请确保创建一个新的数据库并将您的数据库凭证添加到您的 .env 文件中

DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

您还需要更新 .env 文件中 APP_URL 变量内的网站 URL

APP_URL=https://:8000

3. 运行安装程序

最后，我们可以安装 Voyager。您可以选择是否使用示例数据。示例数据将包括 1 个管理员账户（如果数据库中不存在用户），1 个示例页面，4 个示例帖子，2 个类别和 7 个设置。

要无示例数据安装 Voyager，请运行

php artisan voyager:install

如果您喜欢带有示例数据的安装，请运行

php artisan voyager:install --with-dummy

要重新生成 Swagger 文档，请运行

php artisan joy-voyager-api:l5-swagger:generate

一切就绪！

使用 php artisan serve 启动本地开发服务器，并访问 https://:8000/admin。

要检查 Swagger API 文档功能，请访问 https://:8000/api/documentation。

创建管理员用户

如果您选择了示例数据，应该已经为您创建了以下登录凭证的用户

电子邮件： admin@admin.com
密码： password

注意：请注意，只有当数据库中没有当前用户时，才会创建示例用户。

如果您没有选择示例用户，您可能希望将管理员权限分配给现有用户。这可以通过运行此命令轻松完成

php artisan voyager:admin your@email.com

如果您没有安装示例数据并且希望创建新的管理员用户，可以传递 --create 标志，如下所示

php artisan voyager:admin your@email.com --create

然后您将提示输入用户的名称和密码。

joy / voyager-api-laravel-demo

维护者

详细信息