README

项目介绍

基于laravel13、amis6、mysql8/pgsql17前后端分离开发的, 快速且灵活的后台管理框架

• 基于 amis 以 json 的方式在后端构建页面，减少前端开发工作量，提升开发效率。
• 在 amis 150多个组件都不满足的情况下, 可自行开发前端。
• 框架为前后端分离 (不用再因为框架而束手束脚~)。

内置功能

• 基础后台功能
  • 后台用户管理
  • 角色管理
  • 权限管理
  • 菜单管理
• 代码生成器
  • 保存生成记录
  • 导入/导出生成记录
  • 可使用命令清除生成的内容
  • 无需更改代码即可生成完整功能
• amis 全组件封装 150+ , 无需前端开发即可完成复杂页面
• 多模块支持
• 图形化扩展管理
• 动态 API 模板管理（CRUD / 选项 / 设置 / 状态切换 / 聚合统计）

安装

👉 注意: bizAdmin 是 laravel 的扩展包, 安装前请确保你会使用 laravel12，PHP8.3+版本以上`

1. 创建 laravel 项目

composer create-project --prefer-dist laravel/laravel my-app 13.*
或通过 composer global require laravel/installer 升级到最新安装版本
再执行创建项目：
laravel new my-app
一路回车确认即可

2. 配置数据库信息并安装 api 模块

# .env
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=biz_admin
DB_USERNAME=postgres
DB_PASSWORD=xxxxxx

安装api 模块

php artisan install:api

3. 获取 Biz Admin

composer require dagasmart/bizadmin

4. 安装

# 先发布框架资源
php artisan admin:publish
# 执行安装 (可以在执行安装命令前在 config/admin.php 中修改部分配置)
php artisan admin:install

5. 运行项目

启动服务, 访问 /admin 路由即可
初始账号密码都是 admin

6. 多应用模块

创建模块

这个命令会创建 bizadmin 所需的文件和目录, 以及相关的数据库及基础数据 建议首字母大写, 使用大驼峰格式

php artisan admin-module:init <module-name>
# eg: php artisan admin-module:init Master
# 支持多个模块同时创建
# eg: php artisan admin-module:init Master Store

更改配置文件

// file: config/admin.php

// 配置 modules
// 建议首字母大写, 大驼峰格式
// ...
'modules' => [
    'Master' => true // 在这里配置模块名, 以及启用状态
]

配置 composer.json

配置模块目录(modules)自动加载

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Modules\\": "modules/"
    }
}

重新生成自动加载文件

composer dump-autoload

现在, 你可以通过 /master 来访问你的新模块了~