在MediaWiki扩展中比较页面编辑前后内容变更

<?php

use MediaWiki\Revision\RenderedRevision;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\User\UserIdentity;
use MediaWiki\Status\Status;
use CommentStoreComment;
use RevisionStore;
use ContentHandler;

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

        // 获取页面标题对象，这是一个LinkTarget对象，而非字符串
        $title = $revision->getPageAsLinkTarget(); 

        // 获取新编辑后的主内容槽（SlotRecord::MAIN）的原始数据
        // getNativeData() 返回内容对象的原生数据，通常是字符串形式的页面内容
        $new_content = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW)->getNativeData();

        // ... 后续处理 ...

        return true;
    } 
}

<?php

// ... (use 语句与 MyExtensionHooks 类定义同上) ...

class MyExtensionHooks {
    public static function onMultiContentSave(
        RenderedRevision $renderedRevision,
        UserIdentity $user,
        CommentStoreComment $summary,
        $flags,
        Status $hookStatus
    ) {
        $revision = $renderedRevision->getRevision();
        $title = $revision->getPageAsLinkTarget(); 
        $new_content = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW)->getNativeData();

        // 获取当前修订版本的父版本ID
        // 如果没有父版本（例如，页面是新建的），getParentId() 将返回 0
        // 如果父版本未定义或未知，可能返回 null
        $parent_id = $revision->getParentId();

        $old_content_text = null; // 初始化旧内容为 null

        // 只有当存在有效的父版本ID时，才尝试获取旧内容
        if ( $parent_id > 0 ) {
            // 通过父版本ID从RevisionStore加载旧的修订版本记录
            // 如果找不到对应的修订版本，getRevisionById() 将返回 null
            $previous_revision = RevisionStore::singleton()->getRevisionById( $parent_id );

            if ( $previous_revision ) {
                // 获取旧修订版本的主内容槽的原始内容对象
                $old_content = $previous_revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);

                // 将内容对象转换为文本字符串
                // ContentHandler::getContentText() 是一个安全且推荐的方法
                $old_content_text = ContentHandler::getContentText( $old_content );
            }
        }

        // 此时，$new_content 包含新编辑后的内容
        // $old_content_text 包含编辑前的旧内容（如果存在）

        // 可以在这里进行内容比较或其他逻辑
        // 例如：
        if ( $old_content_text !== null ) {
            // 进行差异比较或分析
            // error_log("页面 '{$title->getText()}' 内容变更：");
            // error_log("旧内容长度: " . strlen($old_content_text));
            // error_log("新内容长度: " . strlen($new_content));
        } else {
            // error_log("页面 '{$title->getText()}' 是新建的，没有旧内容。");
        }

        return true;
    } 
}

<?php

// 引入必要的类
use MediaWiki\Revision\RenderedRevision;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\User\UserIdentity;
use MediaWiki\Status\Status;
use CommentStoreComment;
use RevisionStore; // 用于获取历史版本
use ContentHandler; // 用于将Content对象转换为文本

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

        // 获取新编辑后的页面内容
        $new_content = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW)->getNativeData();

        $old_content_text = null; // 初始化旧内容变量

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

        // 检查是否存在父版本（即页面是否不是新建的）
        if ( $parent_id > 0 ) {
            // 尝试加载父修订版本
            $previous_revision = RevisionStore::singleton()->getRevisionById( $parent_id );

            if ( $previous_revision ) {
                // 成功获取到父修订版本，提取其主内容槽的文本
                $old_content = $previous_revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
                $old_content_text = ContentHandler::getContentText( $old_content );
            } else {
                // 理论上不应该发生，除非数据库异常或父ID无效
                // error_log("警告: 无法找到ID为 {$parent_id} 的父修订版本。");
            }
        }

        // 至此，您已拥有：
        // $title: 页面标题对象
        // $new_content: 新编辑后的页面内容字符串
        // $old_content_text: 编辑前的页面内容字符串 (如果页面不是新建的且成功获取到)

        // 您可以在这里实现您的核心逻辑，例如：
        if ( $old_content_text !== null ) {
            // 比较 $new_content 和 $old_content_text 的差异
            // 例如，计算差异、记录变更日志、触发特定工作流等
            // error_log("页面 '{$title->getText()}' 内容已从 '{$old_content_text}' 变为 '{$new_content}'");
        } else {
            // 页面是新建的，只有新内容
            // error_log("页面 '{$title->getText()}' 已创建，内容为 '{$new_content}'");
        }

        // 钩子函数必须返回 true 以继续MediaWiki的正常保存流程
        return true;
    } 
}