Discuz开发教程.docx
《Discuz开发教程.docx》由会员分享，可在线阅读，更多相关《Discuz开发教程.docx（48页珍藏版）》请在冰豆网上搜索。
Discuz开发教程
Discuz开发教程.txt跌倒了，爬起来再哭~~~低调！
才是最牛B的炫耀！
！
不吃饱哪有力气减肥啊？
真不好意思，让您贱笑了。
我能抵抗一切，除了诱惑……老子不但有车，还是自行的……插件制作的基本思路是：
（初学者适用）
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
查看贴子：
viewthread.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手机网站
文件夹include
advertisements.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目录中。
7.动态缓存文件，存放于./forumdata/cache目录中，依据不同的功用进行独立的命名。
8.使用后台数据备份功能生成的备份文件，通常以.sql为后缀，存放于./forumdata/目录中。
9.有些目录中存在内容为空白的index.htm文件，此类文件是为了避免Web服务器打开DirectoryIndex时可能产生的安全问题。
模块类型：
插件模块和自定义菜单：
插件接口默认提供四种可选的模块方式：
1.直接链接（前台菜单）：
可在前台右上角加入一个菜单项，可自主指派菜单链接的URL。
注意：
由于引用外部程序，因此即便设置了模块的使用等级，您的程序如需权限判断，仍需要引用common.inc.php和插件相关的缓存文件（将在后面的《参数读取与缓存控制》中详细说明），并自行判断使用等级是否合法；
2.前台调用（前台菜单）：
与直接链接类似，但其调用的是插件的一个模块，模块文件名指派为“./plugins/插件目录/插件模块名.inc.php”，由plugin.php调用此模块，调用URL将在后面的《编写插件的原则与注意事项》中详细说明；
3.后台调用（后台菜单）：
可在后台插件设置中为此插件增添一个管理模块，模块文件名指派为“./plugins/插件目录/插件模块名.inc.php”，由admincp.php调用此模块，调用URL将在后面的《编写插件的原则与注意事项》中详细说明；
4.包含运行（无菜单）：
可设置一个在论坛所有页面均包含运行的脚本，此脚本在./include/common.inc.php中加载，脚本文件名指派为“./plugins/插件目录/插件模块名.inc.php”。
请注意，为了不导致错误的插件影响论坛运行，在common.inc.php加载此模块时，屏蔽了错误信息，因此请务必仔细检查是否存在语法错误，任何微小的语法错误都将不被提示出来，并且导致此模块不被正常加载。
如果您配置了不正确的包含脚本而导致论坛系统设置无法使用，删除服务器上相应的脚本文件即可解决。
您可以为每个模块设置不同的使用等级，例如设置为“超级版主”，则超级版主及更高的管理者（例如论坛管理员）可以使用此模块。
看到了应该很简单前台文件、后台文件、调用外部文件、初始化文件！
就这四种！
那么一般的插件文件当然是前台调用
这里要说明一个调用问题，文中多次说到./include/common.inc.php是否加载，也就是说加载了这个文件，你就可以轻松的得到会员名、会员uid、会员的积分信息、论坛的分类、各级会员组用户组信息，简单说就是汽车加了汽油你可以开了，前后台调用都加载了这个文件；包含运行是把程序写入这个文件；前台链接没有加是需要你另外添加的！
第四章Discuz!
中常用文件说明
第一节常用文件说明
DZ程序文件目录含义整理表
请看以上,感谢作者sw08
以下内容版权归原作者sw08哦
最近看见很多人热衷于功能增强型HACK的修改。
这种功能增强型HACK和平时所说的插件不一样，插件是单独的文件，一般在后台导入即可使用。
但是功能增强型HACK更多是修改程序源代码来实现自己需要的功能，本人做得最多就是这类。
可以说功能增强型HACK是插件的前身，想做插件就一定要做熟功能增强型HACK。
功能增强型HACK挺简单，因为代码修改量不多，而且一般以改代码为主；说难，因为一般不好找文件，而且一旦对程序结构不熟悉，马上陷入迷坑。
这里先简单说下Discuz!
的所有文件，目前所代表的含义，方便大家修改时候避免找不到改哪个文件。
这是个基本功，一定要熟练~熟悉了文件的话，随便做个功能增强型HACK根本就是不费吹灰之力的事情。
先说根文件：
admincp.php——后台系统设置程序文件，一般只处理菜单的显示的访问权限，不处理管理控制。
attachment——附件文件，仅仅处理附件下载的功能。
announcement.php——论坛公告的显示，一般很少改
blog.php——浏览BLOG文章时候会用的，非常容易理解
config.inc.php——配置论坛数据库、密码等信息，这个大家最熟悉了
digest.php——论坛精华区的信息显示，不用多说了吧？
discuz_version.php——论坛版本信息，用来更新用的，没有官方说明绝对不要修改
faq.php——论坛帮助系统，不过我看绝对没人用
forumdisplay.php——很简单，论坛主题列表的显示
index.php——控制首页元素显示
logging.php——登陆系统，判断用户名、密码。
mail_config.inc.php——配置论坛EMAIL功能
member.php——控制会员列表显示，积分策略等等信息显示
memcp.php——会员控制面板
misc.php——控制评分功能、BLOG、论坛界面显示功能等等
plugin.php——论坛插件，这个主要控制论坛插件的菜单的显示，一般极少修改
pm.php——论坛短信息程序，控制短信息发表与浏览
post.php——与viewthread.php相似，但是更多是管理帖子发表、编辑等等信息，也会有权限的控制提示
redirect.php——控制显示论坛的最后发表的主题访问
register.php——注册文件，同时也会控制注册的信息的合法性
rss.php——RSS快速订阅，不用多说了吧？
search.php——处理论坛搜索功能中的信息筛选
seccode.php——论坛注册，生成验证码的程序
stats.php——处理统计中的统计信息
topic.php——一般无法直接访问，控制页面显示，显示主题条数
topicadmin.php——控制的是管理人员的前台管理操作，如精华、置顶、高亮等等
viewpro.php——处理浏览会员信息的内容显示
viewthread.php——处理浏览帖子时候的帖子信息显示，例如信息、标题等等，同时也处理访问帖子的权限，如阅读权限是否足够等等。
接着开始说文件夹里面的文件了，一个个开始：
有人会问，那个空index.htm是干什么用的，我可以回复，那是防止列目录查看文件用的，避免安全问题。
admin===（管理后台的程序文件，全部在这里，仅能通过admincp.php来访问）
标记红色的文件最好别动，毕竟主程序被加密，而且也是违背官方授权协议的。
home.inc.php——后台首页内容
settings.inc.php——Discuz!
选项下的所有小分类
passport.inc.php——一堆通行证的东西
avatarshow.inc.php——天下秀
qihoo.inc.php——奇虎搜索
forums.inc.php——论坛编辑下面所有子分类
members.inc.php——添加用户、编辑用户、合并用户、用户栏目定制
groups.inc.php——分组与级别下所有子分类
announcements.inc.php——只有论坛公告发布的管理
styles.inc.php——风格管理
templates.inc.php——模板在线编辑
moderate.inc.php——一堆审核，审核新用户、审核新主题、审核新回复
recyclebin.inc.php——单独的回收站程序
ecommerce.inc.php——支付宝，不过最好别动
misc.inc.php——勋章编辑、在线列表定制、联盟论坛、计划任务、Discuz!
代码、词语过滤、Smilies编辑、附件类型尺寸、积分交易记录，管理得真多，甚至连后台的退出功能也归这个文件管。
advertisements.inc.php——广告管理
database.inc.php——资料备份、资料恢复、数据库升级、数据表优化
attachments.inc.php——编辑附件，只有一个
counter.inc.php——更新论坛统计
threads.inc.php——批量主题管理
prune.inc.php——批量删帖、清理短消息
plugins.inc.php——插件设置、插件管理
logs.inc.php——运行记录，除了积分交易记录以外的所有记录
tools.inc.php——管理更新缓存、JS调用向导、文件权限检查
menu.inc.php——后台左边那个好长的导航菜单就是了
Api目录的文件是全部被加密过的，无法修改也不能修改，详情见官方授权协议。
archiver==（特别说明下，因为archiver中的目录的文件没有调用commom.inc.php，所以所有变量、函数都不能直接使用，必须要搜索数据库来进行判断）
index.phparchiver首页
include==
thread.inc.phparchiver主题显示
index.inc.php这个是过滤论坛权限和界面显示用的
header.inc.phparchiver风格控制
forum.inc.phparchiver论坛显示
attachments是论坛附件的存放目录
customavatars是论坛头像的存放目录
forumdata是论坛记录和缓存文件的存放目录，一般这些文件都是自动生成的，所以不要修改。
至于有什么用途也说下吧。
cache==（很好用的功能，调用的这里的文件变量是非常快的）
admingroup_X.php管理组权限
cache_bbcodes.phpBBCODE和SMILES
cache_blog.php所有用户组的权限变量和smilies、bbcode，还有发帖数等级的信息
cache_censor.php屏蔽信息
cache_crons.php计划任务
cache_forumdisplay.php论坛信息与公告
cache_forums.php同上
cache_index.php在线列表、联盟论坛、公告
cache_ipbanned.php封IP段记录
cache_medals.php勋章信息
cache_post.phpsmilies、bbcode、icons
cache_profilefields.php暂时不清楚
cache_settings.phpsetting表设置的参数变量
cache_viewthread.php论坛，用户组，smilies、bbcode、icons
plugin_XX.php插件表
style_XX.php风格缓存
usergroup_XX.php用户组缓存
templates==（升成的模板PHP，比较少做插件会用到，忽略）
根部的一些LOG文件就是后台记录文件了。
images是图片目录，忽略过~
include是论坛核心程序目录，非常有必要去了解。
crons==（这里是计划任务文件，你可以增加自己的计划任务，而且可以调用系统变量）
tables==（几个语言文件，很少改，跳过）
serverbusy.htm系统错误信息
bbcode.jsDiscuz!
代码JS效果文件
common.js主要是DZ常用的模板函数文件，可以直接用
floatadv.js广告用的
qihoo.js奇虎的文件，不改
threadpay.inc.php出售帖
template.func.php控制模板缓存生成的文件
sendmail.inc.php发送EMAIL的程序
security.inc.php好像是代理一类的，不管
relatethreads.inc.php应该说是生成相关主题的程序
promotion.inc.php记录当前用户的IP等信息
printable.inc.php打印主题用的程序
post.func.php不错的函数文
升级会员 