umaos/webman

Webman plugin umaos/webman

dev-master 2026-08-03 03:44 UTC

MIT

Published on Packagist.org on 2026-08-03 03:44 UTC

README

介绍

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

软件架构

目录结构

umaos/webman/
├── src/
│   └── 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 安装：

   composer install
   

3. 配置你的 Web 服务器指向项目目录

使用说明

基础控制器使用

use Umaos\webman\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 请求工具

use Umaos\webman\library\Http;

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

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

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

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

随机数生成工具

use Umaos\webman\library\Random;

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

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

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

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

Trait 使用

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

use Umaos\webman\controller\Backend;
use Umaos\webman\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

许可证

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