如何使用虚拟数据在现有项目上安装 Voyager - Shell / Bash

Voyager是一个基于Laravel的开源软件，可以为Laravel项目提供优雅的管理面板，用于管理数据库、文件、菜单等。本文将介绍如何在现有Laravel项目中使用虚拟数据安装Voyager。

安装前的准备

在使用虚拟数据安装Voyager之前，您需要先满足以下条件：

• 确保您的项目使用的是Laravel 5.4以上版本。
• 确保您的项目已经有了可以正常运行的数据库。
• 确保您具备使用Composer和命令行工具的基本能力。

安装Voyager

1. 打开终端或命令行工具，进入您的Laravel项目目录。
2. 执行以下命令安装Voyager：

composer require tcg/voyager

3. 执行以下命令，发布Voyager的资源文件：

php artisan vendor:publish --provider="TCG\Voyager\VoyagerServiceProvider"

4. 执行以下命令，生成Voyager的配置文件：

php artisan voyager:install

5. 执行以下命令，开启Voyager的数据库迁移：

php artisan migrate

6. 执行以下命令，启动Voyager服务：

php artisan serve

7. 在浏览器中访问以下链接：

http://localhost:8000/admin

使用虚拟数据

使用虚拟数据可以为您的项目提供一些测试数据和演示数据，以方便您熟悉Voyager的使用和功能。以下是使用虚拟数据的步骤。

1. 执行以下命令，安装Faker库：

composer require --dev fakerphp/faker

2. 创建一个虚拟数据生成器。可以在Laravel的命令行中创建一个Artisan命令来实现这一点。执行以下命令，创建一个名为 “VoyagerDemoDataSeeder” 的Seeder：

php artisan make:seeder VoyagerDemoDataSeeder

3. 在 VoyagerDemoDataSeeder.php 文件中添加以下代码段：

use \Faker\Factory as Faker;
use TCG\Voyager\Models\User;

class VoyagerDemoDataSeeder extends Seeder
{
    public function run()
    {
        $faker = Faker::create();
        $user = User::where('email', 'admin@admin.com')->firstOrFail();

        for ($i = 0; $i < 100; $i++) {
            // 创建一个新的文章
            $post = new \TCG\Voyager\Models\Post();
            $post->title = $faker->sentence();
            $post->body = $faker->paragraphs(5, true);
            $post->excerpt = $faker->paragraph();
            $post->status = 'PUBLISHED';
            $post->author_id = $user->id;
            $post->save();

            // 添加一个标签到文章
            $tag = new \TCG\Voyager\Models\Tag();
            $tag->name = $faker->word();
            $tag->save();
            $tag->posts()->attach($post->id);

            // 添加一个分类到文章
            $category = new \TCG\Voyager\Models\Category();
            $category->name = $faker->word();
            $category->save();
            $category->posts()->attach($post->id);
        }
    }
}

4. 执行以下命令，运行Seeder来创建虚拟数据：

php artisan db:seed --class=VoyagerDemoDataSeeder

5. 在Voyager的管理面板中查看虚拟数据：访问 http://localhost:8000/admin/posts ，您将看到您创建的虚拟文章。

总结

现在，您已经可以在您的现有Laravel项目中安装并使用Voyager，并使用虚拟数据来快速了解Voyager的功能和使用方法。如果您想了解更多有关Voyager的信息，请访问其官方文档：https://voyagerdocs.github.io/docs/。