一、

在使用通达OA时TD类是主要数据库操作库。许多开发者在第一次接触时会遇到：

• 不清楚如何正确加载 TD 类；
• 对事务与缓存的使用缺乏经验；
• 担心 SQL 注入和性能瓶颈。老实说，

下面将从设计原理到实战案例。逐步拆解 TD 类，让你快速上手并避免常见痛点。怎么说呢，

二、TD类概述

定位

TD 类位于 MYOA\webroot\inc\td.class.php是 OA 程序所有数据库访问的统一入口。

特点

加载方式

# 推荐：通过 alert.inc.php / auth.inc.php 自动加载不直接 include td.class.php 能保证权限检查完成后再创建实例。减少攻击面，# 示例：

三、TD类成员方法详解

构造函数 & 初始化过程

$ td = new TD;class TD {
public function __construct {
// ... init logic ...
}
}
再看注意。如果配置文件方法错误会导致实例化失败，记得检查 db_config.php 的绝对方法。老实说，

SQL 执行方法


.query – 执行返回结果集或 FALSE
php
$result = $ td -> query;参数：$sql string 或 prepared statement string `
再看返回值，成功返回 mysqli_result 对象；说起来，失败返回 FALSE。

.execute – 执行不需要返回结果
php
$ success = $ td -> execute;适用于 INSERT/UPDATE/DELETE。

.prepare – 内置预编译
php
$stmt = $ td -> prepare VALUES ");$stmt->bind_param;$stmt->execute;其实，预编译既能提高性能，又能彻底杜绝注入风险。

小贴士：  若发现频繁出现 “mysqli::query: Couldn't fetch mysqli” 错误。请检查是否在同一脚本中多次实例化 $ td=new TD,可以使用单例模式或全局共享实例。

结果集处理 


.fetch_array – 获取关联数组
php $row=$ td->fetch_array;echo $row，

.fetch_row – 获取索引数组
php $row=$ td->fetch_row;其实，echo $row;老实说，

.fetch_object – 获取对象
php $obj=$ td->fetch_object;echo $obj->username;

.num_rows
再看获取记录数，`$count=$ td->num_rows;说起来，`

.free_result
资源。对大批量查询尤为关键：`$ td->free_result;`

*注意*：  当使用 prepare 时请通过 `$stmt->get_result` 获取结果集，再用上述 fetch 方法处理。


安全相关 API 


.escape
转义字符串，防止注入：
php
$safe_str=$ td->escape;$sql ="SELECT * FROM user WHERE name='$safe_str'";

.sanitize_int/floatval
对数字输入做严格校验。

*警告*: 在任何拼接语句前务必先 escape 或 bind 参数，否则你会面临严重的注入风险。

事务处理 


.begin
开启事务。按理说，`$ td->begin;`

.commit
提交成功 `.$ td->commit;其实，`

.rollback
回滚 `.$ td->rollback;`
再看示例，

try {
$ td -> begin;//扣减库存
$ sql1 = "UPDATE product SET stock=stock-?WHERE pid=，";$ stmt1 = $ td -> prepare;$ stmt1 -> bind_param;if ) throw new Exception;
//写订单日志
if VALUES ")) throw new Exception;说起来，$ td .commit;

} catch {
$ td .rollback;echo '操作失败：'.$ e -> getMessage;}


**关键**这方面。一定要在每个事务块结束后调用 commit 或 rollback，否则 MySQL 会自动回滚导致数据不一致。

缓存接口 



.cache_get
从获取缓存来看，$data=$ td cache_get; 




.cache_set
说到设置缓存，$ td cache_set; 


默认过期时间为一小时可根据业务自行调整。` 


.cache_delete
删除缓存键。


示例的观点是。


// 缓存使用者列表，一小时有效期
$key ="userlist";$userList =$ td cacheget;if{
// 查询数据库并组装数组
foreach as $row){
arraypush;}
// 写入 Redis
@$ td cacheset;}
// 使用缓存内容
printr;


从**提示**来看。如果你的业务对实时性要求极高，请不要把敏感状态信息放进缓存，而是仅缓存读操作频繁的数据，如商品目录、热门文章等。

"其他工具方法" 简要速查 快速上手必备！


方法名
功能描述
典型场景




insert_id
获取最近一次 INSERT 操作产生的自增 ID
新建使用者后立即读取其主键

affected_rows
统计 UPDATE/DELETE 操作影响的行数
批量删除时判断是否全部成功

getVersion
获取 MySQL 当前版本字符串
版本兼容判断

close
主动关闭链接










"四、TD类设计原理"

"类结构"



# 单文件实现，全局唯一实例化策略；若项目规模大，可采用工厂模式动态切换驱动。其实，