Discuz教程

Discuz教程

插件制作的基本思路是：（初学者适用）1.形成插件思路

2.制作插件界面

3.构架程序模块

4.搭建存储数据

5.填充功能语句

6.检查应用错误

7.完善插件功能

前言：为方便互联网数万Discuz!爱好者，更加深入了解Discuz!软件，本人在熟悉Discuz!过程中，顺便将个人经

验写给大家。本贴内容由本人定期更新。本贴只介绍Discuz!中部分技术点，本贴紧属个人观点，不足之处，请

各位多多指教，在下先此谢过！。“Discuz!”在下文中简称“DZ”。要弄DZ二次开发，必须至少具备如下技能：1）能够理很好理解MVC构架的原理(虽然DZ不是MVC架构的)

2）扎实的PHP基础，熟悉结构化程序，OOP程序的写法及应用

3）熟悉MYSQL就用，掌握SQL语言，懂SQL优化者更佳

4）熟悉使用Discuz!的各项功能

一）Discuz!的文件系统目录

注：想搞DZ开发，就得弄懂DZ中每个文件的功能。a)Admin：后台管理功能模块

b)Api：DZ系统与其它系统之间接口程序

c)Archiver：DZ中，用以搜索引擎优化的无图版

d)Attachments：DZ中,用户上传附件的存放目录

e)Customavatars：DZ中，用户自定义头像的目录

f)Forumdata：DZ缓存数据的存放目录

g)Images：DZ模板中的图片存放目录

h)Include：DZ常用函数库，基本功能模块目录

i)Ipdata：DZ统计IP来路用的数据

j)Plugins：DZ插件信息的存放目录

k)Templates：DZ模板文件的存放目录

l)Wap：DZ无线，Wap程序处理目录

二）必须记熟Discuz!数据库设计的每个表的功能，每个表中每个字段的功能。

关于DZ数据库设计文档，请参阅DZ相关的项目文档(请从本贴附件中下载)

三）Discuz!的流程控制a)后台流程控：DZ后台所有的功能，均需要注册到admincp.php文件，每个功能都至少有一个或一个以上的

Action(动作)，在admincp.php中，可以定义Action的执行权限，分别为：“admin==1”管理员，或“admin==2||

admin==3”超级版主和版主，每个Action对应一个脚本文件，脚本文件的命名为action.inc.php(*.inc.php)，并存

放在admin目录下，如执行：admincp.php?action=dodo，相当于执行admin目录下的dodo.inc.php文件b)前台流程控制：前台的流程控制比较简单：流程是自由的，如：

首页：index.php

会员注册：register.php；

会员登录：logging.php

发贴程序：post.php

会员信息：member.php

论坛内容：forumdisplay.php

查看贴子：member.php

…大部分功能，此处不一一列出…c)DZ根目下的config.inc.php属于整个DZ系统的配置文件

四）Discuz!的数据处理过程a)DZ对mysql的数据库操作处理全部封装在dbstuff(db_mysql.class.php)类中

b)所在的外部数据均通过“daddslashes()”初步过滤，然后再过滤，再根据需要处理

五）Discuz!的显示控制(网站多样式风格输出)a)显示层就是大家通常所看到的网站风格了。DZ中每套风络分别在templates及images下对应一个风格文件的

存放目录。网站风格的制作，请参阅详细的DZ风格制作文档b)DZ网站风格文件处理的原理：其实很简单，DZ使用template.func.php中的parse_template()以PHP正则运算把

htm模文件中的模板标签，转换成了PHP代码，并根据styleid保存在forumdata/templates下，这个有点像Smarty

中的技术。

六）DZ中的语言处理a)DZ前台及后台中、英语言的实现，均是把语句定义成了语变量，然后在模板输入，语句变量的赋值，均放在

模板目录中的*.lang.php文件中，DZ在生成网站风格时就加载了这相应的语言包。

七）DZ如何处理用户信息(存取、计算、更新过程)新手要做二次开发，都必须掌握这数组中，每个数组元素的意义。a)DZ的基本信息，如用户信息，Session信息存在如下变量中：

a).$_DCACHE

b).$_COOKIE

c).$_DCOOKIE

d).$_DSESSION

e).$_DPLUGIN

b)可以通过print_r($GLOBALS)，打印全部变量

八）DZ中缓存处理机制a)DZ中缓存处理过程都放在“cache.func.php”中，DZ的缓存处理比较简单，其原理是把一个数组转换成了PHP

代码，并保存在缓存目录下，大家可打开缓存文件查看便知。b)使用方法：如果在新开的功能中，需要缓存某部分数据，基本上就是：

1）定义并注册缓存名字。

2）从数据读取相应的数据。

3）数据在写入缓存前作相应处理。

4）最后写入缓存。

具体操作，可以看文件中的代码，做相应的修改即可

九）DZ中模板处理机制a)DZ独创的模板处理技术，类似于Smarty中的模板处理，只是具体算法，过程不同，Smarty是一种重型模板引

擎方案。其原理都是把模板中的变量转换成相应的PHP代码，这个过程实际是模访JAVA中的一次编译，多处运

行。

十）DZ中权限处理机制a)对于DZ中前台的每相action都有$discuz_action定义，DZ根据用户所在的用户组来判定用户是否具有相应操

作$discuz_action的权限。至于后台的权限权验证，则更简单了，依据“admin==1”来确定的

十一）DZ中如何实现URL静态化a)DZ中的静态有两法，只要懂ReWrite规划的朋友，一看就知。

十二）DZ独创的HTML编辑器，如何截取并使用，如果进行Discuz!代和Html代码的转换a)这也算是DZ比较牛的一项技术了，在早期版中，因DZ编辑器的不足，使得很多用户放弃了DZ。实现原理：

通过JS把用的一些操作转换成了DZ的bbcode代码。这样子提交了安全性，将带有bbcode代码的内容存入数据，

在用户打开页页时，又把bbcode代码转换成html代码

本贴声明：由于时间有限，本贴只有关于DZ部分功能的简短分析。若各位网友，对本文感兴趣并想更为深入了

解DZ，请在本贴后回贴！我将尽可能多的DZ技术分析写在本文，不断更新本贴内容。

部分文件说明:admincp.php管理

ajax.phpajax功能

announcement.php公告

attachment附件

board.php真正的首页

config.inc.php这个是配置文件

corpus.php论坛文集

digest.php精华帖子

discuz_version.php论坛版本号

faq.php问题列表

forumdisplay.php论坛列表

index.php跳转页面

loggin.php认证页面(登录退出)

mail_config.inc.php邮件配置

member.php用户操作

memcp.php个人控制面版

misc.php零碎功能

my.php我的帖子

plugin.php插件

pm.php短信

post.php发送帖子

redirect.php页面重定向

register.php注册

robots.txt限制搜索

rss.phprss信息发布

search.php论坛查询

secode.php验证码

stats.php统计

topic.php首页论坛专题

topicadmin主题管理

viewpro.php显示个人信息

viewthread.php主题显示文件夹admin管理

api接口

archiver文档

attachments附件

customavatars自定义表情

forumdata论坛数据包含缓冲数据

images图片

include公共文件

install安装包

ipdataip地址

plugins插件

readme帮助文档

templates模板

utilities工具包

wap手机网站

文件夹includeadvertisements.inc.php广告管理

ajax.jsajax相关

attachment.func.php附件函数集

bbscode.js论坛表情

cache.fun.php缓存函数集

category.inc.php栏目

chinese.class.php

common.inc.php最主要的头文件

common.js最主要的js文件

corpus.func.php论坛文集函数

counter.inc.php论坛计数

cron.func.php计划任务

db_mysql.class.php数据库

db_mysql_error.inc.php数据库错误

debug.php调试信息

discuzcode.func.php论坛代码

editor.func.php编辑器

editor.js编辑器

editpost.inc.php编辑帖子

floatadv.js浮动广告

forum.func.php论坛函数集

global.func.php全局函数

menu.js菜单

misc.func.php其它

newreply.inc.php新回复

newthread.inc.php新主题

*pmprompt.inc.php

post.fun.php发表主题

printable.inc.php论坛打印

qihoo.jsqihoo

relatethreads.inc.php相关主题

security.inc.php安全

sendmail.inc.php邮件

serverbusy.htm系统繁忙

template.func.php模板

threadpay.inc.php购买帖子

为什么文件的命名有inc呢？

文件命名规范Discuz!按照如下的规范对程序和模板进行命名，请在设计插件时尽量遵循此命名规范：

1.可以直接通过浏览器访问的普通程序文件，以.php后缀命名。

2.被普通程序文件引用的程序文件，以.inc.php后缀命名。

3.被普通程序文件，或引用程序文件引用的函数库或类库，以.func.php(函数库)或.class.php(类库)后缀命名。

4.模板文件，以.htm后缀命名，模板文件只存在于./templates目录中。

5.模板语言包文件，以.lang.php后缀命名，语言包文件只存放于./templates目录中，与模板文件同级目录。

6.被编译后的模板文件，以.tpl.php后缀命名，前面的数字是模板套系的ID，下划线后面的是模板原名，编译

模板文件只存在于./forumdata/templates目录中。