UT框架官网

开发方式

代码开发

可视化开发

开发资源

衍生系统

文档有错误？
发信:usualtool@qq.com

定位至目录

代码开发百科目录

序言 Exordium
安装 Install
命令行安装 Command
配置 Configure
- 配置文件
- 通信独立
类库 Class Library
- 常规：Inc
- 数据：Data
  - PDO驱动
  - 关系型
  - Mysql
  - SQLServer
  - PostgreSQL
  - Sqlite
  - 非关系型
  - MongoDB
  - Redis
  - Memcache
- 语言：Lang
- 分页：Page
- 树型：Tree
- 通讯：Websockets
- 密签：RSA
- 爬虫：Spider
- 命令：PHP-Cli
- 微信：Wechat
- 阿里：Aliopen
模块 Module
- 模块结构
- 开发示例
插件 Plugin
模板 Template
- 模板引擎
- 模板开发方式
- 模块化模板
- 整站模板工程
路由 Route
协程中间件 Middleware
- Swoole
- Kafka
- Workerman
语言本地化 Language
接口 Interface
- 通讯接口
- 数据接口
开放API Api
开发进阶实例 Example

MVC开发实践

UsualTool Framework既可以面向过程开发，亦可以面向对象开发，并无强制要求，按各自需求。以下讲解在UT框架中以MVC+OPP架构开发。
例：开发一个JSON文本储存留言本

第1步：生成1个gbook模块
在根目录启动终端，运行命令：php usualtool module gbook

此时，在/app/modules目录会有一个目录完整的gbook模块

其中你要认识：cache/是缓存目录，model/是模型目录（如有），front/是前端目录（模型/控制器），skin是模板目录（视图）

第2步：编写模型文件 /front/index_model.php
此处，你可以将模型文件写到front/目录下，也可以建立model/目录作为模型目录。一句话，按自己需求。但最重要的要注意namespace命名空间的路径，需要符合PSR-0或PSR-4规范。
编写文件：/front/index_model.php
注意命名空间：namespace modules\gbook\front\index_model
当然也可以文件：/model/index.php ，命名空间：namespace modules\gbook\model\index
所谓仁者见仁，智者见智。你只要在模块中区分了M、V、C的职能便可。
namespace modules\gbook\front\index_model; use library\UsualToolInc\UTInc; class Gbook_Index_Model{ private string $dataFile; public function __construct(){ $this->dataFile = APP_ROOT.'/modules/gbook/messages.json'; $this->ensureDataFileExists(); } /** * 保存新留言 */ public function create(string $name, string $content): bool{ $name = trim($name); $content = trim($content); if ($name === '' || $content === '') { return false; } $name = UTInc::SqlCheck($name); $messages = $this->getAll(); $messages[] = [ 'id' => uniqid(), 'name' => $name, 'content' => $content, 'created_at'=> date('Y-m-d H:i:s') ]; return $this->save($messages); } /** * 获取所有留言（按时间倒序） */ public function getAll(): array{ $json = file_get_contents($this->dataFile); $data = json_decode($json, true); $messages = is_array($data) ? $data : []; usort($messages, fn($a, $b) => strtotime($b['created_at']) - strtotime($a['created_at'])); return $messages; } private function ensureDataFileExists(): void{ $dir = dirname($this->dataFile); if (!is_dir($dir)) { mkdir($dir, 0755, true); } if (!file_exists($this->dataFile)) { file_put_contents($this->dataFile, json_encode([])); } } private function save(array $messages): bool{ $json = json_encode($messages, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT); return file_put_contents($this->dataFile, $json) !== false; } }

第3步：编写控制器 /front/index.php
控制器主要就是引用命名空间。
此处控制器简写了，判断部分你可以放到模型里去判断，就更加完美。
甚至连$app->Runin数据写入，$app->Open视图渲染都可以放到模型里。不过这里还是将$app方法放到控制器中更好。
use library\UsualToolInc\UTInc; use modules\gbook\front\index_model; $model = new index_model\Gbook_Index_Model(); $error = ''; $messages = []; if (!empty($_POST)) { if ($model->create($_POST['name'] ?? '', $_POST['content'] ?? '')) { UTInc::GoUrl("?m=gbook"); } else { $error = '姓名和留言内容不能为空！'; } } $messages = $model->getAll(); $app->Runin( ['messages','error'], [$messages,$error] ); $app->Open('index.cms');

第4步：编写视图 /skin/front/index.cms
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="utf-8"> <title>留言板</title> <style> body { font-family: "Microsoft YaHei", sans-serif; max-width: 800px; margin: 30px auto; padding: 0 15px; } h1 { text-align: center; color: #333; } .form-group { margin: 15px 0; } label { display: block; margin-bottom: 5px; font-weight: bold; } input, textarea { width: 100%; padding: 8px; border: 1px solid #ccc; border-radius: 4px; } button { background: #007bff; color: white; border: none; padding: 10px 20; border-radius: 4px; cursor: pointer; } .message { padding: 15px 0; border-bottom: 1px dashed #eee; } .message-header { font-size: 1.1em; color: #007bff; } .message-time { color: #999; font-size: 0.9em; margin-left: 10px; } .error { color: red; margin: 10px 0; } </style> </head> <body> <h1>留言板</h1> <{if $error}> <div class="error"><{$error}></div> <{/if}> <form method="post" action="?m=gbook"> <div class="form-group"> <label>姓名：</label> <input type="text" name="name" required maxlength="50"> </div> <div class="form-group"> <label>留言内容：</label> <textarea name="content" rows="5" required></textarea> </div> <input type="submit" name="submit" value="提交留言"> </form> <div class="messages" style="margin-top: 30px;"> <{if $messages}> <{loop=>$messages $msg}> <div class="message"> <div class="message-header"> <{$msg->name}> <span class="message-time"><{$msg->created_at}></span> </div> <div><{$msg->content}></div> </div> <{/loop}> <{else}> <p style="color: #999; text-align: center;">暂无留言</p> <{/if}> </div> </body> </html>

第5步：效果图 /?m=gbook