Skip to content
页面梗概

助力生态可持续发展

赞助 插件世界 发展

成为赞助者

DcatSaas

License

介绍

一款帮助你在 30 分钟内从 0 搭建 Laravel SaaS 化项目的插件。

插件管理器应用市场管理器的插件架构设计下,采用Tenancy 3.xDcat-AdminLaravel 可快速建立属于你的 SaaS 业务框架。

初期可采用 Dcat-Admin 完成中心应用开账号,租户应用建立业务逻辑的方案。研发到一定阶段后,推荐采用 scui 或其他你喜欢的管理后台框架,将项目前后端进行分离。

依赖项目:

关注代码仓库

点击前往代码仓库

前置要求

  • Laravel 9+
  • Tenancy 3+
  • DcatAdmin 2.*
  • fresns/plugin-manager ^2
  • fresns/market-manager ^1
  • 项目已完成 fresns/plugin-manager、fresns/market-manager 的安装。

安装

  1. 修改扩展包稳定性限制 composer.json 需要允许安装稳定性为 dev 的依赖包。相关设置见下方代码。
{
    ...
    "minimum-stability": "dev",
    "prefer-stable": true,
    ...
}
  1. 初始化
# 创建新项目 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
  1. 使用
# 常用命令
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;
}

协议

Apache 2.0

开发者交流群

技术交流群 ID: 305795002