30分钟上手Voyager：零基础构建Laravel管理后台的完整指南
【免费下载链接】voyager 
项目地址: https://gitcode.com/gh_mirrors/voy/voyager
你还在为Laravel项目从零开发管理后台？还在手动编写CRUD接口和表单页面？本文将带你通过Voyager——这个强大的Laravel管理界面生成器，在半小时内完成专业级后台的搭建。读完本文你将掌握：环境准备、一键安装流程、BREAD系统使用、媒体管理和菜单定制的核心技能。
为什么选择Voyager？
Voyager是Laravel生态中最受欢迎的管理后台解决方案之一，它不是传统意义上的CMS（内容管理系统），而是一个灵活的管理界面工具包。通过Voyager，你可以：
- 快速生成数据模型的CRUD操作界面（BREAD系统）
- 使用直观的媒体管理器管理文件上传
- 通过拖拽构建自定义菜单
- 细粒度的角色与权限控制
官方定义文档：docs/getting-started/what-is-voyager.md
环境准备与安装
系统要求
在开始前，请确保你的开发环境满足以下条件：
- Laravel 8或9版本
- PHP 7.3以上（Laravel 9需PHP 8.0+）
- 数据库（MySQL、PostgreSQL等Laravel支持的数据库）
详细环境要求：docs/getting-started/prerequisites.md
安装步骤
- 创建Laravel项目（如果已有项目可跳过）：
composer create-project laravel/laravel my-project
cd my-project
- 安装Voyager包：
composer require tcg/voyager
- 配置环境变量： 编辑
.env文件设置数据库连接：
APP_URL=http://localhost
DB_HOST=localhost
DB_DATABASE=your_database
DB_USERNAME=your_username
DB_PASSWORD=your_password
- 执行安装命令：
# 不带演示数据
php artisan voyager:install
# 带演示数据（推荐新手使用）
php artisan voyager:install --with-dummy
- 启动服务并访问：
php artisan serve
访问 http://localhost:8000/admin 即可看到登录界面。使用演示数据时，默认账号为：
- 邮箱：admin@admin.com
- 密码：password
完整安装文档：docs/getting-started/installation.md
BREAD系统：数据管理核心
BREAD是Voyager的核心功能，代表Browse（浏览）、Read（查看）、Edit（编辑）、Add（添加）和Delete（删除）。通过BREAD系统，你可以为任何Eloquent模型快速生成管理界面。
BREAD基本设置
- 登录后台后，点击左侧菜单的"Database"→"Data Types"
- 点击"Add New Data Type"按钮
- 填写基本信息：
- Display Name: 模型显示名称（如"产品"）
- Slug: URL友好名称（如"products"）
- Model Name: 完整模型类名（如"App\Models\Product"）
- Controller: 控制器类名（可留空使用默认）
- Icon: 界面显示图标（使用FontAwesome图标名）
字段配置
在BREAD设置页面下方，你可以为每个数据库字段配置：
- 是否在浏览/查看/编辑/添加模式下显示
- 表单输入类型（文本框、下拉框、日期选择器等）
- 验证规则
- 其他高级选项
例如，为价格字段设置验证规则：
{
"validation": {
"rule": "required|numeric|min:0"
}
}
BREAD详细使用指南：docs/bread/introduction.md
媒体管理功能
Voyager内置了强大的媒体管理器，支持文件上传、目录管理和图片预览。通过直观的界面，你可以：
- 上传图片、文档等各类文件
- 创建文件夹组织文件
- 图片裁剪和预览
- 直接插入到内容编辑器
媒体管理器会自动处理文件存储，并生成不同尺寸的缩略图。所有上传的文件默认存储在storage/app/public目录下，并通过符号链接公开访问。
菜单构建与权限控制
自定义菜单
Voyager允许你通过拖拽界面创建自定义菜单：
- 进入"Menu Builder"
- 选择或创建菜单
- 拖拽菜单项调整顺序
- 设置子菜单和访问权限
菜单构建器
角色与权限
Voyager提供了完善的RBAC权限系统：
- 创建角色（如"编辑"、"财务"）
- 为角色分配权限
- 将用户分配到不同角色
你可以细粒度控制每个BREAD操作的权限，以及菜单和功能的访问权限。
权限管理文档：docs/core-concepts/roles-and-permissions.md
高级定制与扩展
Voyager提供了多种扩展方式满足个性化需求：
自定义表单字段
除了默认的文本框、下拉框等字段类型，你还可以添加自定义表单字段类型：
- 创建表单字段处理类
- 注册到Voyager
- 在BREAD设置中使用
自定义表单字段文档：docs/customization/adding-custom-formfields.md
覆盖视图和路由
如需深度定制界面，可以覆盖Voyager的默认视图：
# 发布视图文件
php artisan vendor:publish --tag=voyager-views
修改resources/views/vendor/voyager目录下的文件即可自定义界面。
视图覆盖指南：docs/customization/overriding-files.md
总结与后续学习
通过本文，你已经掌握了Voyager的基本使用方法，能够快速搭建一个功能完善的管理后台。以下是推荐的后续学习路径：
- 深入BREAD系统：学习关系字段、验证规则和自定义访问器
- 探索插件生态系统：查找社区开发的Voyager扩展插件
- 性能优化：学习如何优化大量数据下Voyager的性能
官方完整文档：docs/introduction.md
项目源码地址：src/
现在，你已经拥有了一个功能强大且灵活扩展的管理后台，专注于你的业务逻辑开发吧！
【免费下载链接】voyager 项目地址: https://gitcode.com/gh_mirrors/voy/voyager
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
