Voyager管理后台系统安装指南

Voyager管理后台系统安装指南

voyager thedevdojo/voyager: 是一个基于 Laravel 框架的后台管理系统，支持多种数据源和插件扩展。该项目提供了一个简单易用的后台管理系统，可以方便地实现数据的查询和管理，同时支持多种数据库和插件扩展。 项目地址: https://gitcode.com/gh_mirrors/vo/voyager

Voyager是一个基于Laravel框架开发的现代化后台管理系统，它提供了直观的用户界面和强大的功能，能够帮助开发者快速构建后台管理功能。本文将详细介绍Voyager的安装过程，包括基础安装和高级安装两种方式。

基础安装流程

1. 安装前提条件

在开始安装Voyager之前，请确保您已经：

• 安装了PHP 7.3或更高版本
• 安装了Composer依赖管理工具
• 配置好了Laravel开发环境
• 准备好了一个可用的MySQL数据库

2. 安装Voyager包

首先，通过Composer将Voyager添加到您的Laravel项目中：

composer require tcg/voyager

3. 配置环境变量

在项目的.env文件中配置数据库连接和应用URL：

APP_URL=http://localhost
DB_HOST=localhost
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password

4. 执行安装命令

Voyager提供两种安装方式：

不带示例数据的安装（适合全新项目）：

php artisan voyager:install

带示例数据的安装（适合学习和演示）：

php artisan voyager:install --with-dummy

带示例数据的安装会创建：

• 1个管理员账户（如果当前没有用户）
• 1个示例页面
• 4篇示例文章
• 2个分类
• 7个系统设置项

5. 常见问题解决

如果安装过程中遇到"Specified key was too long"错误，这是由于MySQL版本过旧导致的。解决方案是修改AppServiceProvider.php文件，在boot方法中添加：

use Illuminate\Support\Facades\Schema;

public function boot()
{
    Schema::defaultStringLength(191);
}

6. 启动应用

安装完成后，启动开发服务器：

php artisan serve

访问http://localhost:8000/admin即可进入后台管理系统。

如果使用了带示例数据的安装方式，默认管理员账号为：

• 邮箱：admin@admin.com
• 密码：password

高级安装方式

对于已有Laravel项目或需要自定义安装的用户，可以采用以下手动安装步骤：

1. 发布资源文件

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

2. 执行数据库迁移

php artisan migrate

如需自定义迁移文件，可以：

1. 将Voyager的迁移文件复制到database/migrations目录
2. 修改这些文件
3. 在配置中关闭database.autoload_migrations
4. 再执行迁移

3. 修改用户模型

修改app/User.php，使其继承Voyager的用户模型：

class User extends \TCG\Voyager\Models\User
{
    // 保留原有的模型代码
}

4. 添加路由

在routes/web.php中添加Voyager路由：

Route::group(['prefix' => 'admin'], function () {
    Voyager::routes();
});

5. 数据填充和存储链接

php artisan db:seed --class=VoyagerDatabaseSeeder
php artisan storage:link

6. 重建自动加载

composer dump-autoload

管理员账户管理

1. 将现有用户设为管理员

php artisan voyager:admin user@example.com

2. 创建新管理员用户

php artisan voyager:admin newadmin@example.com --create

执行此命令后，系统会提示输入用户名和密码。

总结

Voyager提供了简单快捷的后台管理系统搭建方案，无论是全新项目还是已有项目，都能通过简单的命令完成安装和配置。带示例数据的安装方式特别适合初学者快速了解系统功能，而手动安装方式则为有特殊需求的开发者提供了更大的灵活性。安装完成后，您就可以立即开始使用Voyager强大的后台管理功能了。

voyager thedevdojo/voyager: 是一个基于 Laravel 框架的后台管理系统，支持多种数据源和插件扩展。该项目提供了一个简单易用的后台管理系统，可以方便地实现数据的查询和管理，同时支持多种数据库和插件扩展。 项目地址: https://gitcode.com/gh_mirrors/vo/voyager