在zblog主题或插件应用开发中,难免会有新增数据库表的需求,直接手动在数据库中新增对于自用应用影响不大,但对于面向众多用户的收费应用就显得很不友好了,因此,通过代码在应用启用的时间自动创建对应的数据库表就很有必要。下面是趣主题转自Z-Blog官方文库Wiki的以收藏文章功能为例演示zblog php关于自定义数据库表的教程,介绍了建表与增删改查,较为详细。

提示:该教程代码只验证了MySQL数据库,其余的需要自行验证。

建表教程

声明定义数据表结构
12345678910111213141516171819202122232425262728 function 插件ID_defineDatabase(){ $database = array( /** * 收藏表 */ ‘插件ID_Collect’ => array( ‘table’ => ‘%pre%插件ID_collect’, ‘datainfo’ => array( ‘ID’ => array(’cc_ID’, ‘integer’, ”, 0), ‘UID’ => array(’cc_UID’, ‘integer’, ”, 0), ‘LogID’ => array(’cc_LogID’, ‘integer’, ”, 0), ‘CreateTime’ => array(’cc_CreateTime’, ‘integer’, ”, 0), ‘Meta’ => array(’cc_Meta’, ‘string’, ”, ”), ), ), ); foreach ($database as $key => $v) { $table = $v[’table’]; $datainfo = $v[’datainfo’]; $GLOBALS[’table’][$key] = $table; $GLOBALS[’datainfo’][$key] = $datainfo; } return $database;}插件ID_defineDatabase();

这是一个声明插件数据表结构的函数。为什么要在定义函数以后就执行?因为需要在插件运行前,将结构信息赋值到全局变量中,来自于c_system_base.php同类风格的声明结构,并不表示就是固定格式,其中建议以类的名称为数据库表的声明key,方便后期的可读性。

字段“table”是数据表的名称,用%pre%+插件ID+数据表名称的方式组成。字段“datainfo”是数据字段的结构,有具体的声明结构,可以在zb_system/function/lib/sql/中查看不同数据库的语句拼接。关于datainfo的声明结构说明:根据声明的顺序,数组第一条在MySQL中会加上索引(PRIMARY KEY)。

声明的代码结构

1 array(’字段名’, ‘类型’, ‘长度参数(根据类型定义)’, ‘默认值’);

下面是简单演示常用类型的声明,具体的类型可以自行补充MySQL的基础知识

1234567891011121314151617 // intarray(’ID’, ‘integer’, ”, 0),// tinyintarray(’Type’, ‘integer’, ‘tinyint’, 0),// bigintarray(’EndTime’, ‘integer’, ‘bigint’, 0),// chararray(’Value’, ‘char’, 10, ”),// varchararray(’Title’, ‘string’, 250, ”),// longtextarray(’Content’, ‘string’, ”, ”),
写一个创建数据库表的方法,在启用主题或插件应用的时候执行
12345678910111213141516171819202122232425262728 function 插件ID_createTable(){ global $zbp; $database = 插件ID_defineDatabase(); foreach ($database as $k => $v) { if (!$zbp->db->ExistTable($v[’table’])) { $s = $zbp->db->sql->CreateTable($v[’table’], $v[’datainfo’]); $zbp->db->QueryMulit($s); } }}// 删表的方法 具体什么时候删,自行决定function 插件ID_delTable(){ global $zbp; $database = 插件ID_defineDatabase(); foreach ($database as $k => $v) { if ($zbp->db->ExistTable($v[’table’])) { $s = $zbp->db->sql->DelTable($v[’table’]); $zbp->db->QueryMulit($s); } }}

在插件的启用函数中调用

1234 function InstallPlugin_插件ID(){ 插件ID_createTable();}

接下来声明一个类继承Base完成基本的增删改查操作

12345678910111213141516 class 插件ID_Collect extends Base{ /** * 在构造函数中 * 将定义的数据表名称与数据结构交给父类Base去处理 */ public function __construct() { global $zbp; parent::__construct($zbp->table[’插件ID_Collect’], $zbp->datainfo[’插件ID_Collect’], __CLASS__); // 因为数据中有一条创建时间字段,提前在此赋予默认值 $this->CreateTime = time(); }}

基于这个类,就可以进行基本的curd了

操作类进行增删改

1、新增一条数据

123456789 function 插件ID_addCollect($userId, $logId){ $collect = new 插件ID_Collect(); $collect->UID = $userId; $collect->LogID = $logId; $collect->Save(); // 保存后,$collect->ID就能输出这条记录的ID了 echo ‘添加成功’;}

如果不操作类进行增加,也可以使用sql插入数据,参考:

123456789101112131415 function 插件ID_addCollect($userId, $logId){$dataArr = array(’UID’ = $userId,’LogID’ = $logId);$sql= $zbp->db->sql->insert($GLOBALS[’table’][’插件ID_addCollect’],$dataArr);$insert = $zbp->db->insert($sql);if($insert){echo ‘添加成功’;die();}else{echo ‘添加失败’;die();}}

2、更新一条数据

12345678910 function 插件ID_updateCollect($collectId){ $collect = new 插件ID_Collect(); $status = $collect->LoadInfoByID($collectId); if ($status) { $collect->CreateTime = time(); $collect->Save(); } // 这样收藏的时间就变成了最新的}

3、删除一条数据

12345678 function 插件ID_delCollect($collectId){ $collect = new 插件ID_Collect(); $status = $collect->LoadInfoByID($collectId); if ($status) { $collect->Del(); }}

4、查询数据,单独阐述:已知ID的情况,通过上面演示的LoadInfoByID($ID) 就能通过父类Base的方法读取一条数据,在只知道UID和LogID,就需要组装where语句。

1234567891011121314 function 插件ID_getUserCollect($userId, $logId){ global $zbp; $w = array(); $w[] = array(’=’, ‘cc_UID’, $userId); $w[] = array(’=’, ‘cc_LogID’, $logId); $sql = $zbp->db->sql->Select($zbp->table[’插件ID_Collect’], array(’*’), $w); $list = $zbp->GetListType(’插件ID_Collect’, $sql); if (count($list) > 0) { return $list[0]; } return false;}

其它的查询,比如查询某用户的指定数量收藏记录

123456789101112 function 插件ID_getUserCollectList($userId, $num = 10){ global $zbp; $w = array(); $w[] = array(’=’, ‘cc_UID’, $userId); $num = (int) $num > 0 ? (int) $num : 10; $sql = $zbp->db->sql->Select($zbp->table[’插件ID_Collect’], array(’*’), $w, null, $num); $list = $zbp->GetListType(’插件ID_Collect’, $sql); return $list;}

扩展:多说插件参考

12345678910111213141516171819 #表名$table[’plugin_duoshuo_comment’] = ‘%pre%plugin_duoshuo_comment’;###注意表名要加上%pre%可以区分同一数据库中的不同的程序所生成的表 #表结构$datainfo[’plugin_duoshuo_comment’] = array(’ID’ => array(’ds_ID’,’integer’,”,0),’key’ => array(’ds_key’,’string’,128,”),’cmtid’ => array(’ds_cmtid’,’integer’,”,0));#全局声明global $zbp;#判断是否已创建,否则新建数据表if(!$zbp->db->ExistTable($GLOBALS[’table’][’plugin_duoshuo_comment’])){$s = $zbp->db->sql->CreateTable($GLOBALS[’table’][’plugin_duoshuo_comment’],$GLOBALS[’datainfo’][’plugin_duoshuo_comment’]);$zbp->db->QueryMulit($s);}

有区别,但可参考。

教程原地址:https://wiki.zblogcn.com/doku.php?id=zblogphp:development:plugin:自定义数据库表

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。