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

https://ffeeiipublic.oss-cn-hangzhou.aliyuncs.com/ffeeii.com/2022/10/voyager-screenshot.png

今天飞哥推荐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

登录后,管理后台界面如下:

https://ffeeiipublic.oss-cn-hangzhou.aliyuncs.com/ffeeii.com/2022/10/voyager-admin.jpg

Voyager OSS

1、阿里云OSS插件

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

composer require alphasnow/aliyun-oss-laravel

配置.envconfig/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的时间戳字段。

https://ffeeiipublic.oss-cn-hangzhou.aliyuncs.com/ffeeii.com/2022/10/Voyager_BREAD_1.jpg

2、增删改查

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

https://ffeeiipublic.oss-cn-hangzhou.aliyuncs.com/ffeeii.com/2022/10/Voyager_BREAD_2.jpg

总结

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