Laravel 是一套简洁、优雅的 PHP Web 开发框架。它可以让你从面条一样杂乱的代码中解脱出来；它可以帮你构建一个完美的网络 App，而且每行代码都可以简洁、富于表达力。

Laravel 语法富有表现力，拥有高质量的文档，和丰富的扩展包，是最为流行的 PHP Web 框架之一。而对于 Web 应用，我们往往都需要一个 admin 管理后台，Voyager 就是一个十分方便的管理后台。

简介

Voyager，是 the-control-group 在 Github 上开源的 PHP Laravel 管理后台。

Voyager 是

• Laravel 框架的 admin 管理界面
• 一个便捷的增删改查方法
• 一个菜单构建工具
• 管理上传文件的媒体库
• CRUD / BREAD 生成器

Voyager 使用优秀的 PHP 框架 Laravel 驱动，可以快速集成数据的查询、添加、修改、删除以及展示，拥有功能强大的图片上传，图片管理，文件管理等功能的媒体管理功能，支持自定义权限角色，后台菜单设置，可使用拖拽功能进行排序，支持高度自定义开发，满足更多场景需求。

使用

目前 Voyager 支持 Laravel 6 / 7，需要 PHP 7.3 或以上版本。Voyager 安装非常简单，当创建了一个新的 Laravel 应用后，可以使用 composer 引入：

composer require tcg/voyager

然后，创建一个新的数据库，并在 .env 文件中设置好连接信息：

APP_URL=http://localhost
DB_HOST=localhost
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret

最后，进行 Voyager 的安装。可以选择使用虚拟数据，或不使用。虚拟数据将包括1个管理账户（如果没有用户已经存在）、1个演示页面、4个演示帖子、2个类别和7个设置。

不使用虚拟数据的安装方式是：

php artisan voyager:install

使用虚拟数据的安装方式：

php artisan voyager:install --with-dummy

然后使用 php artisan serve 命令，可以开启一个本地开放环境，然后在浏览器中打开 http://localhost:8000/admin，就能够看到管理后台了。

随着Voyager的安装成功，你将在你的文件系统中看到新的配置文件（config/voyager.php） 在这个文件中，您可以找到各种选项来更改您的Voyager安装的配置。

配置项包括后台用户配置、控制器、静态资源、数据库、语言、主题等等，都可以进行配置。

Voyager 提供了数据的 BREAD 控制：

• BROWSE (是否在列表页显示这个字段)
• READ (当你浏览这条信息的时候，决定是否显示这个字段)
• EDIT (是否显示在编辑页（允许编辑）)
• ADD (是否显示在创建页（允许创建）)
• DELETE (是否显示删除按钮（允许删除）)

Voyager 自动提供了访问权限、命名空间、表单验证、标签、排序、查询范围等。

表单域是BREAD系统的一大亮点。 每一个表单域在BREAD中都对应一个你的数据库的字段的类型 如下所述，你可以使用json格式的选择调整你的表单域，配置项包括：

• 描述信息：所有的类型都包含一个描述信息，用于帮助别人理解这个字段的含义

{
    "description": "A helpful description text here for your future self."
}

• 显示配置：可以对BREAD默认的展示形式进行一些小的修改

{
    "display": {
        "width": "3",
        "id": "custom_id"
    }
}

• 默认值：很多表单域允许你在添加记录的时候，设置一个默认值

{
    "default" : "Default text"
}

• Null Values：你可能希望在数据库中保存的数据是一个null,而不是一个空字符串

{
    "null": ""
}

• 生成Slugs：使用BREAD 可以使用一个确定的字段自动生成url slug

{
    "slugify": {
        "origin": "title",
        "forceUpdate": true
    }
}

• 自定义视图：对一个表单字段使用自定义的视图，用来满足你的特定的业务需求

{
    "view": "my_view"
}

运行完voyager安装程序后，您将看到一些新的路由，它们已添加到routes/web.php文件中，如下所示：

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

这就是 Voyager 提供路由的地方。如果需要，可以更改admin前缀，或者你可以根据自己需要来配置其他路由选项，如 middleware or domain。

当我们创建一个新的BREAD类型并且指定了slug后，你可以使用下面的链接访问:

URL /admin/slug-name

举例来说，如果你有一个products表，并且我们规定了他的slug是products，那么你现在可以访问这个链接

URL /admin/products

总结

Voyager 作为一个 Laravel 框架的 admin 管理界面，提供了便捷的增删改查方法，提供了强大的菜单构建工具，能够管理上传文件的媒体库，并实现了功能强大、拓展性强的 CRUD / BREAD 生成器，大大提升了 Laravel 开发者的开发效率。