README

🚀 PHP 8.4 + Vue 3 的一体化后台解决方案

传统全栈的顺手体验 + 前后端分离的规范化优势，基于一体化模块架构

📖 最新文档 | 🏠 主仓库 | 云市场 | 🌐 官网

Important

业务调整说明： 为了方便开发者的维护工作、更好服务用户，并顺应当前 AI 时代的发展方向，dux-php-admin 已并入 DuxAI。 后续框架能力、AI 模块、系统模块与相关文档将统一在 Dux AI 体系内持续维护。

最新文档：https://ai.docs.dux.plus/ 主仓库：https://github.com/duxweb/dux-ai

✨ 核心特性

• 🚀 一体化模块架构：后端接口与前端页面在同一模块中组织，结构清晰
• ⚡ 基座模式：页面放进模块即可访问，修改后刷新生效，无需每页打包
• 🔐 权限与菜单联动：权限节点与菜单名称一致，登录后自动过滤无权限菜单
• 📊 资源化后端：资源类自动生成 CRUD、路由与权限，统一响应结构
• 🧩 系统模块开箱即用：用户、角色、部门、日志、存储、任务调度等常用功能
• 🛠️ 命令行工具：db:sync、menu:sync、route:list、permission:list 一站式支持

🏗️ 架构理念（直观理解）

你可以把它理解为 iOS + App 或 微信 + 小程序 的关系：

• 后端是基座：路由、权限、菜单、接口统一管理
• 页面是模块：放在模块目录中，按需加载

既保留传统全栈的直观体验，又保持前后端分离的规范化优势。

🚀 快速开始（最短流程）

最新安装与使用说明请优先以 Dux AI 文档为准：

• 文档入口：https://ai.docs.dux.plus/
• 主仓库：https://github.com/duxweb/dux-ai

1) 确认环境

php -v
composer self-update

请勿使用 Composer 镜像源，保持官方源即可。

2) 获取源码并安装依赖

git clone https://github.com/duxweb/dux-php-admin.git dux-php-admin
cd dux-php-admin
composer install

3) 配置数据库

编辑 config/database.toml：

[db.drivers.default]
driver = "mysql"
host = "localhost"
database = "dux_admin"
username = "root"
password = "root"
port = 3306
prefix = "app_"

4) 初始化数据库与菜单

php dux db:sync
php dux menu:sync

5) 启动服务

php -S localhost:8000 -t public

访问后台：

• http://localhost:8000/manage/
• 默认账号：admin / admin

首次登录后请立即修改默认密码。

📦 前端基座更新（可选）

只有在修改 web/ 目录或升级前端依赖时才需要更新基座：

bun install
bun run build

构建产物输出到：

<项目目录>/public/static/web

📚 文档

• 最新文档：https://ai.docs.dux.plus/
• 框架说明：https://ai.docs.dux.plus/foundation/introduction
• 扩展开发：https://ai.docs.dux.plus/extensions/

🤝 参与贡献

后续问题反馈与功能演进请优先在 Dux AI 主仓库进行。

• Issues：https://github.com/duxweb/dux-ai/issues
• Discussions：https://github.com/duxweb/dux-ai/discussions
• PR：https://github.com/duxweb/dux-ai/pulls

📄 开源协议

本项目基于 MIT 协议开源。