DcatSaas
介绍
一款帮助你在 30 分钟内从 0 搭建 Laravel SaaS 化项目的插件。
在插件管理器
与应用市场管理器
的插件架构设计下,采用Tenancy 3.x
、Dcat-Admin
、Laravel
可快速建立属于你的 SaaS 业务框架。
初期可采用 Dcat-Admin
完成中心应用开账号,租户应用建立业务逻辑的方案。研发到一定阶段后,推荐采用 scui 或其他你喜欢的管理后台框架,将项目前后端进行分离。
依赖项目:
关注代码仓库
前置要求
- Laravel 9+
- Tenancy 3+
- DcatAdmin 2.*
- fresns/plugin-manager ^2
- fresns/market-manager ^1
- 项目已完成 fresns/plugin-manager、fresns/market-manager 的安装。
安装
- 修改扩展包稳定性限制
composer.json
需要允许安装稳定性为dev
的依赖包。相关设置见下方代码。
{
...
"minimum-stability": "dev",
"prefer-stable": true,
...
}
- 初始化
# 创建新项目 saas-test
composer create-project --prefer-dist laravel/laravel saas-test
# 进入项目目录
cd saas-test
# 初始化 git 仓库
git init
git add .
git commit -m "feat: Init."
# 配置应用市场管理器与插件管理器的安装源
composer config repositories.market-manager vcs https://gitee.com/fresns/market-manager
composer config repositories.plugin-manager vcs https://gitee.com/fresns/plugin-manager
# 安装应用市场管理器与插件管理器
composer require fresns/market-manager:dev-master
composer require fresns/plugin-manager:2.x-dev
# 配置数据库与项目信息
APP_NAME
APP_URL
DB_HOST
DB_DATABASE
DB_USERNAME
DB_PASSWORD
# 执行迁移,增加 plugins 表
php artisan migrate
# 提交仓库变动。方便查看 saas 初始化的文件
git add .
git commit -m "feat: Install market-manager and plugin-manager."
# 从 github 下载 dcat-saas 扩展
php artisan market:require mouyong/dcat-saas
# 或从 zip 压缩包安装 dcat-saas
php artisan market:require ~/dcat-saas.zip
# 激活插件
php artisan plugin:activate DcatSaas
# 初始化 saas 信息
php artisan saas:install
- 使用
# 常用命令
php artisan saas # 查看 saas 扩展包提供的命令
php artisan saas:install # 初始化 saas(会提示是否覆盖)
php artisan saas:demo-add # 添加租户 可指定租户名,默认 foo
php artisan saas:demo-del # 删除租户 可指定租户名,默认 foo
php artisan saas:menu-export # 导出菜单(默认会尝试导出 foo 租户多菜单)
php artisan saas:menu-reset # 重置菜单 (根据导出的菜单进行租户菜单重置)
php artisan tenants:list # 查看租户列表
php artisan tenants:migrate --tenants foo # 执行 foo 租户的迁移,开发阶段建议指定租户,部署阶段可不指定,以批量运行租户迁移
php artisan tenants:rollback --tenants foo # 回滚 foo 租户的迁移,开发阶段建议指定租户,部署阶段可不指定,以批量运行租户迁移的回滚操作
# 其他命令自行查看
...
前后端分离的部署示例
宝塔缓存与前端代理的配置示例:
搭配 flow.aliyun.com
或宝塔 webhook
可完成项目的 devops
自动化部署。
# scui
location ~* ^/(dashboard|tenants-assets|img|config|pc) {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_pass http://localhost:3000;
# proxy_pass http://192.168.0.34:3000;
# proxy_pass http://xxx.hecs.example.com;
# proxy_pass https://xxx-xxx-dashboard.oss-cn-shenzhen.aliyuncs.com;
}
# scui
location ~* ^/(dashboard|tenants-assets|img|config|pc) {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_pass https://xxx-dashboard-aone.oss-cn-shenzhen.aliyuncs.com;
}
# scui
location ~* ^/(platform|platform-assets|img|config) {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_pass https://xxx-dashboard-platform.oss-cn-shenzhen.aliyuncs.com;
}
# 有缓存的配置
location ~* ^/assets {
proxy_cache cache_one;
proxy_cache_key $host$uri$is_args$args;
add_header Nginx-Cache "$upstream_cache_status";
proxy_cache_valid 200 304 1m;
proxy_cache_valid 404 500 502 503 504 1m;
proxy_cache_valid any 1s;
expires 1s;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_pass http://test-csim-dashboard.oss.iwnweb.com;
}
协议
开发者交流群
技术交流群 ID: 305795002