Voyager，最方便的lavavel admin管理后台

2022-10-02

今天飞哥推荐1个最简最省心的管理后台，10分钟搭建1个功能齐全的管理后台，开箱即用，如果你在寻找方便的管理数据的管理后台，Voyager在github有11.2K star，值得推荐。

需求背景

开源软件，最麻烦的是软件升级，虽然发布初很火，各新版本出来后，各种兼容性，每次都需要找各种兼容方案，特别麻烦。Laravel-admin已经好久没维护了，Yii2-admin 功能也缺了很多，目前流行的前后端分离后台，vue + api后端Java、Golang开发语言的，需另外写代码增加新功能，”学习成本“也挺大的，飞哥是个懒人，快速应用才是我的目标。

Voyager介绍

官网：https://voyager.devdojo.com/ 文档：https://voyager-docs.devdojo.com/

Voyager以Lavavel为底层框架，升级已更新也比较及时，是1个集成管理后台UI和数据的管理后台，用来设置权限、菜单、文件管理、资源管理、执行命令行及应用数据的bread（增删改查）。同时，官方强调它不是一个前端应用，不是Wordpress或者api.

Voyager搭建步骤

必要条件：composer最新版本，PHP8以上，Laravel9以上

1、安装laravel

Laravel 安装文档 https://laravel.com/docs/9.x/installation

2种安装办法

# 使用composer安装
composer create-project laravel/laravel example-app

或laravel命令安装

composer global require laravel/installer
laravel new example-app

2、修改db配置

vi .env 修改数据库、链接地址、账号、密码等

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=

验证laravel是否安装成功 php artisan serve

访问地址 http://localhost:8000

3、安装Voyager

composer require tcg/voyager

安装空数据

php artisan voyager:install

或带实例数据，推荐使用带数据好体验

php artisan voyager:install --with-dummy

4、访问Voyager admin

vi .env 修改 APP_URL

APP_URL=http://localhost:8000

启动服务

php artisan serve

访问voyager后台地址: http://localhost:8000/admin

默认账号: admin@admin.com 密码: password

登录后，管理后台界面如下：

Voyager OSS

1、阿里云OSS插件

github兼容Laravel 9的OSS: https://github.com/alphasnow/aliyun-oss-laravel

composer require alphasnow/aliyun-oss-laravel

配置.env 和 config/filesystems.php 可参考github

2、适配Voyager oss

将默认的public改为oss，本质上Lavaral支持oss，Voyager就可以支持oss，类似亚马逊s3，腾讯云存储、七牛等也都是支持的。

vi config/voyager.php
    'storage' => [
        // 'disk' => 'public',
        'disk' => 'oss',
    ],

ps:不要忘记将原来使用的voyager的静态资源同步阿里云OSS目录下。

Voyager BREAD魅力

通过创建1个Products数据表来实现BREAD自动增删改查来学习Voyager的精髓。

1、创建表products

如下图：注意勾选 “Create model for this table”，在app目录下面会生成1个文件 app/Product.php，你也可以将此文件修改后放到 app/Models/Product.php，在后面的Bread操作更换"Model Name" 中的 App\Product为 App\Models\Product；

表一般都带created_at和updated_at的时间戳字段。

2、增删改查

通过后台"Tools"->“BREAD”，找到"Product"点击"Add BREAD to this table"，一键生成，真是太方便

总结

Voyager如此优秀，使用如此方便，相信会成为简单应用管理后台未来的标准趋势，低代码，少量配置就可以跑起来一个应用。Voyager可成为你的技术选型的1个重要候选项，可当作1个CMS管理后台，可当作1个运营部门查看管理数据的平台等。