Discuz二次开发教程

# Discuz二次开发教程

Discuz提供了完善的二次开发接口，PHP开发者可以在Discuz基础上开发自定义功能。

## 一、目录结构

“`
admin.php 后台入口
forum.php 论坛入口
portal.php 门户入口
source/ 核心源码
module/ 功能模块
class/ 核心类库
plugin/ 插件目录
data/ 数据和缓存
template/ 模板目录
static/ 静态资源（CSS/JS/图片）
uc_client/ UCenter客户端
uc_server/ UCenter服务端
“`

## 二、开发入口

Discuz采用模块化架构，入口文件通过 `mod` 参数路由到不同模块：

“`
forum.php?mod=xxx → source/module/forum/forum_xxx.php
portal.php?mod=xxx → source/module/portal/portal_xxx.php
“`

## 三、数据库操作

Discuz使用 `DB` 类操作数据库：

“`php
// 查询单条
$user = DB::fetch_first(“SELECT * FROM “.DB::table(‘common_member’).” WHERE uid = %d”, 1);

// 查询多条
$list = DB::fetch_all(“SELECT * FROM “.DB::table(‘forum_thread’).” WHERE fid = %d ORDER BY tid DESC LIMIT 10″, $fid);

// 插入
DB::query(“INSERT INTO “.DB::table(‘common_member’).” (username) VALUES (%s)”, $username);

// 更新
DB::query(“UPDATE “.DB::table(‘forum_thread’).” SET views = views + 1 WHERE tid = %d”, $tid);
“`

**注意：** 使用 `DB::table()` 获取表名（自动添加表前缀），使用 `%d`、`%s` 占位符防止SQL注入。

## 四、插件开发

### 4.1 插件目录结构
“`
source/plugin/你的插件名/
discuz_plugin_你的插件名.xml 插件配置文件
你的插件名.class.php 插件主类
template/ 插件模板
“`

### 4.2 插件配置文件（XML）
定义插件基本信息、版本号、入口点和后台设置页面。

### 4.3 插件钩子
Discuz 在核心流程中预置了大量钩子点，插件可以通过这些钩子介入执行。

## 五、常用全局函数

“`php
// 获取当前用户信息
$_G[‘uid’] // 当前用户ID
$_G[‘username’] // 当前用户名

// 显示消息提示
showmessage(‘操作成功’);

// 获取GET/POST参数
$_GET[‘mod’]
$_POST[‘message’]

// 检查是否登录
if(!$_G[‘uid’]) { showmessage(‘请先登录’); }
“`

## 六、开发注意事项

– 修改核心文件前先备份
– 自定义代码优先用插件方式开发，方便升级
– 遵循 Discuz 的编码规范
– 使用 DB 类操作数据库，不要直接使用 mysql 函数
– 开发完成后在多个浏览器和设备上测试