MediaWiki扩展中获取页面编辑前后内容的教程

public static function onMultiContentSave(
    RenderedRevision $renderedRevision,
    UserIdentity $user,
    CommentStoreComment $summary,
    $flags,
    Status $hookStatus
)

use MediaWiki\Revision\RenderedRevision;
use MediaWiki\Revision\RevisionRecord;
use Wikimedia\Content\SlotRecord;

class MyExtensionHooks {
    public static function onMultiContentSave(
        RenderedRevision $renderedRevision,
        UserIdentity $user,
        CommentStoreComment $summary,
        $flags,
        Status $hookStatus
    ) {
        // 获取当前修订版本对象
        $revision = $renderedRevision->getRevision();

        // 获取页面的 LinkTarget 对象（包含页面标题信息，非直接字符串）
        $title = $revision->getPageAsLinkTarget();

        // 获取编辑后的新内容
        // SlotRecord::MAIN 表示主内容槽
        // RevisionRecord::RAW 表示获取原始维基文本内容
        $new_content_object = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
        $new_content_text = $new_content_object ? $new_content_object->getNativeData() : '';

        // $new_content_text 现在包含了编辑后的页面内容

        return true;
    }
}

use MediaWiki\Revision\RenderedRevision;
use MediaWiki\WikiPage\Revision\RevisionStore; // 确保引入正确的 RevisionStore
use MediaWiki\Revision\RevisionRecord;
use Wikimedia\Content\SlotRecord;
use MediaWiki\Content\ContentHandler; // 用于将Content对象转换为文本

class MyExtensionHooks {
    public static function onMultiContentSave(
        RenderedRevision $renderedRevision,
        UserIdentity $user,
        CommentStoreComment $summary,
        $flags,
        Status $hookStatus
    ) {
        $revision = $renderedRevision->getRevision();
        $title = $revision->getPageAsLinkTarget(); // 获取页面的 LinkTarget 对象

        // 获取编辑后的新内容
        $new_content_object = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
        $new_content_text = $new_content_object ? $new_content_object->getNativeData() : '';

        // --- 获取编辑前的旧内容 ---

        $old_content_text = ''; // 初始化旧内容为空字符串

        // 1. 获取父版本ID
        $parent_id = $revision->getParentId();

        // 2. 检查是否存在父版本（即不是首次创建）
        if ($parent_id !== 0 && $parent_id !== null) {
            // 3. 通过父版本ID加载前一个修订版本
            // RevisionStore 是一个服务，通常通过 MediaWiki\MediaWikiServices::getInstance()->getRevisionStore() 获取
            // 但在钩子环境中，可以直接访问静态方法 RevisionStore::getRevisionById()
            $previous_revision = RevisionStore::getRevisionById($parent_id);

            // 4. 检查是否成功加载到前一个修订版本
            if ($previous_revision) {
                // 5. 从前一个修订版本中提取内容
                // Revision::RAW 获取原始内容
                $old_content_object = $previous_revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);

                // 6. 将内容对象转换为文本
                // ContentHandler::getContentText() 是一个通用的转换方法
                $old_content_text = $old_content_object ? ContentHandler::getContentText($old_content_object) : '';
            }
        }

        // $old_content_text 现在包含了编辑前的页面内容

        // ... 在这里可以对 $new_content_text 和 $old_content_text 进行比较或处理

        return true;
    }
}

<?php

// 导入必要的类
use MediaWiki\Hook\MultiContentSaveHook;
use MediaWiki\Revision\RenderedRevision;
use MediaWiki\User\UserIdentity;
use CommentStoreComment;
use Status;
use MediaWiki\WikiPage\Revision\RevisionStore;
use MediaWiki\Revision\RevisionRecord;
use Wikimedia\Content\SlotRecord;
use MediaWiki\Content\ContentHandler;

/**
 * 示例 MediaWiki 扩展钩子类
 */
class ContentComparisonExtensionHooks implements MultiContentSaveHook {

    /**
     * 在内容保存后触发，用于比较编辑前后内容。
     *
     * @param RenderedRevision $renderedRevision 当前保存的修订版本信息
     * @param UserIdentity $user 执行保存操作的用户
     * @param CommentStoreComment $summary 编辑摘要
     * @param int $flags 保存标志
     * @param Status $hookStatus 钩子状态对象
     * @return bool
     */
    public function onMultiContentSave(
        RenderedRevision $renderedRevision,
        UserIdentity $user,
        CommentStoreComment $summary,
        $flags,
        Status $hookStatus
    ): bool {
        // 获取当前修订版本对象
        $currentRevision = $renderedRevision->getRevision();
        $pageTitle = $currentRevision->getPageAsLinkTarget()->getText(); // 获取页面标题字符串

        // --- 获取编辑后的新内容 ---
        $newContentObject = $currentRevision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
        $newContentText = $newContentObject ? ContentHandler::getContentText($newContentObject) : '';

        // --- 获取编辑前的旧内容 ---
        $oldContentText = ''; // 默认旧内容为空

        $parentId = $currentRevision->getParentId();

        // 检查是否存在父版本 (即不是首次创建页面)
        if ($parentId !== 0 && $parentId !== null) {
            // 通过父版本ID加载前一个修订版本
            $previousRevision = RevisionStore::getRevisionById($parentId);

            if ($previousRevision) {
                // 从前一个修订版本中提取内容
                $oldContentObject = $previousRevision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
                $oldContentText = $oldContentObject ? ContentHandler::getContentText($oldContentObject) : '';
            } else {
                // 无法加载到前一个修订版本 (可能ID无效或已删除)
                wfDebugLog('ContentComparisonExtension', "Warning: Could not load previous revision with ID $parentId for page $pageTitle.");
            }
        } else {
            // 这是页面的首次创建，没有旧内容
            wfDebugLog('ContentComparisonExtension', "Page '$pageTitle' was created. No old content to compare.");
        }

        // --- 进行内容比较或进一步处理 ---
        if ($oldContentText !== $newContentText) {
            // 内容发生了变化
            wfDebugLog('ContentComparisonExtension', "Page '$pageTitle' content changed.");
            // 可以在此处执行差异分析、记录日志、发送通知等操作
            // 例如：
            // $diff = new \MediaWiki\Diff\TextDiffer();
            // $changes = $diff->getDiff($oldContentText, $newContentText);
            // ...
        } else {
            // 内容没有变化 (可能只是保存了空编辑或元数据编辑)
            wfDebugLog('ContentComparisonExtension', "Page '$pageTitle' content unchanged.");
        }

        return true; // 总是返回 true，除非你想阻止保存操作
    }
}

{
    "name": "ContentComparisonExtension",
    "version": "1.0.0",
    "AutoloadClasses": {
        "ContentComparisonExtensionHooks": "ContentComparisonExtensionHooks.php"
    },
    "Hooks": {
        "MultiContentSave": [
            "ContentComparisonExtensionHooks::onMultiContentSave"
        ]
    },
    "manifest_version": 2
}