找回密码
 立即注册

QQ登录

只需一步,快速开始

Discuz! 插件开发经验之如何运用 C::t 方法


一、C::t方法的好处:一是对象清楚,二是对形参格式化处理,三是可集中SQL语句,利于维护,四是安全性更高。
二、具体用法,看下面的例子
假设有一个名为test的插件,其中关于名为tbname的数据表操作的SQL
旧式写法
a.inc.php
  1. <?php
  2. ……
  3. $query = DB::query('select * from '.DB::table('tbname').' where id='.$id);
  4. while($v = DB::fetch($query)){
  5. ……
  6. }
  7. ……
  8. ?>
复制代码

改造为C::t如下
a.inc.php
  1. <?php
  2. ……
  3. $query = C::t('#test#tbname')->fetch_all($id);
  4. foreach($query as $key => $value){
复制代码

或者将上面的两行变为一行,以减少行数,如下
  1. foreach(C::t('#test#tbname')->fetch_all($id) as $key => $value){
  2. ……
  3. }
  4. ……
  5. ?>
复制代码

再新建一个文件夹名为table,放在插件根目录下,在table中创建一个名为table_tbname.php的类文件(详见技术文库的相关说明),该文件的代码框架如下
table_tbname.php
  1. <?php
  2. if (!defined('IN_DISCUZ')) {
  3.     exit('Aecsse Denied');
  4. }
  5. class table_tbname extends discuz_table{
  6.     public function __construct() {
  7.         $this->_table = 'tbname';
  8.         $this->_pk = 'id';
  9.         parent::__construct();
  10.     }
  11.     /*------------在此处构造N多的自定义函数,本例中自定义的函数如下-------------*/
  12.     public function fetch_all($id){
  13.          return DB::fetch_all('select * from %t where id=%d',array($this->_table,$id));
  14.     }
  15. }
  16. ?>
复制代码

C::t的运用有很多变化,但万变不离其宗,基本骨架就是上面的样子。
注意:
1、自定义函数中有一个同名函数名fetch_all,虽然名字相同,但内涵不同。本例比较特殊,实际自定义函数名称你可以随便起,例如public function ldsjglfdjs($id),不一定非要像技术文库要求那样规则命名,当然,规则命名更易于辨认理解维护
2、SQL中应当用格式化语句书写,以保障安全性,其中的%t代表了对数据表名的格式化,%d代表了对%id的格式化,其中的含义请查询技术文库"源DB类的改进",以了解掌握都有哪些格式符及其意义并加以运用。这里要特别注意%s和%i的区别,涉及安全处理问题
3、虽然不是必须,但我仍建议并强调,以数组形参的形式作为DB层封装函数的第二参数(如果该函数有此参数的话),例如上例中的DB::fetch_all(SQL,array(第一形参,第二形参,...)),某些DB层封装的函数对于有无$arg这个数组参数有着不同的执行过程,将会影响对该参数中的变量是否进行安全过滤的行为
4、SQL中的格式符一定要和数组形参中的变量一一对应,不能颠倒
5、不提倡旧式的SQL写法,如DB::fetch_all('select * from '.DB::table('tbname').' where id='.$id),原因见上面的3
6、虽然不是必须,但C::t方法中自定义函数内最好不要使用诸如$_GET、$_POST之类的全局变量,应在C::t之前赋值后传入,否则,例如在DB::query中使用,如不进行过滤,其安全性将难以保障
7、大多数被DB封装的常用数据库操作函数,其参数都将被做安全处理,因此要注意,虽然不是必须避免重复过滤,但应考虑执行效率问题。
8、注意注意再注意,由于大多数被DB封装的常用数据库操作函数都要调用内部query函数,相当于在外部直接使用DB::query,而该函数有个特例情况,就是上面3所说,因此特别要考虑有无数组形参,进而加固安全性
9、尽量将SQL集中放在C::t方法的类文件中,避免在应用层等其他文件中使用SQL,这样能使对象更清晰规范方便维护

官方在source/class/table中已经内置了很多C::t方法,假设在插件设计时所用的方法是官方所没有的,而官方已创建了一个同名类文件,这时怎么办?那就按上面例子所示,自己创建一个同名类文件就行了,但应用层一定要用C::t('#插件标识符#不带前缀的表名')来调用,而不是C::t('不带前缀的表名')这种方式

闲暇之余多看看source/class/discuz中的discuz_database.php和dizcuz_table.php这两个重要文件,烂熟其中被DB封装的常用函数的执行原理和机制,对自如运用C::t和加强安全认识有好处

本教程由无限星辰工作室CRX349独家整理和提供,转载请注明地址,谢谢。本文地址:https://xmspace.net/thread-310-1-1.html
无限星辰工作室  好集导航 Discuz全集下载  星辰站长网  集热爱361  一品文学  手机小游戏合集   海外空间网 星辰api  星辰支付二维码管理平台 LOT智能硬件聚合平台 阿里云服务器 腾讯云服务器
服务Discuz!建站|DiscuzQ配置|二开|小程序|APP|搬家|挂马清理|防护|Win/Linux环境搭建|优化|运维|
服务理念:专业 诚信 友好QQ842062626 服务项目 Q群315524225

发表于 2015-2-11 11:03:25 | 显示全部楼层 |阅读模式

回复 | 使用道具 举报

该帖共收到 1 条回复!
类定义文件
DB类:
文件\source\class\class_core.php
  1. class DB extends discuz_database {}
复制代码

discuz_database类定义
文件\source\class\discuz\discuz_database.php



DB类封装常用方法:
  1. DB::table($table) //获取带前缀的表名
  2. DB::delete($table, $condition, $limit = 0, $unbuffered = true) //删除数据
  3. DB::insert($table, $data, $return_insert_id = false, $replace = false, $silent = false) //插入数据
  4. DB::update($table, $data, $condition, $unbuffered = false, $low_priority = false)//更新
  5. DB::insert_id()//返回插件的自增长id
  6. DB::fetch_first($sql, $arg = array(), $silent = false) //取查询的第一条数据fetch
  7. DB::fetch_all($sql, $arg = array(), $keyfield = '', $silent=false) //查询并fetch
  8. DB::result_first($sql, $arg = array(), $silent = false)//查询结果集的第一个字段值
  9. DB::query($sql, $arg = array(), $silent = false, $unbuffered = false) //普通查询 一条sql语句
  10. DB::limit($start, $limit = 0) //limit条件
  11. DB::order($field, $order = 'ASC')//返回排序
  12. DB::field($field, $val, $glue = '=')//返回字段条件 $val可以为数组
复制代码



另外从X2.5版本开始,discuz对数据库类进行了二次封装

数据库类定义在目录\source\class\table\
使用方法:C::t('tablename')->method();
插件新增的表mytablename
放置在目录:source/plugin/mypluginid/table/table_mytablename.php
使用类名:table_mytablename
使用用法:C::t('#mypluginid#mytablename')->method();
无限星辰工作室  好集导航 Discuz全集下载  星辰站长网  集热爱361  一品文学  手机小游戏合集   海外空间网 星辰api  星辰支付二维码管理平台 LOT智能硬件聚合平台 阿里云服务器 腾讯云服务器
服务Discuz!建站|DiscuzQ配置|二开|小程序|APP|搬家|挂马清理|防护|Win/Linux环境搭建|优化|运维|
服务理念:专业 诚信 友好QQ842062626 服务项目 Q群315524225

发表于 2018-8-14 12:48:07 | 显示全部楼层

回复 | 支持 | 反对 使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

美图秀

    • 自建远程桌面服务器 rustdesk
    • Discuz!x3.4 账号保镖 自动冻结账号无效解
    • PVE换主板后 网络丢失解决方法
    • Kvm 虚拟机迁移到PVE里面
    • Discuz!x3,4 阿里云DCDN配置获取客户端ip
拖动客服框
Online Service
点击这里给我发消息
点击这里联系我们
微信扫一扫
在线客服
快速回复 返回顶部 返回列表