插件编写规范和流程

为了能让更多的人加入到编写插件的队伍中来,避免由于编写不规范而引起论坛安全问题.写了这么一个文档,希望对插件作者和对插件有浓厚兴趣的有多帮助。前面泡哥已经写过一个关于怎么写插件的帖子了(http://www.discuz.net/thread-315307-1-1.html),当时写的是Discuz4.x的,关于Discuz5一直没更新，我就补上我这篇.有什么建议欢迎大家讨论. 也不罗嗦了，马上就开始写插件吧,都说光看不练是不行的.这次我就拿怎么重新编写规范的<<斑竹申请>>这个插件来给大家讲解一下,写插件的流程.当然应该还是要感谢原作者的创意. NO.1.         一个好的插件来源于好的想法和好的结构设计.一个程序的开发，50%的时间不是用在代码开发上，而在设计和分析上。插件也是，第一步当然是分析插件的功能需要用到什么,怎么实现,怎么设计了.这里原作者已经给帮我们想好了。我们就按他的思路来走一边吧. 在开始之前,我先简单的说一下变量的命名尽量使用能一目了然的英文意思,不要拼音,英文合用. 先找到与Discuz相关联的地方 申请斑竹的要求:         会员最多能申请次数:                applycount                                int         注册时间不少于几天:                lowestregdates                        int         最低要求积分数 :                integral                                int         相关的积分扩展 :                extcredit                                        text         最低发贴数          :                lowestposts                        int 和Discuz相关联的地方我们已经设计好了。这样就可以先去后台把相关的地方设置好了. 扩展设置->插件管理 添加以后,选右边的详情在进行设置.在设置之前,我们先来介绍一个标准的插件的文件和目录结构.这个在泡哥的帖子里已经说过一次了，我再重复一次吧. D:WWWDiscuzplugins └─ apply                                ------插件整体目录     ├─images                        ------插件图片目录     │  └─img_apply                                        ├─apply                        -------插件程序存放目录     └─templates                        -------插件模块存放目录         └─defaults         |------apply.lang.php                -------语言包(这个是可选的)         |------apply.htm                -------模版文件用htm结尾         |------adminapply.htm |----apply.inc.php                        --------插件程序配置文件 |----discuz_plugin_apply.txt                --------这个是生成的. |----apply.sql                        --------数据库表文件 |-----readme.txt NO.2设计数据库         这里我就不多复述了。给出我的表结构: 表名:cdb_plugin_apply appid                     申请ID uid                         用户ID username               用户名 fid                         版块ID fname                    版块名 suggest                申请建议 description            自我介绍 nettime                上网时间 dateline                申请时间 agreeapply            是否同意 前期的设计到这里就结束了. NO.3 程序的开发--程序不但要考虑安全,效率，也要考虑代码的编写规范和美观. Discuz调用插件的过程是先访问plugins/apply/apply.inc.php(这里的apply目录名是上面我们自己指定好的),所有的插件访问过程都是从apply.inc.php开始的.那我们的程序编写也从这个开始. 朱砂紫金砂手串晶体砂透光手串女款和田玉国风 18k黄金项链锁骨链k金素链细款 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 <?php If(!defined('IN_DISCUZ')) {         Exit('Access Deined'); } 复制代码 建议:在每个插件程序的开头加上上面的代码.这是为了防止禁止直接外部访问文件 @include_once DISCUZ_ROOT.'./forumdata/cache/plugin_apply.php'; 复制代码 调用DISCUZ生成的插件参数的缓存文件.调用缓存文件以后,就可以调用里面的变量了. Discuz生成的插件参数的配置文件是保存在一个二维的数组里的。$_DPLUGIN[‘apply’][‘vars’]; 这里我们为了美观,对这个二维数组进行一下简化 $applycount = $_DPLUGIN['apply']['vars']['applycount']; $lowestregdates = $_DPLUGIN['apply']['vars']['lowestregdates']; $integral = $_DPLUGIN['apply']['vars']['integral']; $extcredit = $_DPLUGIN['apply']['vars']['extcredit']; $lowestposts = $_DPLUGIN['apply']['vars']['lowestposts']; 复制代码 到这里插件的初始化就完成了.在继续我们的插件编写之前.我先介绍一下Discuz对变量是怎么处理,怎样才写出安全的插件. 大家可以先看一下Discuz的include/目录下的common.inc.php文件的第31行和global.func.php的111行.这个Discuz在进行数据处理之前，首先进行的初始化功能, $magic_quotes_gpc = get_magic_quotes_gpc(); 朱砂紫金砂手串晶体砂透光手串女款和田玉国风 18k黄金项链锁骨链k金素链细款 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 @extract(daddslashes($_COOKIE)); @extract(daddslashes($_POST)); @extract(daddslashes($_GET)); if(!$magic_quotes_gpc) {         $_FILES = daddslashes($_FILES); } function daddslashes($string, $force = 0) {         if(!$GLOBALS['magic_quotes_gpc'] || $force) {                 if(is_array($string)) {                         foreach($string as $key => $val) {                                 $string[$key] = daddslashes($val, $force);                         }                 } else {                         $string = addslashes($string);                 }         }         return $string; } 复制代码 这两段的代码功能就是在magic_quotes_gpc为off的情况,对$_GET,$_POST,$_COOKIE的值以及数组里面的每个值都进行转义,因为在magic_quotes_gpc为On时PHP本身自动会对这几个全局的变量进行转义,这些具体的内容介绍,可以看一下PHP相关的资料. 从这里可以看出Discuz本身已经对变量做了一个安全的处理.在编写插件时就应该尽量使用Discuz处理过的变量. 因为我们在开头使用了defined(‘IN_DISCUZ’)进行判断.现在所有想访问此文件的都必须从Discuz过来,也就会经过common.inc.php对变量进行处理. 这里需要强调的一点: Discuz是对提交过来的变量的值进行了转义,我们可以认为他过来的值就是一个字符串,那么在使用他的时候,要尽量放在一个不会解析变量的单引号内.这样无论是安全还是效率都会有所提高.尤其是在SQL语句中.一定要把变量放在单引号呢。例如 $db->query("SELECT * FROM cdb_members WHERE uid='$discuz_uid'"); 再说几个写插件时经常要用到的函数,其实有很多东西Discuz已经帮大家做好了,大家可以拿来就用.具体的使用可以查找Discuz的代码 常用的函数: include template('apply') 调用模版         (模版名一定要以htm结束,如apply.htm) include language('apply') 调用语言包                  (语言包的命名上面已经说了,apply.lang.php) showmessage                   提示信息          例如:showmessage('not_loggedin','logging.php?action=login'); dhtmlspecialchars                对html标签进行转义 FORMHASH                        生成表单唯一的标识 ispage()                                判断页号是否是数字 multi()                                分页函数 sendpm                                发送短消息 forumselect() 数据库操作类 $db->query(); $db->result(); $db->fetch_array(); 常用的常量: $discuz_uid,$discuz_user,$adminid 朱砂紫金砂手串晶体砂透光手串女款和田玉国风 18k黄金项链锁骨链k金素链细款 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠 天然和田玉晴水散珠同款手串文玩手串配珠