本文档旨在指导开发者如何在MediaWiki扩展中，利用MultiContentSave钩子，获取页面编辑前后的内容。通过示例代码，详细讲解如何获取新旧版本的修订记录，并从中提取页面内容，为实现版本比较等功能提供技术支持。
在MediaWiki扩展开发中，经常需要获取页面编辑前后的内容，以便进行比较、审计或其他处理。MultiContentSave钩子提供了一个理想的切入点，可以在页面保存前后执行自定义逻辑。以下是如何利用该钩子获取页面编辑前后的内容的方法：
使用 MultiContentSave 钩子
首先，需要在扩展中注册 MultiContentSave 钩子。在扩展的主文件中（例如，MyExtension.php），添加以下代码：
然后在 extension.json 文件中，注册该钩子：
{ "name": "MyExtension", "author": "Your Name", "version": "1.0.0", "description": "A MediaWiki extension to compare page content before and after edit.", "Hooks": { "MultiContentSave": "MyExtensionHooks::onMultiContentSave" }, "manifest_version": 1 }获取编辑后的内容
在 onMultiContentSave 函数中，可以使用 $renderedRevision 对象来获取编辑后的内容。
$revision = $renderedRevision->getRevision(); $title = $revision->getPageAsLinkTarget(); $new_content = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW)->getNativeData();$new_content 变量现在包含了编辑后的页面内容。
获取编辑前的内容
逍遥内容管理系统(Carefree CMS)1.3.0下载系统简介逍遥内容管理系统（CarefreeCMS）是一款功能强大、易于使用的内容管理平台，采用前后端分离架构，支持静态页面生成，适用于个人博客、企业网站、新闻媒体等各类内容发布场景。核心特性1、模板套装系统 - 支持多套模板自由切换，快速定制网站风格2、静态页面生成 - 一键生成纯静态HTML页面，访问速度快，SEO友好3、文章管理 - 支持富文本编辑、草稿保存、文章属性标记、自动提取SEO4、全
要获取编辑前的页面内容，需要获取父修订版本（Parent Revision）。
$revision = $renderedRevision->getRevision(); $title = $revision->getPageAsLinkTarget(); // 获取父修订版本 ID $parent_id = $revision->getParentId(); // 检查父修订版本是否存在 if ($parent_id) { // 从修订版本 ID 加载修订版本 $previous_revision = RevisionStore::getRevisionById( $parent_id ); // 检查修订版本是否成功加载 if ($previous_revision) { // 从那里获取内容 $old_content = $previous_revision->getContent( SlotRecord::MAIN, RevisionRecord::RAW ); $old_content_text = $old_content->getNativeData(); // 提取内容 } else { // 处理无法找到旧版本的情况 error_log("无法找到修订版本 ID: " . $parent_id); } } else { // 处理没有父修订版本的情况（例如，页面是第一次创建） $old_content_text = ""; // 页面是新建的，没有旧内容 }现在，$old_content_text 变量包含了编辑前的页面内容。
完整示例
以下是一个完整的示例，展示了如何在 MultiContentSave 钩子中获取页面编辑前后的内容并进行比较：
getRevision(); $title = $revision->getPageAsLinkTarget(); // 获取编辑后的内容 $new_content = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW)->getNativeData(); // 获取编辑前的内容 $parent_id = $revision->getParentId(); if ($parent_id) { $previous_revision = RevisionStore::getRevisionById( $parent_id ); if ($previous_revision) { $old_content = $previous_revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW ); $old_content_text = $old_content->getNativeData(); } else { error_log("无法找到修订版本 ID: " . $parent_id); $old_content_text = ""; } } else { $old_content_text = ""; } // 在这里进行内容比较或其他处理 if ($old_content_text != $new_content) { // 内容已更改，执行相应操作 error_log("页面 " . $title->getText() . " 的内容已更改。"); } return true; } }注意事项
- 错误处理： 务必检查 $parent_id 和 $previous_revision 是否为空，以处理页面是第一次创建或旧版本无法找到的情况。
- 性能： 获取旧版本内容可能会影响性能，尤其是在大型wiki上。可以考虑使用缓存来提高性能。
- 权限： 确保扩展具有足够的权限来访问修订版本和内容。
总结
通过使用 MultiContentSave 钩子和 RevisionStore 类，可以方便地获取 MediaWiki 页面编辑前后的内容。这为实现各种扩展功能（如版本比较、内容审计等）提供了强大的基础。请务必注意错误处理和性能优化，以确保扩展的稳定性和效率。
