Discuz! X5.0 开发技术文档 结构概述
2024/11/12 21:20:18
X5，我们将开放进行到底，让它成为一个平台
Discuz! X5.0 将目录结构进行优化和改造，对文件的作用进行重新归类的同时，也彻底加强了开放性，我们把这个全新的架构命名为 MitFrame。重新整理后的目录结构见下表：
目录
含义
/首页目录
/apiAPI 接口目录
/archiverArchiver 版目录
/source/appAPP 目录
/source/child子文件目录
/source/class类文件目录
/source/data数据文件目录
/source/function函数文件目录
/source/index首页文件目录
/source/language语言包文件目录
/source/plugin插件目录
/vendor第三方库文件
/template模板目录
未做修改的目录本文将不做阐述
APP 目录Discuz! X5.0 将各个模块功能的包含类文件进行了合并，所有同模块的文件都在各自的目录下。
X3.5 版本的 /source/module 目录已经合并到各个 app 的子目录 /source/app/xxx/module 中。
X3.5 版本的 /source/module 目录已经合并到各个 app 的子目录 /source/app/xxx/module 中。
如果您要进行 app 的扩展，可直接在 /source/app 下创建目录，然后在此目录下创建同名文件，例如 /source/app/xxx/xxx.php
- <?php
- require './source/class/class_core.php';
- $discuz = C::app();
- $discuz->cachelist = [];
- $discuz->init();
- require_once appfile('yyy/zzz'); // 调用 /source/app/xxx/yyy/zzz.php 文件
/source/app/xxx 目录下可以直接创建模板文件，可用类似以下方式调用 source/app/xxx/template/tpl.php 模板文件。仅支持 php 格式是模板文件
- template('tpl', 0, 'source/app/xxx/template');
子文件目录将 X3.5 版本的 /source/include 目录的进行了优化改造，并按照各个模块以及其子模块进行逐层命名，全局子文件位于 /source/child 目录下，各个 app 的子文件位于 /source/app/xxx/child 目录下。Discuz! X5.0 系统程序的相应模块会自动引用 child 目录中相应模块的文件，但是如果插件注册了接管，可以完全代替原有系统的逻辑。
接管方法详见“新增插件接口”>“子文件”。
接管方法详见“新增插件接口”>“子文件”。
管理后台的 URL admin.php?action=app&operation=xxx:yyy 可以直接调用 /source/app/xxx/admin/yyy.php。
类文件目录类文件目录中的文件因 autoload 会自动调用，代码中只需要直接写类名即可调用到，例如下例中可直接调用到 /source/class/class_i18n.php 文件中的 class i18n{}
return i18n::cmd($cmd, $langkey, $path);
对于插件类、App类的调用可通过命名空间的方式，见下表：
调用代码
文件名
类代码
sample\lib_base::xxx()/source/plugin/sample/lib/lib_base.phpnamespace sample;
class lib_base {…}
sample\lib\sub_base::xxx()/source/plugin/sample/lib/sub/sub_base.phpnamespace sample\lib;
class sub_base {…}
sample\lib\sub\ssub_base::xxx()/source/plugin/sample/lib/sub/ssub/ssub_base.phpnamespace sample\lib\sub;
class ssub_base {…}数据文件目录
存放非 PHP 且无修改权限的数据文件，X3.5 中 data/ipdata、source/include/table 的内容迁移到了此目录下。
首页文件目录此目录为 X3.5 首页的文件。因此，理论上 Discuz! X5.0 中首页只有一个 index.php 文件，其他文件是为了兼容旧版本链接而设置的跳转文件，因此所有首页文件都可用 index.php?app=xxx 的新方式访问。同时，我们也优化了插件模块文件的访问路径，当 ./source/app 中指定 app 不存在的时候，plugin.php?id=xxx:yyy 的访问路径，可用 index.php?app=xxx&module=yyy 代替。
第三方库文件为了区分系统文件和第三方文件，我们推荐所有第三方、composer 库统一放在此目录下。
友情提示在 X5.0 里，插件和模板 XML 配置文件中 version 字段的值为 “X5.0”