在MediaWiki扩展中比较页面编辑前后内容的实践指南

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

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

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

        // 获取新内容
        // SlotRecord::MAIN 表示主内容槽
        // RevisionRecord::RAW 表示获取原始内容对象
        $new_content_object = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
        // 将内容对象转换为文本
        $new_content_text = ContentHandler::getContentText($new_content_object);

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

        return true;
    }
}

use MediaWiki\Revision\RenderedRevision;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\Revision\SlotRecord;
use MediaWiki\Content\ContentHandler;
use MediaWiki\Storage\RevisionStore; // 引入RevisionStore
use MediaWiki\User\UserIdentity;
use CommentStoreComment;
use Status;

class MyExtensionHooks {
    public static function onMultiContentSave(
        RenderedRevision $renderedRevision,
        UserIdentity $user,
        CommentStoreComment $summary,
        $flags,
        Status $hookStatus
    ) {
        $revision = $renderedRevision->getRevision();
        $title = $revision->getPageAsLinkTarget();

        // 获取新内容
        $new_content_object = $revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
        $new_content_text = ContentHandler::getContentText($new_content_object);

        // 获取父修订ID
        $parent_id = $revision->getParentId();

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

        // 检查是否存在父修订（即不是页面首次创建）
        if ($parent_id !== null && $parent_id !== 0) {
            // 通过RevisionStore加载父修订版本
            // RevisionStore::singleton() 获取RevisionStore实例
            $previous_revision = RevisionStore::singleton()->getRevisionById($parent_id);

            // 检查是否成功加载到旧修订版本
            if ($previous_revision) {
                // 获取旧内容对象
                // 注意：旧版本的getContent方法可能需要Revision::RAW而不是RevisionRecord::RAW
                // 推荐使用SlotRecord::MAIN和RevisionRecord::RAW以保持一致性
                $old_content_object = $previous_revision->getContent(SlotRecord::MAIN, RevisionRecord::RAW);
                if ($old_content_object) {
                    $old_content_text = ContentHandler::getContentText($old_content_object);
                }
            }
        }

        // 至此，您已拥有 $new_content_text 和 $old_content_text (如果存在旧版本)
        // 可以在这里进行内容对比或其他业务逻辑
        // 例如：
        // if ($old_content_text !== null) {
        //     $diff = self::compareContent($old_content_text, $new_content_text);
        //     // 处理差异
        // }

        return true;
    }

    // 示例：一个简单的内容比较函数
    // private static function compareContent(string $old, string $new): array {
    //     // 这里可以集成MediaWiki的DiffEngine或其他第三方库进行内容差异比较
    //     // 简单示例：
    //     return [
    //         'old_length' => strlen($old),
    //         'new_length' => strlen($new),
    //         'is_changed' => ($old !== $new)
    //     ];
    // }
}