优秀的编程知识分享平台

网站首页 > 技术文章 正文

Voyager - 不容错过的 Laravel 管理后台

nanyue 2024-09-14 06:25:56 技术文章 7 ℃

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 开发者的开发效率。

最近发表
标签列表