Discuz! X5.0 开发技术文档结构概述

惧愁人 · 发表于 2024-11-12 21:20:18

马上注册，免费下载更多dz插件网资源。

您需要登录才可以下载或查看，没有账号？立即注册

×

Discuz! X5.0 开发技术文档结构概述函数,source,app,module,插件

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 中。

如果您要进行 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”

©DZ插件网所发布的一切资源仅限用于学习和研究目的；不得将上述内容用于商业或者非法用途，否则，一切后果请用户自负。
网站部分内容来源于网络，版权争议与本站无关。您必须在下载后的24个小时之内，从您的电脑中彻底删除上述内容。如果您喜欢该程序，请支持正版软件，得到更好的正版服务。
您在本站任何的赞助购买、下载、查阅、回复等行为等均表示接受并同意签订《DZ插件网免责声明协议》。
如有侵权请邮件与我们联系处理: discuzaddons@vip.qq.com 并出示相关证明以便删除。敬请谅解！