当前位置：首页 > news >正文

《Discuz! X3.5开发从入门到生态共建》第3章 Discuz! X3.5 核心目录结构解析-优雅草卓伊凡

news 来源：原创 2025/6/4 15:19:27

《Discuz! X3.5开发从入门到生态共建》第3章 Discuz! X3.5 核心目录结构解析-优雅草卓伊凡

3.1 系统核心目录结构

Discuz! X3.5采用模块化设计，主要目录结构如下：

discuz_root/
├─ api/                  // API接口目录
├─ config/              // 配置文件目录
│   ├─ config_global.php      // 全局配置文件
│   ├─ config_ucenter.php     // UCenter配置
│   └─ ...
├─ data/                // 数据目录
│   ├─ cache/           // 缓存文件
│   ├─ log/             // 日志文件
│   └─ ...
├─ source/             // 核心源代码
│   ├─ admincp/        // 后台管理
│   ├─ class/          // 核心类库
│   ├─ function/       // 函数库
│   ├─ include/        // 包含文件
│   ├─ language/       // 语言包
│   ├─ module/         // 功能模块
│   └─ plugin/         // 插件机制
├─ static/             // 静态资源
├─ template/          // 模板目录
├─ uc_client/         // UCenter客户端
├─ uc_server/         // UCenter服务端
└─ upload/            // 上传目录

3.2 模板核心目录结构详解

template/
├─ default/           // 默认模板
│   ├─ common/        // 公共文件
│   ├─ forum/         // 论坛模板
│   ├─ home/          // 个人空间
│   ├─ member/        // 会员相关
│   ├─ portal/        // 门户模板
│   ├─ search/        // 搜索模板
│   ├─ style/         // 样式表
│   ├─ tag/           // 标签模板
│   └─ ...
└─ 自定义模板/        // 用户自定义模板（结构同上）

主要模板文件类型：

.htm：模板主文件
.css：样式表
.js：脚本文件
图片资源

3.3 插件目录结构详解

source/plugin/
├─ 插件A/
│   ├─ plugin_插件A.xml    // 插件配置文件
│   ├─ install.php        // 安装脚本
│   ├─ uninstall.php      // 卸载脚本
│   ├─ upgrade.php        // 升级脚本
│   ├─ discuz_plugin_插件A.class.php  // 主类文件
│   ├─ template/          // 插件模板
│   └─ ...
└─ 插件B/                // 其他插件目录

插件XML配置文件关键节点：

<?xml version="1.0" encoding="UTF-8"?>
<root><item id="basic"><item id="name"><![CDATA[插件名称]]></item><item id="version"><![CDATA[版本号]]></item><item id="description"><![CDATA[插件描述]]></item></item><item id="vars">...</item><item id="installfile"><![CDATA[install.php]]></item><item id="uninstallfile"><![CDATA[uninstall.php]]></item>
</root>