RevisionTest.php

Go to the documentation of this file.

<?php
 
class RevisionTest extends MediaWikiTestCase {
    protected function setUp() {
        global $wgContLang;
 
        parent::setUp();
 
        $this->setMwGlobals( [
            'wgContLang' => Language::factory( 'en' ),
            'wgLanguageCode' => 'en',
            'wgLegacyEncoding' => false,
            'wgCompressRevisions' => false,
 
            'wgContentHandlerTextFallback' => 'ignore',
        ] );
 
        $this->mergeMwGlobalArrayValue(
            'wgExtraNamespaces',
            [
                12312 => 'Dummy',
                12313 => 'Dummy_talk',
            ]
        );
 
        $this->mergeMwGlobalArrayValue(
            'wgNamespaceContentModels',
            [
                12312 => 'testing',
            ]
        );
 
        $this->mergeMwGlobalArrayValue(
            'wgContentHandlers',
            [
                'testing' => 'DummyContentHandlerForTesting',
                'RevisionTestModifyableContent' => 'RevisionTestModifyableContentHandler',
            ]
        );
 
        MWNamespace::getCanonicalNamespaces( true ); # reset namespace cache
        $wgContLang->resetNamespaces(); # reset namespace cache
    }
 
    function tearDown() {
        global $wgContLang;
 
        MWNamespace::getCanonicalNamespaces( true ); # reset namespace cache
        $wgContLang->resetNamespaces(); # reset namespace cache
 
        parent::tearDown();
    }
 
    public function testGetRevisionText() {
        $row = new stdClass;
        $row->old_flags = '';
        $row->old_text = 'This is a bunch of revision text.';
        $this->assertEquals(
            'This is a bunch of revision text.',
            Revision::getRevisionText( $row ) );
    }
 
    public function testGetRevisionTextGzip() {
        $this->checkPHPExtension( 'zlib' );
 
        $row = new stdClass;
        $row->old_flags = 'gzip';
        $row->old_text = gzdeflate( 'This is a bunch of revision text.' );
        $this->assertEquals(
            'This is a bunch of revision text.',
            Revision::getRevisionText( $row ) );
    }
 
    public function testGetRevisionTextUtf8Native() {
        $row = new stdClass;
        $row->old_flags = 'utf-8';
        $row->old_text = "Wiki est l'\xc3\xa9cole superieur !";
        $GLOBALS['wgLegacyEncoding'] = 'iso-8859-1';
        $this->assertEquals(
            "Wiki est l'\xc3\xa9cole superieur !",
            Revision::getRevisionText( $row ) );
    }
 
    public function testGetRevisionTextUtf8Legacy() {
        $row = new stdClass;
        $row->old_flags = '';
        $row->old_text = "Wiki est l'\xe9cole superieur !";
        $GLOBALS['wgLegacyEncoding'] = 'iso-8859-1';
        $this->assertEquals(
            "Wiki est l'\xc3\xa9cole superieur !",
            Revision::getRevisionText( $row ) );
    }
 
    public function testGetRevisionTextUtf8NativeGzip() {
        $this->checkPHPExtension( 'zlib' );
 
        $row = new stdClass;
        $row->old_flags = 'gzip,utf-8';
        $row->old_text = gzdeflate( "Wiki est l'\xc3\xa9cole superieur !" );
        $GLOBALS['wgLegacyEncoding'] = 'iso-8859-1';
        $this->assertEquals(
            "Wiki est l'\xc3\xa9cole superieur !",
            Revision::getRevisionText( $row ) );
    }
 
    public function testGetRevisionTextUtf8LegacyGzip() {
        $this->checkPHPExtension( 'zlib' );
 
        $row = new stdClass;
        $row->old_flags = 'gzip';
        $row->old_text = gzdeflate( "Wiki est l'\xe9cole superieur !" );
        $GLOBALS['wgLegacyEncoding'] = 'iso-8859-1';
        $this->assertEquals(
            "Wiki est l'\xc3\xa9cole superieur !",
            Revision::getRevisionText( $row ) );
    }
 
    public function testCompressRevisionTextUtf8() {
        $row = new stdClass;
        $row->old_text = "Wiki est l'\xc3\xa9cole superieur !";
        $row->old_flags = Revision::compressRevisionText( $row->old_text );
        $this->assertTrue( false !== strpos( $row->old_flags, 'utf-8' ),
            "Flags should contain 'utf-8'" );
        $this->assertFalse( false !== strpos( $row->old_flags, 'gzip' ),
            "Flags should not contain 'gzip'" );
        $this->assertEquals( "Wiki est l'\xc3\xa9cole superieur !",
            $row->old_text, "Direct check" );
        $this->assertEquals( "Wiki est l'\xc3\xa9cole superieur !",
            Revision::getRevisionText( $row ), "getRevisionText" );
    }
 
    public function testCompressRevisionTextUtf8Gzip() {
        $this->checkPHPExtension( 'zlib' );
        $this->setMwGlobals( 'wgCompressRevisions', true );
 
        $row = new stdClass;
        $row->old_text = "Wiki est l'\xc3\xa9cole superieur !";
        $row->old_flags = Revision::compressRevisionText( $row->old_text );
        $this->assertTrue( false !== strpos( $row->old_flags, 'utf-8' ),
            "Flags should contain 'utf-8'" );
        $this->assertTrue( false !== strpos( $row->old_flags, 'gzip' ),
            "Flags should contain 'gzip'" );
        $this->assertEquals( "Wiki est l'\xc3\xa9cole superieur !",
            gzinflate( $row->old_text ), "Direct check" );
        $this->assertEquals( "Wiki est l'\xc3\xa9cole superieur !",
            Revision::getRevisionText( $row ), "getRevisionText" );
    }
 
    # =========================================================================
 
    function newTestRevision( $text, $title = "Test",
        $model = CONTENT_MODEL_WIKITEXT, $format = null
    ) {
        if ( is_string( $title ) ) {
            $title = Title::newFromText( $title );
        }
 
        $content = ContentHandler::makeContent( $text, $title, $model, $format );
 
        $rev = new Revision(
            [
                'id' => 42,
                'page' => 23,
                'title' => $title,
 
                'content' => $content,
                'length' => $content->getSize(),
                'comment' => "testing",
                'minor_edit' => false,
 
                'content_format' => $format,
            ]
        );
 
        return $rev;
    }
 
    function dataGetContentModel() {
        // NOTE: we expect the help namespace to always contain wikitext
        return [
            [ 'hello world', 'Help:Hello', null, null, CONTENT_MODEL_WIKITEXT ],
            [ 'hello world', 'User:hello/there.css', null, null, CONTENT_MODEL_CSS ],
            [ serialize( 'hello world' ), 'Dummy:Hello', null, null, "testing" ],
        ];
    }
 
    public function testGetContentModel( $text, $title, $model, $format, $expectedModel ) {
        $rev = $this->newTestRevision( $text, $title, $model, $format );
 
        $this->assertEquals( $expectedModel, $rev->getContentModel() );
    }
 
    function dataGetContentFormat() {
        // NOTE: we expect the help namespace to always contain wikitext
        return [
            [ 'hello world', 'Help:Hello', null, null, CONTENT_FORMAT_WIKITEXT ],
            [ 'hello world', 'Help:Hello', CONTENT_MODEL_CSS, null, CONTENT_FORMAT_CSS ],
            [ 'hello world', 'User:hello/there.css', null, null, CONTENT_FORMAT_CSS ],
            [ serialize( 'hello world' ), 'Dummy:Hello', null, null, "testing" ],
        ];
    }
 
    public function testGetContentFormat( $text, $title, $model, $format, $expectedFormat ) {
        $rev = $this->newTestRevision( $text, $title, $model, $format );
 
        $this->assertEquals( $expectedFormat, $rev->getContentFormat() );
    }
 
    function dataGetContentHandler() {
        // NOTE: we expect the help namespace to always contain wikitext
        return [
            [ 'hello world', 'Help:Hello', null, null, 'WikitextContentHandler' ],
            [ 'hello world', 'User:hello/there.css', null, null, 'CssContentHandler' ],
            [ serialize( 'hello world' ), 'Dummy:Hello', null, null, 'DummyContentHandlerForTesting' ],
        ];
    }
 
    public function testGetContentHandler( $text, $title, $model, $format, $expectedClass ) {
        $rev = $this->newTestRevision( $text, $title, $model, $format );
 
        $this->assertEquals( $expectedClass, get_class( $rev->getContentHandler() ) );
    }
 
    function dataGetContent() {
        // NOTE: we expect the help namespace to always contain wikitext
        return [
            [ 'hello world', 'Help:Hello', null, null, Revision::FOR_PUBLIC, 'hello world' ],
            [
                serialize( 'hello world' ),
                'Hello',
                "testing",
                null,
                Revision::FOR_PUBLIC,
                serialize( 'hello world' )
            ],
            [
                serialize( 'hello world' ),
                'Dummy:Hello',
                null,
                null,
                Revision::FOR_PUBLIC,
                serialize( 'hello world' )
            ],
        ];
    }
 
    public function testGetContent( $text, $title, $model, $format,
        $audience, $expectedSerialization
    ) {
        $rev = $this->newTestRevision( $text, $title, $model, $format );
        $content = $rev->getContent( $audience );
 
        $this->assertEquals(
            $expectedSerialization,
            is_null( $content ) ? null : $content->serialize( $format )
        );
    }
 
    public function dataGetSize() {
        return [
            [ "hello world.", CONTENT_MODEL_WIKITEXT, 12 ],
            [ serialize( "hello world." ), "testing", 12 ],
        ];
    }
 
    public function testGetSize( $text, $model, $expected_size ) {
        $rev = $this->newTestRevision( $text, 'RevisionTest_testGetSize', $model );
        $this->assertEquals( $expected_size, $rev->getSize() );
    }
 
    public function dataGetSha1() {
        return [
            [ "hello world.", CONTENT_MODEL_WIKITEXT, Revision::base36Sha1( "hello world." ) ],
            [
                serialize( "hello world." ),
                "testing",
                Revision::base36Sha1( serialize( "hello world." ) )
            ],
        ];
    }
 
    public function testGetSha1( $text, $model, $expected_hash ) {
        $rev = $this->newTestRevision( $text, 'RevisionTest_testGetSha1', $model );
        $this->assertEquals( $expected_hash, $rev->getSha1() );
    }
 
    public function testConstructWithText() {
        $rev = new Revision( [
            'text' => 'hello world.',
            'content_model' => CONTENT_MODEL_JAVASCRIPT
        ] );
 
        $this->assertNotNull( $rev->getContent(), 'no content object available' );
        $this->assertEquals( CONTENT_MODEL_JAVASCRIPT, $rev->getContent()->getModel() );
        $this->assertEquals( CONTENT_MODEL_JAVASCRIPT, $rev->getContentModel() );
    }
 
    public function testConstructWithContent() {
        $title = Title::newFromText( 'RevisionTest_testConstructWithContent' );
 
        $rev = new Revision( [
            'content' => ContentHandler::makeContent( 'hello world.', $title, CONTENT_MODEL_JAVASCRIPT ),
        ] );
 
        $this->assertNotNull( $rev->getContent(), 'no content object available' );
        $this->assertEquals( CONTENT_MODEL_JAVASCRIPT, $rev->getContent()->getModel() );
        $this->assertEquals( CONTENT_MODEL_JAVASCRIPT, $rev->getContentModel() );
    }
 
    public function testGetContentClone() {
        $content = new RevisionTestModifyableContent( "foo" );
 
        $rev = new Revision(
            [
                'id' => 42,
                'page' => 23,
                'title' => Title::newFromText( "testGetContentClone_dummy" ),
 
                'content' => $content,
                'length' => $content->getSize(),
                'comment' => "testing",
                'minor_edit' => false,
            ]
        );
 
        $content = $rev->getContent( Revision::RAW );
        $content->setText( "bar" );
 
        $content2 = $rev->getContent( Revision::RAW );
        // content is mutable, expect clone
        $this->assertNotSame( $content, $content2, "expected a clone" );
        // clone should contain the original text
        $this->assertEquals( "foo", $content2->getText() );
 
        $content2->setText( "bla bla" );
        $this->assertEquals( "bar", $content->getText() ); // clones should be independent
    }
 
    public function testGetContentUncloned() {
        $rev = $this->newTestRevision( "hello", "testGetContentUncloned_dummy", CONTENT_MODEL_WIKITEXT );
        $content = $rev->getContent( Revision::RAW );
        $content2 = $rev->getContent( Revision::RAW );
 
        // for immutable content like wikitext, this should be the same object
        $this->assertSame( $content, $content2 );
    }
}
 
class RevisionTestModifyableContent extends TextContent {
    public function __construct( $text ) {
        parent::__construct( $text, "RevisionTestModifyableContent" );
    }
 
    public function copy() {
        return new RevisionTestModifyableContent( $this->mText );
    }
 
    public function getText() {
        return $this->mText;
    }
 
    public function setText( $text ) {
        $this->mText = $text;
    }
}
 
class RevisionTestModifyableContentHandler extends TextContentHandler {
 
    public function __construct() {
        parent::__construct( "RevisionTestModifyableContent", [ CONTENT_FORMAT_TEXT ] );
    }
 
    public function unserializeContent( $text, $format = null ) {
        $this->checkFormat( $format );
 
        return new RevisionTestModifyableContent( $text );
    }
 
    public function makeEmptyContent() {
        return new RevisionTestModifyableContent( '' );
    }
}