# 后台管理基础模块

**Repository Path**: my_module/base

## Basic Information

- **Project Name**: 后台管理基础模块
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-05
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# myAdmin Base - 基础项目框架

基于 [myphp 框架](https://github.com/ncwsky/my) 的轻量级后台管理项目基础框架。

**仅包含 admin 基础模块**（管理员账号、角色权限、系统配置、模块市场等核心功能），其他业务模块（如 user、memo 等）通过后台「模块市场」按需在线安装。

## 特性

- **基础模块**：admin 后台管理（RBAC 权限、系统配置、管理员账号）
- **模块市场**：通过 Git 仓库 / Zip 包在线安装扩展模块
- **常驻内存**：支持 Workerman / Swoole 运行模式
- **安装向导**：`web/install.php` 一键完成项目初始化

## 环境要求

- PHP >= 8.1
- MySQL 5.7+
- Composer
- Redis（可选，推荐）

## 快速开始

### 1. 克隆项目

```bash
git clone https://gitee.com/my_module/base.git myAdmin
cd myAdmin
```

### 2. 安装依赖

```bash
composer install
```

### 3. 运行安装向导

浏览器访问 `http://你的域名/install.php`，按向导填写：

- 数据库配置（必填）
- Redis 配置（可选）
- 静态资源地址 `app_res_path`（建议设置）
- 管理员账号

安装向导会自动：
- 创建数据库（如不存在）
- 初始化 `admin`、`role` 等基础表
- 生成 `conf.local.php` 配置文件
- 扫描并注册模块（生成 `runtime/modules.json`、`runtime/module_maps.php`）
- 生成 `runtime/install.lock` 防止重复安装

### 4. 登录后台

访问 `http://你的域名/admin.php`，使用安装时设置的管理员账号登录。

### 5. 安装扩展模块

进入后台「模块管理 → 安装模块」，输入 Git 仓库地址在线安装：

| 模块 | 仓库地址 | 说明 |
|------|----------|------|
| user | https://gitee.com/my_module/user.git | 用户体系（多方式登录、余额、VIP、提现） |
| memo | https://gitee.com/my_module/memo.git | 便签工具（手机/电脑响应式） |

## 目录结构

```
├── admin/              # 基础模块（后台管理）
│   ├── control/        # 控制器
│   ├── model/          # 模型
│   ├── view/           # 后台视图
│   ├── common/         # ModuleManager / AdminAuth 等
│   ├── config.php      # 权限认证配置
│   ├── config.menu.php # 后台菜单（动态加载扩展模块菜单）
│   ├── config.nodes.php# 权限节点（动态加载扩展模块节点）
│   └── admin.sql       # 数据表 SQL
├── common/             # 全局公共库（通用 Model、工具函数）
├── web/                # Web 入口
│   ├── index.php       # 主入口（路由到各模块）
│   ├── admin.php       # admin 模块入口
│   └── install.php     # 安装向导
├── app/                # 默认应用目录
├── docs/               # 文档
├── runtime/            # 运行时（modules.json、module_maps.php）
├── log/                # 日志
├── conf.php            # 全局配置（默认）
├── conf.local.php      # 本地覆盖（install.php 自动生成）
├── app.conf.php        # 常驻内存服务配置
├── app.php             # 常驻内存入口
├── cli.php             # CLI 脚本入口
└── my / my.bat         # CLI 请求执行入口
```

## 模块市场

后台「模块管理」提供模块的安装、卸载、升级、扫描：

- **已安装模块**：卡片式展示，基础模块不可卸载
- **安装模块**：支持 Git 仓库、Zip 上传、本地目录三种方式
- **自动扫描**：识别项目中已存在但未注册的 `module.json`

详见 `docs/模块市场.md`。

## 开发你自己的模块

模块标准结构：

```
your-module/
├── module.json         # 模块描述（必须）
├── install.php         # 安装脚本（必须）
├── uninstall.php       # 卸载脚本（必须）
├── config.php          # 模块配置
├── config.menu.php     # 后台菜单（可选）
├── config.nodes.php    # 后台权限节点（可选）
├── control/            # 前台控制器
├── model/              # 模型
├── view/               # 前台视图
├── admin/              # 后台管理代码（可选，安装时部署到主 admin/）
│   ├── control/
│   └── view/
└── your-module.sql     # 数据表 SQL
```

详见 `docs/模块市场.md` 的"模块包规范"章节。

## CLI 命令

```bash
# 常驻内存运行
php app.php

# 生成表 Model
php cli.php Model 表名 "命名空间" "\基类"

# 队列处理
php cli.php Queue

# 打包 Phar
php -d phar.readonly=0 cli.php phar
```

## 许可证

MIT