Voyager Frontend 常见问题解决方案

Voyager Frontend 常见问题解决方案

voyager-frontend The Missing Front-end for The Missing Laravel Admin 🔥 项目地址: https://gitcode.com/gh_mirrors/vo/voyager-frontend

1. 项目基础介绍

Voyager Frontend 是一个为 Laravel 的 Voyager 管理后台提供的开源前端解决方案。它为 Voyager 项目添加了前端视图、路由和资源，包括基本的布局结构（如头部、尾部等）和基于 Foundation 框架的主题资源。该项目主要使用 PHP 作为后端编程语言，前端则使用 HTML、CSS 和 JavaScript。

2. 新手常见问题及解决步骤

问题一：如何安装 Laravel + Voyager？

问题描述：新手在使用 Voyager Frontend 之前需要先搭建 Laravel 和 Voyager 的环境。

解决步骤：

1. 使用 Composer 创建一个新的 Laravel 项目：

   composer create-project --prefer-dist laravel/laravel your-project-name
   

2. 进入项目目录并安装 Voyager：

   cd your-project-name && composer require tcg/voyager
   

3. 复制 .env.example 文件为 .env 并更新数据库和应用程序的 URL 配置：

   cp .env.example .env
   

4. 生成 Laravel 应用密钥：

   php artisan key:generate
   

5. 安装 Laravel 前端资源（仅限 Laravel 7+）：

   php artisan ui bootstrap --auth
   

6. 运行 Voyager 安装程序：

   php artisan voyager:install
   

7. 创建一个 Voyager 管理员用户：

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

问题二：如何安装 Voyager Frontend？

问题描述：安装完 Laravel 和 Voyager 后，需要安装 Voyager Frontend。

解决步骤：

1. 在 Laravel/Voyager 项目中安装 Voyager Frontend 包：

   composer require pvtl/voyager-frontend
   

2. 运行安装器并更新自动加载：

   composer dump-autoload && php artisan voyager-frontend:install
   

3. 构建前端主题资源：

   npm install
   npm run dev
   

4. 设置 Laravel 搜索驱动为 tntsearch：

   echo "SCOUT_DRIVER=tntsearch" >> .env
   

问题三：如何开发前端主题？

问题描述：在准备好开始开发前端样式时，需要知道如何处理 SCSS 和 JavaScript 文件的更改。

解决步骤：

1. 使用以下命令监视 /resources/assets 目录中的任何更改，并立即构建：

   npm run watch
   

2. 对 SCSS 和/或 JavaScript 文件进行更改后，上述命令将自动处理文件，构建新的资源。

以上是新手在使用 Voyager Frontend 时可能会遇到的一些常见问题及解决方案。在开始项目之前，请确保仔细阅读官方文档，以便更好地理解项目的结构和配置。

voyager-frontend The Missing Front-end for The Missing Laravel Admin 🔥 项目地址: https://gitcode.com/gh_mirrors/vo/voyager-frontend