Voyager项目安装与配置完全指南

Voyager项目安装与配置完全指南

voyager 项目地址: https://gitcode.com/gh_mirrors/voy/voyager

Voyager是一个基于Laravel框架开发的后台管理系统，它提供了直观的管理界面和丰富的功能模块。本文将详细介绍如何从零开始安装和配置Voyager系统。

基础安装流程

1. 环境准备

在开始安装前，请确保已满足以下条件：

• 已安装PHP 7.3或更高版本
• 已安装Composer依赖管理工具
• 已配置好MySQL数据库
• 已创建新的Laravel项目

2. 安装Voyager包

在项目根目录下执行以下命令安装Voyager：

composer require tcg/voyager

3. 数据库配置

修改项目根目录下的.env文件，配置数据库连接信息：

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

注意：如果遇到"Specified key was too long"错误，说明MySQL版本较旧，需要修改AppServiceProvider.php文件中的boot()方法，添加Schema::defaultStringLength(191);

安装后操作

1. 启动开发服务器

php artisan serve

访问地址：http://localhost:8000/admin

2. 登录系统

如果选择了包含示例数据的安装方式，系统会自动创建管理员账户：

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

注意：只有当数据库中没有用户时才会创建示例管理员账户

3. 创建或升级管理员账户

将现有用户升级为管理员：

php artisan voyager:admin existing@email.com

创建新管理员账户：

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

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

高级安装配置

对于已有Laravel项目或需要自定义安装的情况，可参考以下步骤：

1. 发布资源文件

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

2. 数据库迁移

执行数据库迁移命令：

php artisan migrate

提示：如需自定义迁移文件，可复制Voyager的迁移文件到database/migrations目录修改，并在配置中关闭database.autoload_migrations选项

3. 修改用户模型

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

<?php
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. MySQL版本问题：如遇到索引长度错误，可在AppServiceProvider.php中添加Schema::defaultStringLength(191);

2. 权限问题：确保storage目录有写入权限

3. 路由冲突：如自定义路由与Voyager路由冲突，可调整路由定义顺序

通过以上步骤，您应该已经成功安装并配置好了Voyager后台管理系统。系统提供了丰富的功能模块，包括用户管理、菜单管理、数据库管理等，可以帮助您快速构建强大的后台管理系统。

voyager 项目地址: https://gitcode.com/gh_mirrors/voy/voyager