# uhphp

**Repository Path**: oldchenz/uhphp

## Basic Information

- **Project Name**: uhphp
- **Description**: 低代码开源系统
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://code.huijunet.work
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UHPHP 框架

一个简单高效的 PHP 开发框架，保留原生 PHP 特性，适用于各种规模的项目开发。

## 特性

- **MVC 架构** - 清晰的模型-视图-控制器分离
- **保留原生 PHP 特性** - 初学者同样可以有效运用开发项目
- **简单的文件命名规则** - 摒弃复杂的目录结构
- **开发模式支持** - 提供完善的文件创建功能，简化开发工作量
- **多数据库支持** - MySQL（mysqli/pdo）、MongoDB
- **缓存系统** - 文件缓存、Memcache、Redis
- **模板引擎** - 内置模板引擎，支持模板缓存
- **表单处理** - 自动表单生成和验证
- **权限管理** - 完整的 RBAC 权限控制系统
- **插件系统** - 支持插件扩展
- **多语言** - 内置多语言支持

## 目录结构

```
uhphp/
├── index.php              # 入口文件
├── UHPHP.cn.php          # 框架配置文件
├── uh/                   # 核心目录
│   ├── library_5_0/       # 框架核心库
│   │   ├── cache/         # 缓存类
│   │   ├── core/          # 核心类
│   │   ├── database/      # 数据库类
│   │   ├── function/      # 功能类
│   │   ├── system/        # 系统类
│   │   └── tips/          # 错误提示
│   ├── action/            # 业务控制器
│   ├── config/            # 配置文件
│   ├── language/          # 语言包
│   ├── cache/             # 缓存目录
│   └── project/           # 项目目录
│       └── help/         # 帮助文档
│           └── view/       # 帮助页面
└── public/               # 公共资源目录
    ├── js/               # JavaScript 文件
    ├── style/            # CSS 文件
    ├── upload/           # 上传文件
    └── fonts/           # 字体文件
```

## 快速开始

### 1. 环境要求

- PHP 7.4 及以上版本（兼容低版本）
- MySQL 或其他数据库
- Web 服务器（Apache/Nginx）

### 2. 安装步骤

```bash
# 克隆项目
git clone <repository-url> uhphp

# 或下载压缩包并解压
unzip uhphp.zip
```

### 3. 配置文件

修改配置文件 `UHPHP.cn.php`，设置数据库连接信息：

```php
return [
    'database' => [
        'host' => 'localhost',
        'user' => 'username',
        'pass' => 'password',
        'name' => 'database_name',
        'type' => 'mysqli'
    ],
    'cache' => [
        'type' => 'file'
    ]
];
```

## 开发指南

### 核心模块

- **uhBase** - 基础类，处理请求初始化、URL 解析、安全验证
- **uhConfig** - 全局配置管理器
- **uhAction** - 动作接口
- **uhController** - 控制器基类
- **uhOperate** - 操作类
- **uhView** - 视图类

### 功能模块

- **uhForm** - 表单处理
- **uhTemplate** - 模板处理
- **uhUrl** - URL 处理
- **uhPicture** - 图片处理
- **uhDevelop** - 开发工具

### 系统模块

- **uhAjax** - Ajax 处理
- **uhArray** - 数组处理
- **uhCache** - 缓存管理
- **uhCheck** - 数据验证
- **uhCookies** - Cookie 处理
- **uhDate** - 日期处理
- **uhError** - 错误处理
- **uhFile** - 文件操作
- **uhHttp** - HTTP 处理
- **uhPublic** - 公共方法
- **uhRegula** - 正则表达式
- **uhSession** - Session 处理
- **uhString** - 字符串处理

### 数据库模块

- **Database** - 数据库基类
- **uhModel** - 模型类
- **uhMysql** - MySQL 操作类
- **uhGet** - 查询类

### 缓存模块

- **uhFile** - 文件缓存
- **uhMemcache** - Memcache 缓存
- **uhRediss** - Redis 缓存

## 开发流程

### 1. 创建控制器

```php
// uh/action/your_module/Action.class.php
class UH_YourModule extends UH_Controller implements uhAction {
    public function uhControl() {
        // 业务逻辑
        return ['data' => $result];
    }
}
```

### 2. 创建模型

```php
// uh/model/your_model/Model.class.php
class UH_YourModel extends Model {
    public function __construct($tableKey) {
        parent::__construct($tableKey);
    }
}
```

### 3. 创建视图

```html
<!-- uh/project/your_project/view/info.html -->
<div class="container">
  <h1>欢迎</h1>
  <p>这是你的第一个页面</p>
</div>
```

### 4. 数据库操作

```php
// 实例化模型
$model = Model::obj('your_table');

// 查询数据
$data = $model->select(['id', 'name'])->where(['status' => 1])->find();

// 插入数据
$model->insert(['name' => 'test', 'status' => 1]);

// 更新数据
$model->where(['id' => 1])->update(['name' => 'updated']);

// 删除数据
$model->where(['id' => 1])->delete();
```

### 5. 表单处理

```php
// 控制器中处理表单
$validData = $this->post('form_key');

if ($validData) {
    // 验证成功，处理数据
} else {
    // 返回错误信息
    $this->error('验证失败', $this->getError());
}
```

## 前端组件

### JavaScript 工具库

- **uh.js** - 基础工具库（DOM 操作、AJAX、Cookie、Storage）
- **uhForm.js** - 表单处理（验证、数据获取、联动选择）
- **uhBase.js** - DOM 操作封装（元素操作、样式、事件、动画）
- **uhAdmin.js** - 后台管理功能
- **uhInfo.js** - 信息管理组件
- **uhFiles.js** - 文件上传组件

### 组件功能

- **弹窗组件** - 可配置的对话框，支持拖拽、动画
- **表单组件** - 自动生成表单，支持验证
- **分页组件** - 自动分页，支持自定义每页数量
- **搜索组件** - 多字段搜索

## 安全特性

- **XSS 防护** - 内置 XSS 防护，过滤用户输入
- **SQL 注入防护** - 使用预处理语句，参数化查询
- **CSRF 防护** - 通过 APPKEY 验证请求来源
- **文件上传安全** - 文件类型、大小验证

## 帮助文档

详细的帮助文档位于code.huijunet.work

## 许可证

版权所有 © 2025

## 支持

如有问题，请查看帮助文档或联系技术支持。