Dux PHP Admin
阅读时间：1 分钟
0 字

项目介绍 ​

Dux PHP Admin 是基于 Dux Lite 与 DVHA 构建的企业级后台管理系统。它采用 一体化模块架构：后端和前端在同一套模块体系中组织，像传统全栈一样顺手，同时又保留前后端分离的规范化优势。前端基于 Vue 3 与基座模式，页面放到模块里即可访问，无需为每个页面单独编译，改完直接生效。

与 Dux Lite / DVHA 的关系 ​

  • Dux Lite：后端基座，提供路由、资源、权限、命令行、配置与数据库能力
  • DVHA：前端基座，负责管理端路由、布局与数据交互
  • Dux PHP Admin：将两者组合并落地为一套完整后台框架

与常见方案对比 ​

对比项Dux PHP Adminlayui传统前后端分离（Vue/React）
开发体验传统全栈的直观体验 + 现代 Vue 3 技术栈传统全栈体验，但前端技术栈偏旧两套工程分离，协作成本高
页面组织页面放在模块内，按需加载以模板为主，模块化弱前端工程独立，页面与后端分离
接口与权限资源化接口自动生成，菜单/权限联动通常需要自建接口与权限体系接口与权限需两端协作对接
上手成本低：配置少、路径直观低，但现代组件生态有限高：构建、接口联调、部署更复杂
适用场景企业后台、快速交付、长期维护简单后台、小型项目大型团队、复杂前后端协作项目

核心组成 ​

  • Dux Lite：PHP 框架，提供 Attribute 路由、资源控制器、模型迁移、命令行与事件系统。
  • DVHA + Naive UI：前端框架与 UI 组件，支持多管理端、统一路由与数据交互。
  • System 模块：基础后台能力（用户、角色、菜单、配置、日志、存储、调度等）。
  • Data 模块：数据配置模块（表格/表单/字段的配置化管理）。

路由与访问入口 ​

  • 管理界面入口：/manage/
    • 返回完整的后台应用壳与运行时配置。
  • 后台 API：/admin/*
    • 资源控制器默认挂载在该路由前缀下。
  • 开放 API：/api/*
    • 需要签名头（AccessKey / Content-Date / Content-MD5）。

/manage 会自动 302 重定向到 /manage/，请使用带斜杠地址。

默认模块 ​

当前默认注册的模块来自 config/app.toml：

registers = [ "App\\System\\App", "App\\Data\\App" ]

你可以添加新的模块并在此处注册。每个模块独立维护 app.json、Models、Admin 与 Api。

目录概览 ​

app/
  System/          # 系统模块
  Data/            # 数据模块
config/
  app.toml         # 注册模块
  database.toml    # 数据库
  use.toml         # 运行配置（可用 use.dev.toml 覆盖）
public/
  index.php        # 入口
  static/web/      # 后台前端构建产物
web/               # 后台前端源码（Vite）

更多目录细节请查看 目录结构。