# 框架核心功能

**Repository Path**: umaos/work

## Basic Information

- **Project Name**: 框架核心功能
- **Description**: 基于webman开发核心功能，系webmam基础插件，可以无缝隙兼容。
- **Primary Language**: PHP
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-17
- **Last Updated**: 2026-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# work

## 介绍

work 是一个基于 PHP 的 Web 应用开发框架，提供基础控制器、HTTP 请求处理、随机数生成等核心功能模块。该框架采用模块化设计，支持前后端分离开发，适用于快速构建中小型 Web 应用。

## 软件架构

### 目录结构

```
work/
├── src/
│   ├── Controller.php          # 基础控制器
│   ├── controller/
│   │   ├── Backend.php         # 后端控制器
│   │   ├── Frontend.php        # 前端控制器
│   │   └── Sysend.php          # 系统发送控制器
│   └── library/
│       ├── Auth.php            # 认证授权类
│       ├── Http.php            # HTTP 请求处理类
│       ├── Random.php          # 随机数生成工具类
│       └── traits/
│           ├── Backend.php     # 后端特性
│           ├── Frontend.php    # 前端特性
│           └── Sysend.php      # 系统发送特性
├── composer.json               # Composer 依赖配置
└── README.md                   # 项目说明文档
```

### 核心模块

- **控制器层**：提供统一的响应格式（成功、失败、警告）和模板渲染功能
- **HTTP 工具类**：支持同步/异步请求、文件推送等网络操作
- **随机数工具类**：支持生成各类随机字符串和 UUID
- **认证模块**：提供用户认证和授权相关功能

## 安装教程

1. 确保已安装 Composer 依赖管理工具
2. 在项目根目录执行 Composer 安装：
   ```bash
   composer install
   ```
3. 配置你的 Web 服务器指向项目目录

## 使用说明

### 基础控制器使用

```php
use Umaos\Work\Controller;

class YourController extends Controller {
    
    public function index() {
        // 返回成功响应
        return $this->success('操作成功', ['data' => $value]);
    }
    
    public function create() {
        // 返回失败响应
        return $this->error('创建失败');
    }
    
    public function warning() {
        // 返回警告响应
        return $this->warn('请确认操作');
    }
}
```

### HTTP 请求工具

```php
use Umaos\Work\library\Http;

// 发送 POST 请求
$response = Http::post($url, ['param' => $value]);

// 发送 GET 请求
$response = Http::get($url, ['param' => $value]);

// 发送异步请求
Http::sendAsyncRequest($url, $data);

// 推送文件到浏览器
Http::sendToBrowser($filePath);
```

### 随机数生成工具

```php
use Umaos\Work\library\Random;

// 生成随机字母数字字符串
$code = Random::alnum(6);

// 生成纯字母字符串
$code = Random::alpha(6);

// 生成纯数字字符串
$code = Random::numeric(4);

// 生成 UUID
$uuid = Random::uuid();
```

### Trait 使用

在对应的控制器中可以引入相应的 Trait：

```php
use Umaos\Work\controller\Backend;
use Umaos\Work\library\traits\Backend as BackendTrait;

class AdminController extends Backend {
    use BackendTrait;
    
    // 控制器方法
}
```

## 参与贡献

1. Fork 本仓库
2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的修改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 发起 Pull Request

## 许可证

本项目遵循项目仓库中指定的许可证协议。