《开源精选》是我们分享Github、Gitee等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的Voyager 是一个 Laravel 管理包，包括 BREAD(CRUD) 操作、媒体管理器、菜单构建器等等。

Voyager特性

• Laravel 应用的管理界面
• 为您的应用添加/编辑/删除数据的简单方法
• 菜单构建器（在 Voyager 中为您的应用构建菜单）
• 文件的媒体管理器
• CRUD/BREAD 生成器

Voyager 只是您的 Laravel 应用程序的管理员。无论您希望您的应用在前端做什么，都完全取决于您。您可以控制您的应用程序，并且可以使用 Voyager 通过添加数据、编辑用户、创建菜单和许多其他管理任务来让您的管理更轻松。

先决条件

Voyager 要求您使用 PHP 7.3 或更新版本。Laravel 要求您在使用 Laravel 9 时使用 PHP 8 或更新版本。

介绍

在为数据库表添加或编辑当前 BREAD 时，您将首先看到 BREAD 信息，该信息允许您设置显示名称、slug、图标Model和控制器命名空间、策略名称。您还可以选择是否要为该 BREAD 类型生成权限。

向下滚动时，您将看到与该表关联的每一行，您可以在其中选择要在视图中查看每个字段的位置：

• BROWSE（浏览当前数据时会显示该字段）
• READ（点击查看当前数据时会显示该字段）
• UPDATE（字段将可见并允许您编辑数据）
• ADD（当您选择创建新数据类型时，该字段将可见）
• DELETE（与删除无关，因此可以选中或取消选中）

您还可以选择为每个字段指定要使用的表单类型。这可以是 TextBox、TextArea、Checkbox、Image 和许多其他类型的表单元素。

标记

标记使您可以在编辑或添加 BREAD 时直接将新项目添加到 Belongs-To-Many 关系。

要激活此功能，您只需Tagging在关系详细信息中启用

之后，您可以在选择中输入自由文本，然后按 Enter 以保存新关系。

范围浏览结果

如果要过滤 BREAD 的浏览结果，可以通过在模型中创建Scope来实现。例如，如果您只想显示当前用户创建的帖子，请定义如下所示的 Scope：

<?php
public function scopeCurrentUser($query)
{
    return $query->where('author_id', Auth::user()->id);
}

接下来，转到 BREAD-settingsposts并查找Scope输入并选择currentUser：

点击后，Submit您只会看到自己的帖子。

关系

添加关系

使用 BREAD 构建器，您可以轻松地在表之间创建关系。在页面底部，您将看到一个新按钮，上面写着“创建关系”

如果您还没有为表创建 BREAD，则需要先创建它，然后您可以在创建 BREAD 后返回添加关系。否则，您最终会收到如下所示的通知。

因此，在创建 BREAD 之后，您将能够创建新的关系。单击“创建关系”按钮后。您将看到一个新的模态窗口，如下所示：

您将首先指定这将是哪种类型的关系，然后您将选择您正在引用的表以及属于该表的哪个命名空间。然后，您将选择哪一行组合了这些表。

—END—

开源协议：MIT license

开源地址：https://github.com/the-control-group/voyager