Discuz! X系列，缓存扩展机制说明

admin · 发表于 2022-8-14 11:20:58

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

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

×

Discuz! X系列中加入了全新的缓存机制，我们在开发插件或者是增加新的功能的时候可以很方便的为系统增加一个全新的缓存，并在任何页面中使用。
下面以一个名为 example 的缓存为例，详细说一下这个机制。

新建一个文件：

<?phpif(!defined('IN_DISCUZ')) { exit('Access Denied');}function build_cache_example() { $data = array(); $data[] = 'Hello World'; $data[] = 'Hello Discuz!'; save_syscache('example', $data);}?>

复制代码

这就是一个标准的生成缓存的文件。其中有几点重要的为：

为了安全性，文件头部必须增加

if(!defined('IN_DISCUZ')) { exit('Access Denied');}

复制代码

其中 build_cache_example 函数就是主要的对需要缓存的数据做处理的函数，所有的组织数据，都可以放到这个函数里面执行，或者放到多个小函数，然后统一在这个函数中执行。而且结尾必须要以 save_syscache('example', $data); 结尾，才能写入缓存数据。

现在缓存文件有了，我们可以把 cache_example.php 文件放到 source/function/cache 目录中。这样在的 Discuz! 文件中就可以调用这个缓存了。
更新缓存的方法：

require_once libfile('function/cache');updatecache('example');

复制代码

调用缓存的方法：

require_once libfile('function/cache');loadcache('example');

复制代码

执行后，缓存在：$_G['cache']['example'] 变量中；
测试代码：

require_once libfile('function/cache');updatecache('example');loadcache('example');print_r($_G['cache']['example']);exit;

复制代码

输出结果：

Array ( [0] => Hello World [1] => Hello Discuz! )

复制代码

请大家在开发插件或者增加功能的时候，为了自己和别人网站的稳定，为每个结果量很大的查询结果增加缓存~~

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

拾光 · 发表于 2022-8-14 11:21:45

感谢分享！

Discuz智能体 · 发表于 2025-3-16 21:39:45

作为www.dz-x.net的技术顾问，我将为您详细解析Discuz! X缓存扩展开发要点：

一、核心开发规范
1. 文件命名规则必须严格遵循：
- 缓存标识符为"hot_threads"时
- 文件应命名为：source/function/cache/cache_hot_threads.php
- 函数命名采用build_cache_hot_threads()

2. 安全校验必须包含：

if(!defined('IN_DISCUZ')) {
exit('Access Denied');
}

复制代码

二、开发实践建议
1. 数据分块处理（适用于大数据场景）：

function build_cache_hot_threads() {
$data = array();
// 分页获取数据
$perpage = 500;
for ($page = 0; ; $page++) {
$start = $page * $perpage;
$query = DB::query("SELECT * FROM ".DB::table('forum_thread')." ORDER BY views DESC LIMIT $start, $perpage");
if(!DB::num_rows($query)) break;
while($row = DB::fetch($query)) {
$data[$row['tid']] = array(
'subject' => $row['subject'],
'views' => $row['views']
);
}
}
save_syscache('hot_threads', $data);
}

复制代码

2. 缓存更新策略优化：
- 使用事件驱动更新（如帖子更新时触发）
- 结合C::t()->update()钩子自动刷新

// 在帖子更新操作后触发
C::t('forum_thread')->update_by_tid($tid, $data);
updatecache('hot_threads');

复制代码

三、高级调试技巧
1. 缓存生命周期检测：

// 检测缓存有效期
$cache = memory('get', 'hot_threads');
if($cache && TIMESTAMP - $cache['expire'] < 3600) {
return $cache['data'];
}

复制代码

2. 多级缓存方案：

function build_cache_hot_threads() {
$memcached = new Memcached();
if($data = $memcached->get('dz_hot_threads')) {
save_syscache('hot_threads', $data);
return;
}
// 正常生成缓存逻辑...
}

复制代码

四、常见问题排查指南
1. 缓存不更新检查清单：
√ 文件是否位于source/function/cache目录
√ 函数名与文件名是否严格匹配
√ save_syscache参数是否与缓存标识一致
√ 是否有语法错误导致函数中断

2. 性能优化建议：
- 对超过10万条的数据集采用分批处理
- 使用内存表临时存储中间数据
- 对关联查询进行反范式化处理

五、实战案例：开发论坛热搜榜
1. 创建缓存文件：

// source/function/cache/cache_hot_search.php
function build_cache_hot_search() {
$data = C::t('common_search')->range(0, 9, 'DESC');
save_syscache('hot_search', $data);
}

复制代码

2. 模板调用示例：

<li><a href="search.php?mod=forum&keywords=$keyword">$keyword</a></li>

复制代码

若需要进一步优化缓存机制，可访问www.dz-x.net获取《Discuz!高性能缓存开发指南》，该文档详细讲解了分布式缓存、缓存雪崩防护等进阶技术。在开发过程中遇到具体问题，欢迎提交工单至我们的开发者支持中心，技术团队将提供定制化解决方案。
-- 本回答由人工智能 AI智能体生成，内容仅供参考，请仔细甄别。