tests/phpunit/includes/cache/MessageCacheTest.php

   1 <?php
   2
   3 /**
   4  * @group Database
   5  * @group Cache
   6  * @covers MessageCache
   7  */
   8 class MessageCacheTest extends MediaWikiLangTestCase {
   9
  10         protected function setUp() {
  11                 parent::setUp();
  12                 $this->configureLanguages();
  13                 MessageCache::singleton()->enable();
  14         }
  15
  16         /**
  17          * Helper function -- setup site language for testing
  18          */
  19         protected function configureLanguages() {
  20                 // for the test, we need the content language to be anything but English,
  21                 // let's choose e.g. German (de)
  22                 $langCode = 'de';
  23                 $langObj = Language::factory( $langCode );
  24
  25                 $this->setMwGlobals( array(
  26                         'wgLanguageCode' => $langCode,
  27                         'wgLang' => $langObj,
  28                         'wgContLang' => $langObj,
  29                 ) );
  30         }
  31
  32         function addDBData() {
  33                 $this->configureLanguages();
  34
  35                 // Set up messages and fallbacks ab -> ru -> de
  36                 $this->makePage( 'FallbackLanguageTest-Full', 'ab' );
  37                 $this->makePage( 'FallbackLanguageTest-Full', 'ru' );
  38                 $this->makePage( 'FallbackLanguageTest-Full', 'de' );
  39
  40                 // Fallbacks where ab does not exist
  41                 $this->makePage( 'FallbackLanguageTest-Partial', 'ru' );
  42                 $this->makePage( 'FallbackLanguageTest-Partial', 'de' );
  43
  44                 // Fallback to the content language
  45                 $this->makePage( 'FallbackLanguageTest-ContLang', 'de' );
  46
  47                 // Add customizations for an existing message.
  48                 $this->makePage( 'sunday', 'ru' );
  49
  50                 // Full key tests -- always want russian
  51                 $this->makePage( 'MessageCacheTest-FullKeyTest', 'ab' );
  52                 $this->makePage( 'MessageCacheTest-FullKeyTest', 'ru' );
  53
  54                 // In content language -- get base if no derivative
  55                 $this->makePage( 'FallbackLanguageTest-NoDervContLang', 'de', 'de/none', false );
  56         }
  57
  58         /**
  59          * Helper function for addDBData -- adds a simple page to the database
  60          *
  61          * @param string $title Title of page to be created
  62          * @param string $lang  Language and content of the created page
  63          * @param string|null $content Content of the created page, or null for a generic string
  64          * @param bool $createSubPage Set to false if a root page should be created
  65          */
  66         protected function makePage( $title, $lang, $content = null, $createSubPage = true ) {
  67                 global $wgContLang;
  68
  69                 if ( $content === null ) {
  70                         $content = $lang;
  71                 }
  72                 if ( $lang !== $wgContLang->getCode() || $createSubPage ) {
  73                         $title = "$title/$lang";
  74                 }
  75
  76                 $title = Title::newFromText( $title, NS_MEDIAWIKI );
  77                 $wikiPage = new WikiPage( $title );
  78                 $contentHandler = ContentHandler::makeContent( $content, $title );
  79                 $wikiPage->doEditContent( $contentHandler, "$lang translation test case" );
  80         }
  81
  82         /**
  83          * Test message fallbacks, bug #1495
  84          *
  85          * @dataProvider provideMessagesForFallback
  86          */
  87         public function testMessageFallbacks( $message, $lang, $expectedContent ) {
  88                 $result = MessageCache::singleton()->get( $message, true, $lang );
  89                 $this->assertEquals( $expectedContent, $result, "Message fallback failed." );
  90         }
  91
  92         function provideMessagesForFallback() {
  93                 return array(
  94                         array( 'FallbackLanguageTest-Full', 'ab', 'ab' ),
  95                         array( 'FallbackLanguageTest-Partial', 'ab', 'ru' ),
  96                         array( 'FallbackLanguageTest-ContLang', 'ab', 'de' ),
  97                         array( 'FallbackLanguageTest-None', 'ab', false ),
  98
  99                         // Existing message with customizations on the fallbacks
 100                         array( 'sunday', 'ab', 'амҽыш' ),
 101
 102                         // bug 46579
 103                         array( 'FallbackLanguageTest-NoDervContLang', 'de', 'de/none' ),
 104                         // UI language different from content language should only use de/none as last option
 105                         array( 'FallbackLanguageTest-NoDervContLang', 'fit', 'de/none' ),
 106                 );
 107         }
 108
 109         /**
 110          * There's a fallback case where the message key is given as fully qualified -- this
 111          * should ignore the passed $lang and use the language from the key
 112          *
 113          * @dataProvider provideMessagesForFullKeys
 114          */
 115         public function testFullKeyBehaviour( $message, $lang, $expectedContent ) {
 116                 $result = MessageCache::singleton()->get( $message, true, $lang, true );
 117                 $this->assertEquals( $expectedContent, $result, "Full key message fallback failed." );
 118         }
 119
 120         function provideMessagesForFullKeys() {
 121                 return array(
 122                         array( 'MessageCacheTest-FullKeyTest/ru', 'ru', 'ru' ),
 123                         array( 'MessageCacheTest-FullKeyTest/ru', 'ab', 'ru' ),
 124                         array( 'MessageCacheTest-FullKeyTest/ru/foo', 'ru', false ),
 125                 );
 126         }
 127
 128 }