tests/phpunit/includes/TitleTest.php

   1 <?php
   2
   3 use MediaWiki\MediaWikiServices;
   4
   5 /**
   6  * @group Database
   7  * @group Title
   8  */
   9 class TitleTest extends MediaWikiTestCase {
  10         protected function setUp() {
  11                 parent::setUp();
  12
  13                 $this->setMwGlobals( [
  14                         'wgAllowUserJs' => false,
  15                         'wgDefaultLanguageVariant' => false,
  16                         'wgMetaNamespace' => 'Project',
  17                 ] );
  18                 $this->setUserLang( 'en' );
  19                 $this->setContentLang( 'en' );
  20         }
  21
  22         /**
  23          * @covers Title::legalChars
  24          */
  25         public function testLegalChars() {
  26                 $titlechars = Title::legalChars();
  27
  28                 foreach ( range( 1, 255 ) as $num ) {
  29                         $chr = chr( $num );
  30                         if ( strpos( "#[]{}<>|", $chr ) !== false || preg_match( "/[\\x00-\\x1f\\x7f]/", $chr ) ) {
  31                                 $this->assertFalse(
  32                                         (bool)preg_match( "/[$titlechars]/", $chr ),
  33                                         "chr($num) = $chr is not a valid titlechar"
  34                                 );
  35                         } else {
  36                                 $this->assertTrue(
  37                                         (bool)preg_match( "/[$titlechars]/", $chr ),
  38                                         "chr($num) = $chr is a valid titlechar"
  39                                 );
  40                         }
  41                 }
  42         }
  43
  44         public static function provideValidSecureAndSplit() {
  45                 return [
  46                         [ 'Sandbox' ],
  47                         [ 'A "B"' ],
  48                         [ 'A \'B\'' ],
  49                         [ '.com' ],
  50                         [ '~' ],
  51                         [ '#' ],
  52                         [ '"' ],
  53                         [ '\'' ],
  54                         [ 'Talk:Sandbox' ],
  55                         [ 'Talk:Foo:Sandbox' ],
  56                         [ 'File:Example.svg' ],
  57                         [ 'File_talk:Example.svg' ],
  58                         [ 'Foo/.../Sandbox' ],
  59                         [ 'Sandbox/...' ],
  60                         [ 'A~~' ],
  61                         [ ':A' ],
  62                         // Length is 256 total, but only title part matters
  63                         [ 'Category:' . str_repeat( 'x', 248 ) ],
  64                         [ str_repeat( 'x', 252 ) ],
  65                         // interwiki prefix
  66                         [ 'localtestiw: #anchor' ],
  67                         [ 'localtestiw:' ],
  68                         [ 'localtestiw:foo' ],
  69                         [ 'localtestiw: foo # anchor' ],
  70                         [ 'localtestiw: Talk: Sandbox # anchor' ],
  71                         [ 'remotetestiw:' ],
  72                         [ 'remotetestiw: Talk: # anchor' ],
  73                         [ 'remotetestiw: #bar' ],
  74                         [ 'remotetestiw: Talk:' ],
  75                         [ 'remotetestiw: Talk: Foo' ],
  76                         [ 'localtestiw:remotetestiw:' ],
  77                         [ 'localtestiw:remotetestiw:foo' ]
  78                 ];
  79         }
  80
  81         public static function provideInvalidSecureAndSplit() {
  82                 return [
  83                         [ '', 'title-invalid-empty' ],
  84                         [ ':', 'title-invalid-empty' ],
  85                         [ '__  __', 'title-invalid-empty' ],
  86                         [ '  __  ', 'title-invalid-empty' ],
  87                         // Bad characters forbidden regardless of wgLegalTitleChars
  88                         [ 'A [ B', 'title-invalid-characters' ],
  89                         [ 'A ] B', 'title-invalid-characters' ],
  90                         [ 'A { B', 'title-invalid-characters' ],
  91                         [ 'A } B', 'title-invalid-characters' ],
  92                         [ 'A < B', 'title-invalid-characters' ],
  93                         [ 'A > B', 'title-invalid-characters' ],
  94                         [ 'A | B', 'title-invalid-characters' ],
  95                         [ "A \t B", 'title-invalid-characters' ],
  96                         [ "A \n B", 'title-invalid-characters' ],
  97                         // URL encoding
  98                         [ 'A%20B', 'title-invalid-characters' ],
  99                         [ 'A%23B', 'title-invalid-characters' ],
 100                         [ 'A%2523B', 'title-invalid-characters' ],
 101                         // XML/HTML character entity references
 102                         // Note: Commented out because they are not marked invalid by the PHP test as
 103                         // Title::newFromText runs Sanitizer::decodeCharReferencesAndNormalize first.
 104                         // 'A &eacute; B',
 105                         // 'A &#233; B',
 106                         // 'A &#x00E9; B',
 107                         // Subject of NS_TALK does not roundtrip to NS_MAIN
 108                         [ 'Talk:File:Example.svg', 'title-invalid-talk-namespace' ],
 109                         // Directory navigation
 110                         [ '.', 'title-invalid-relative' ],
 111                         [ '..', 'title-invalid-relative' ],
 112                         [ './Sandbox', 'title-invalid-relative' ],
 113                         [ '../Sandbox', 'title-invalid-relative' ],
 114                         [ 'Foo/./Sandbox', 'title-invalid-relative' ],
 115                         [ 'Foo/../Sandbox', 'title-invalid-relative' ],
 116                         [ 'Sandbox/.', 'title-invalid-relative' ],
 117                         [ 'Sandbox/..', 'title-invalid-relative' ],
 118                         // Tilde
 119                         [ 'A ~~~ Name', 'title-invalid-magic-tilde' ],
 120                         [ 'A ~~~~ Signature', 'title-invalid-magic-tilde' ],
 121                         [ 'A ~~~~~ Timestamp', 'title-invalid-magic-tilde' ],
 122                         // Length
 123                         [ str_repeat( 'x', 256 ), 'title-invalid-too-long' ],
 124                         // Namespace prefix without actual title
 125                         [ 'Talk:', 'title-invalid-empty' ],
 126                         [ 'Talk:#', 'title-invalid-empty' ],
 127                         [ 'Category: ', 'title-invalid-empty' ],
 128                         [ 'Category: #bar', 'title-invalid-empty' ],
 129                         // interwiki prefix
 130                         [ 'localtestiw: Talk: # anchor', 'title-invalid-empty' ],
 131                         [ 'localtestiw: Talk:', 'title-invalid-empty' ]
 132                 ];
 133         }
 134
 135         private function secureAndSplitGlobals() {
 136                 $this->setMwGlobals( [
 137                         'wgLocalInterwikis' => [ 'localtestiw' ],
 138                         'wgHooks' => [
 139                                 'InterwikiLoadPrefix' => [
 140                                         function ( $prefix, &$data ) {
 141                                                 if ( $prefix === 'localtestiw' ) {
 142                                                         $data = [ 'iw_url' => 'localtestiw' ];
 143                                                 } elseif ( $prefix === 'remotetestiw' ) {
 144                                                         $data = [ 'iw_url' => 'remotetestiw' ];
 145                                                 }
 146                                                 return false;
 147                                         }
 148                                 ]
 149                         ]
 150                 ] );
 151
 152                 // Reset TitleParser since we modified $wgLocalInterwikis
 153                 $this->setService( 'TitleParser', new MediaWikiTitleCodec(
 154                                 Language::factory( 'en' ),
 155                                 new GenderCache(),
 156                                 [ 'localtestiw' ]
 157                 ) );
 158         }
 159
 160         /**
 161          * See also mediawiki.Title.test.js
 162          * @covers Title::secureAndSplit
 163          * @dataProvider provideValidSecureAndSplit
 164          * @note This mainly tests MediaWikiTitleCodec::parseTitle().
 165          */
 166         public function testSecureAndSplitValid( $text ) {
 167                 $this->secureAndSplitGlobals();
 168                 $this->assertInstanceOf( Title::class, Title::newFromText( $text ), "Valid: $text" );
 169         }
 170
 171         /**
 172          * See also mediawiki.Title.test.js
 173          * @covers Title::secureAndSplit
 174          * @dataProvider provideInvalidSecureAndSplit
 175          * @note This mainly tests MediaWikiTitleCodec::parseTitle().
 176          */
 177         public function testSecureAndSplitInvalid( $text, $expectedErrorMessage ) {
 178                 $this->secureAndSplitGlobals();
 179                 try {
 180                         Title::newFromTextThrow( $text ); // should throw
 181                         $this->assertTrue( false, "Invalid: $text" );
 182                 } catch ( MalformedTitleException $ex ) {
 183                         $this->assertEquals( $expectedErrorMessage, $ex->getErrorMessage(), "Invalid: $text" );
 184                 }
 185         }
 186
 187         public static function provideConvertByteClassToUnicodeClass() {
 188                 return [
 189                         [
 190                                 ' %!"$&\'()*,\\-.\\/0-9:;=?@A-Z\\\\^_`a-z~\\x80-\\xFF+',
 191                                 ' %!"$&\'()*,\\-./0-9:;=?@A-Z\\\\\\^_`a-z~+\\u0080-\\uFFFF',
 192                         ],
 193                         [
 194                                 'QWERTYf-\\xFF+',
 195                                 'QWERTYf-\\x7F+\\u0080-\\uFFFF',
 196                         ],
 197                         [
 198                                 'QWERTY\\x66-\\xFD+',
 199                                 'QWERTYf-\\x7F+\\u0080-\\uFFFF',
 200                         ],
 201                         [
 202                                 'QWERTYf-y+',
 203                                 'QWERTYf-y+',
 204                         ],
 205                         [
 206                                 'QWERTYf-\\x80+',
 207                                 'QWERTYf-\\x7F+\\u0080-\\uFFFF',
 208                         ],
 209                         [
 210                                 'QWERTY\\x66-\\x80+\\x23',
 211                                 'QWERTYf-\\x7F+#\\u0080-\\uFFFF',
 212                         ],
 213                         [
 214                                 'QWERTY\\x66-\\x80+\\xD3',
 215                                 'QWERTYf-\\x7F+\\u0080-\\uFFFF',
 216                         ],
 217                         [
 218                                 '\\\\\\x99',
 219                                 '\\\\\\u0080-\\uFFFF',
 220                         ],
 221                         [
 222                                 '-\\x99',
 223                                 '\\-\\u0080-\\uFFFF',
 224                         ],
 225                         [
 226                                 'QWERTY\\-\\x99',
 227                                 'QWERTY\\-\\u0080-\\uFFFF',
 228                         ],
 229                         [
 230                                 '\\\\x99',
 231                                 '\\\\x99',
 232                         ],
 233                         [
 234                                 'A-\\x9F',
 235                                 'A-\\x7F\\u0080-\\uFFFF',
 236                         ],
 237                         [
 238                                 '\\x66-\\x77QWERTY\\x88-\\x91FXZ',
 239                                 'f-wQWERTYFXZ\\u0080-\\uFFFF',
 240                         ],
 241                         [
 242                                 '\\x66-\\x99QWERTY\\xAA-\\xEEFXZ',
 243                                 'f-\\x7FQWERTYFXZ\\u0080-\\uFFFF',
 244                         ],
 245                 ];
 246         }
 247
 248         /**
 249          * @dataProvider provideConvertByteClassToUnicodeClass
 250          * @covers Title::convertByteClassToUnicodeClass
 251          */
 252         public function testConvertByteClassToUnicodeClass( $byteClass, $unicodeClass ) {
 253                 $this->assertEquals( $unicodeClass, Title::convertByteClassToUnicodeClass( $byteClass ) );
 254         }
 255
 256         /**
 257          * @dataProvider provideSpecialNamesWithAndWithoutParameter
 258          * @covers Title::fixSpecialName
 259          */
 260         public function testFixSpecialNameRetainsParameter( $text, $expectedParam ) {
 261                 $title = Title::newFromText( $text );
 262                 $fixed = $title->fixSpecialName();
 263                 $stuff = explode( '/', $fixed->getDBkey(), 2 );
 264                 if ( count( $stuff ) == 2 ) {
 265                         $par = $stuff[1];
 266                 } else {
 267                         $par = null;
 268                 }
 269                 $this->assertEquals(
 270                         $expectedParam,
 271                         $par,
 272                         "T33100 regression check: Title->fixSpecialName() should preserve parameter"
 273                 );
 274         }
 275
 276         public static function provideSpecialNamesWithAndWithoutParameter() {
 277                 return [
 278                         [ 'Special:Version', null ],
 279                         [ 'Special:Version/', '' ],
 280                         [ 'Special:Version/param', 'param' ],
 281                 ];
 282         }
 283
 284         /**
 285          * Auth-less test of Title::isValidMoveOperation
 286          *
 287          * @param string $source
 288          * @param string $target
 289          * @param array|string|bool $expected Required error
 290          * @dataProvider provideTestIsValidMoveOperation
 291          * @covers Title::isValidMoveOperation
 292          * @covers Title::validateFileMoveOperation
 293          */
 294         public function testIsValidMoveOperation( $source, $target, $expected ) {
 295                 $this->setMwGlobals( 'wgContentHandlerUseDB', false );
 296                 $title = Title::newFromText( $source );
 297                 $nt = Title::newFromText( $target );
 298                 $errors = $title->isValidMoveOperation( $nt, false );
 299                 if ( $expected === true ) {
 300                         $this->assertTrue( $errors );
 301                 } else {
 302                         $errors = $this->flattenErrorsArray( $errors );
 303                         foreach ( (array)$expected as $error ) {
 304                                 $this->assertContains( $error, $errors );
 305                         }
 306                 }
 307         }
 308
 309         public static function provideTestIsValidMoveOperation() {
 310                 return [
 311                         // for Title::isValidMoveOperation
 312                         [ 'Some page', '', 'badtitletext' ],
 313                         [ 'Test', 'Test', 'selfmove' ],
 314                         [ 'Special:FooBar', 'Test', 'immobile-source-namespace' ],
 315                         [ 'Test', 'Special:FooBar', 'immobile-target-namespace' ],
 316                         [ 'MediaWiki:Common.js', 'Help:Some wikitext page', 'bad-target-model' ],
 317                         [ 'Page', 'File:Test.jpg', 'nonfile-cannot-move-to-file' ],
 318                         // for Title::validateFileMoveOperation
 319                         [ 'File:Test.jpg', 'Page', 'imagenocrossnamespace' ],
 320                 ];
 321         }
 322
 323         /**
 324          * Auth-less test of Title::userCan
 325          *
 326          * @param array $whitelistRegexp
 327          * @param string $source
 328          * @param string $action
 329          * @param array|string|bool $expected Required error
 330          *
 331          * @covers Title::checkReadPermissions
 332          * @dataProvider dataWgWhitelistReadRegexp
 333          */
 334         public function testWgWhitelistReadRegexp( $whitelistRegexp, $source, $action, $expected ) {
 335                 // $wgWhitelistReadRegexp must be an array. Since the provided test cases
 336                 // usually have only one regex, it is more concise to write the lonely regex
 337                 // as a string. Thus we cast to an array() to honor $wgWhitelistReadRegexp
 338                 // type requisite.
 339                 if ( is_string( $whitelistRegexp ) ) {
 340                         $whitelistRegexp = [ $whitelistRegexp ];
 341                 }
 342
 343                 $this->setMwGlobals( [
 344                         // So User::isEveryoneAllowed( 'read' ) === false
 345                         'wgGroupPermissions' => [ '*' => [ 'read' => false ] ],
 346                         'wgWhitelistRead' => [ 'some random non sense title' ],
 347                         'wgWhitelistReadRegexp' => $whitelistRegexp,
 348                 ] );
 349
 350                 $title = Title::newFromDBkey( $source );
 351
 352                 // New anonymous user with no rights
 353                 $user = new User;
 354                 $user->mRights = [];
 355                 $errors = $title->userCan( $action, $user );
 356
 357                 if ( is_bool( $expected ) ) {
 358                         # Forge the assertion message depending on the assertion expectation
 359                         $allowableness = $expected
 360                                 ? " should be allowed"
 361                                 : " should NOT be allowed";
 362                         $this->assertEquals(
 363                                 $expected,
 364                                 $errors,
 365                                 "User action '$action' on [[$source]] $allowableness."
 366                         );
 367                 } else {
 368                         $errors = $this->flattenErrorsArray( $errors );
 369                         foreach ( (array)$expected as $error ) {
 370                                 $this->assertContains( $error, $errors );
 371                         }
 372                 }
 373         }
 374
 375         /**
 376          * Provides test parameter values for testWgWhitelistReadRegexp()
 377          */
 378         public function dataWgWhitelistReadRegexp() {
 379                 $ALLOWED = true;
 380                 $DISALLOWED = false;
 381
 382                 return [
 383                         // Everything, if this doesn't work, we're really in trouble
 384                         [ '/.*/', 'Main_Page', 'read', $ALLOWED ],
 385                         [ '/.*/', 'Main_Page', 'edit', $DISALLOWED ],
 386
 387                         // We validate against the title name, not the db key
 388                         [ '/^Main_Page$/', 'Main_Page', 'read', $DISALLOWED ],
 389                         // Main page
 390                         [ '/^Main/', 'Main_Page', 'read', $ALLOWED ],
 391                         [ '/^Main.*/', 'Main_Page', 'read', $ALLOWED ],
 392                         // With spaces
 393                         [ '/Mic\sCheck/', 'Mic Check', 'read', $ALLOWED ],
 394                         // Unicode multibyte
 395                         // ...without unicode modifier
 396                         [ '/Unicode Test . Yes/', 'Unicode Test Ñ Yes', 'read', $DISALLOWED ],
 397                         // ...with unicode modifier
 398                         [ '/Unicode Test . Yes/u', 'Unicode Test Ñ Yes', 'read', $ALLOWED ],
 399                         // Case insensitive
 400                         [ '/MiC ChEcK/', 'mic check', 'read', $DISALLOWED ],
 401                         [ '/MiC ChEcK/i', 'mic check', 'read', $ALLOWED ],
 402
 403                         // From DefaultSettings.php:
 404                         [ "@^UsEr.*@i", 'User is banned', 'read', $ALLOWED ],
 405                         [ "@^UsEr.*@i", 'User:John Doe', 'read', $ALLOWED ],
 406
 407                         // With namespaces:
 408                         [ '/^Special:NewPages$/', 'Special:NewPages', 'read', $ALLOWED ],
 409                         [ null, 'Special:Newpages', 'read', $DISALLOWED ],
 410
 411                 ];
 412         }
 413
 414         public function flattenErrorsArray( $errors ) {
 415                 $result = [];
 416                 foreach ( $errors as $error ) {
 417                         $result[] = $error[0];
 418                 }
 419
 420                 return $result;
 421         }
 422
 423         /**
 424          * @dataProvider provideGetPageViewLanguage
 425          * @covers Title::getPageViewLanguage
 426          */
 427         public function testGetPageViewLanguage( $expected, $titleText, $contLang,
 428                 $lang, $variant, $msg = ''
 429         ) {
 430                 // Setup environnement for this test
 431                 $this->setMwGlobals( [
 432                         'wgDefaultLanguageVariant' => $variant,
 433                         'wgAllowUserJs' => true,
 434                 ] );
 435                 $this->setUserLang( $lang );
 436                 $this->setContentLang( $contLang );
 437
 438                 $title = Title::newFromText( $titleText );
 439                 $this->assertInstanceOf( Title::class, $title,
 440                         "Test must be passed a valid title text, you gave '$titleText'"
 441                 );
 442                 $this->assertEquals( $expected,
 443                         $title->getPageViewLanguage()->getCode(),
 444                         $msg
 445                 );
 446         }
 447
 448         public static function provideGetPageViewLanguage() {
 449                 # Format:
 450                 # - expected
 451                 # - Title name
 452                 # - content language (expected in most cases)
 453                 # - wgLang (on some specific pages)
 454                 # - wgDefaultLanguageVariant
 455                 # - Optional message
 456                 return [
 457                         [ 'fr', 'Help:I_need_somebody', 'fr', 'fr', false ],
 458                         [ 'es', 'Help:I_need_somebody', 'es', 'zh-tw', false ],
 459                         [ 'zh', 'Help:I_need_somebody', 'zh', 'zh-tw', false ],
 460
 461                         [ 'es', 'Help:I_need_somebody', 'es', 'zh-tw', 'zh-cn' ],
 462                         [ 'es', 'MediaWiki:About', 'es', 'zh-tw', 'zh-cn' ],
 463                         [ 'es', 'MediaWiki:About/', 'es', 'zh-tw', 'zh-cn' ],
 464                         [ 'de', 'MediaWiki:About/de', 'es', 'zh-tw', 'zh-cn' ],
 465                         [ 'en', 'MediaWiki:Common.js', 'es', 'zh-tw', 'zh-cn' ],
 466                         [ 'en', 'MediaWiki:Common.css', 'es', 'zh-tw', 'zh-cn' ],
 467                         [ 'en', 'User:JohnDoe/Common.js', 'es', 'zh-tw', 'zh-cn' ],
 468                         [ 'en', 'User:JohnDoe/Monobook.css', 'es', 'zh-tw', 'zh-cn' ],
 469
 470                         [ 'zh-cn', 'Help:I_need_somebody', 'zh', 'zh-tw', 'zh-cn' ],
 471                         [ 'zh', 'MediaWiki:About', 'zh', 'zh-tw', 'zh-cn' ],
 472                         [ 'zh', 'MediaWiki:About/', 'zh', 'zh-tw', 'zh-cn' ],
 473                         [ 'de', 'MediaWiki:About/de', 'zh', 'zh-tw', 'zh-cn' ],
 474                         [ 'zh-cn', 'MediaWiki:About/zh-cn', 'zh', 'zh-tw', 'zh-cn' ],
 475                         [ 'zh-tw', 'MediaWiki:About/zh-tw', 'zh', 'zh-tw', 'zh-cn' ],
 476                         [ 'en', 'MediaWiki:Common.js', 'zh', 'zh-tw', 'zh-cn' ],
 477                         [ 'en', 'MediaWiki:Common.css', 'zh', 'zh-tw', 'zh-cn' ],
 478                         [ 'en', 'User:JohnDoe/Common.js', 'zh', 'zh-tw', 'zh-cn' ],
 479                         [ 'en', 'User:JohnDoe/Monobook.css', 'zh', 'zh-tw', 'zh-cn' ],
 480
 481                         [ 'zh-tw', 'Special:NewPages', 'es', 'zh-tw', 'zh-cn' ],
 482                         [ 'zh-tw', 'Special:NewPages', 'zh', 'zh-tw', 'zh-cn' ],
 483
 484                 ];
 485         }
 486
 487         /**
 488          * @dataProvider provideBaseTitleCases
 489          * @covers Title::getBaseText
 490          */
 491         public function testGetBaseText( $title, $expected, $msg = '' ) {
 492                 $title = Title::newFromText( $title );
 493                 $this->assertEquals( $expected,
 494                         $title->getBaseText(),
 495                         $msg
 496                 );
 497         }
 498
 499         public static function provideBaseTitleCases() {
 500                 return [
 501                         # Title, expected base, optional message
 502                         [ 'User:John_Doe/subOne/subTwo', 'John Doe/subOne' ],
 503                         [ 'User:Foo/Bar/Baz', 'Foo/Bar' ],
 504                 ];
 505         }
 506
 507         /**
 508          * @dataProvider provideRootTitleCases
 509          * @covers Title::getRootText
 510          */
 511         public function testGetRootText( $title, $expected, $msg = '' ) {
 512                 $title = Title::newFromText( $title );
 513                 $this->assertEquals( $expected,
 514                         $title->getRootText(),
 515                         $msg
 516                 );
 517         }
 518
 519         public static function provideRootTitleCases() {
 520                 return [
 521                         # Title, expected base, optional message
 522                         [ 'User:John_Doe/subOne/subTwo', 'John Doe' ],
 523                         [ 'User:Foo/Bar/Baz', 'Foo' ],
 524                 ];
 525         }
 526
 527         /**
 528          * @todo Handle $wgNamespacesWithSubpages cases
 529          * @dataProvider provideSubpageTitleCases
 530          * @covers Title::getSubpageText
 531          */
 532         public function testGetSubpageText( $title, $expected, $msg = '' ) {
 533                 $title = Title::newFromText( $title );
 534                 $this->assertEquals( $expected,
 535                         $title->getSubpageText(),
 536                         $msg
 537                 );
 538         }
 539
 540         public static function provideSubpageTitleCases() {
 541                 return [
 542                         # Title, expected base, optional message
 543                         [ 'User:John_Doe/subOne/subTwo', 'subTwo' ],
 544                         [ 'User:John_Doe/subOne', 'subOne' ],
 545                 ];
 546         }
 547
 548         public static function provideNewFromTitleValue() {
 549                 return [
 550                         [ new TitleValue( NS_MAIN, 'Foo' ) ],
 551                         [ new TitleValue( NS_MAIN, 'Foo', 'bar' ) ],
 552                         [ new TitleValue( NS_USER, 'Hansi_Maier' ) ],
 553                 ];
 554         }
 555
 556         /**
 557          * @covers Title::newFromTitleValue
 558          * @dataProvider provideNewFromTitleValue
 559          */
 560         public function testNewFromTitleValue( TitleValue $value ) {
 561                 $title = Title::newFromTitleValue( $value );
 562
 563                 $dbkey = str_replace( ' ', '_', $value->getText() );
 564                 $this->assertEquals( $dbkey, $title->getDBkey() );
 565                 $this->assertEquals( $value->getNamespace(), $title->getNamespace() );
 566                 $this->assertEquals( $value->getFragment(), $title->getFragment() );
 567         }
 568
 569         public static function provideGetTitleValue() {
 570                 return [
 571                         [ 'Foo' ],
 572                         [ 'Foo#bar' ],
 573                         [ 'User:Hansi_Maier' ],
 574                 ];
 575         }
 576
 577         /**
 578          * @covers Title::getTitleValue
 579          * @dataProvider provideGetTitleValue
 580          */
 581         public function testGetTitleValue( $text ) {
 582                 $title = Title::newFromText( $text );
 583                 $value = $title->getTitleValue();
 584
 585                 $dbkey = str_replace( ' ', '_', $value->getText() );
 586                 $this->assertEquals( $title->getDBkey(), $dbkey );
 587                 $this->assertEquals( $title->getNamespace(), $value->getNamespace() );
 588                 $this->assertEquals( $title->getFragment(), $value->getFragment() );
 589         }
 590
 591         public static function provideGetFragment() {
 592                 return [
 593                         [ 'Foo', '' ],
 594                         [ 'Foo#bar', 'bar' ],
 595                         [ 'Foo#bär', 'bär' ],
 596
 597                         // Inner whitespace is normalized
 598                         [ 'Foo#bar_bar', 'bar bar' ],
 599                         [ 'Foo#bar bar', 'bar bar' ],
 600                         [ 'Foo#bar   bar', 'bar bar' ],
 601
 602                         // Leading whitespace is kept, trailing whitespace is trimmed.
 603                         // XXX: Is this really want we want?
 604                         [ 'Foo#_bar_bar_', ' bar bar' ],
 605                         [ 'Foo# bar bar ', ' bar bar' ],
 606                 ];
 607         }
 608
 609         /**
 610          * @covers Title::getFragment
 611          * @dataProvider provideGetFragment
 612          *
 613          * @param string $full
 614          * @param string $fragment
 615          */
 616         public function testGetFragment( $full, $fragment ) {
 617                 $title = Title::newFromText( $full );
 618                 $this->assertEquals( $fragment, $title->getFragment() );
 619         }
 620
 621         /**
 622          * @covers Title::isAlwaysKnown
 623          * @dataProvider provideIsAlwaysKnown
 624          * @param string $page
 625          * @param bool $isKnown
 626          */
 627         public function testIsAlwaysKnown( $page, $isKnown ) {
 628                 $title = Title::newFromText( $page );
 629                 $this->assertEquals( $isKnown, $title->isAlwaysKnown() );
 630         }
 631
 632         public static function provideIsAlwaysKnown() {
 633                 return [
 634                         [ 'Some nonexistent page', false ],
 635                         [ 'UTPage', false ],
 636                         [ '#test', true ],
 637                         [ 'Special:BlankPage', true ],
 638                         [ 'Special:SomeNonexistentSpecialPage', false ],
 639                         [ 'MediaWiki:Parentheses', true ],
 640                         [ 'MediaWiki:Some nonexistent message', false ],
 641                 ];
 642         }
 643
 644         /**
 645          * @covers Title::isValid
 646          * @dataProvider provideIsValid
 647          * @param Title $title
 648          * @param bool $isValid
 649          */
 650         public function testIsValid( Title $title, $isValid ) {
 651                 $this->assertEquals( $isValid, $title->isValid(), $title->getPrefixedText() );
 652         }
 653
 654         public static function provideIsValid() {
 655                 return [
 656                         [ Title::makeTitle( NS_MAIN, '' ), false ],
 657                         [ Title::makeTitle( NS_MAIN, '<>' ), false ],
 658                         [ Title::makeTitle( NS_MAIN, '|' ), false ],
 659                         [ Title::makeTitle( NS_MAIN, '#' ), false ],
 660                         [ Title::makeTitle( NS_MAIN, 'Test' ), true ],
 661                         [ Title::makeTitle( -33, 'Test' ), false ],
 662                         [ Title::makeTitle( 77663399, 'Test' ), false ],
 663                 ];
 664         }
 665
 666         /**
 667          * @covers Title::isAlwaysKnown
 668          */
 669         public function testIsAlwaysKnownOnInterwiki() {
 670                 $title = Title::makeTitle( NS_MAIN, 'Interwiki link', '', 'externalwiki' );
 671                 $this->assertTrue( $title->isAlwaysKnown() );
 672         }
 673
 674         /**
 675          * @covers Title::exists
 676          */
 677         public function testExists() {
 678                 $title = Title::makeTitle( NS_PROJECT, 'New page' );
 679                 $linkCache = MediaWikiServices::getInstance()->getLinkCache();
 680
 681                 $article = new Article( $title );
 682                 $page = $article->getPage();
 683                 $page->doEditContent( new WikitextContent( 'Some [[link]]' ), 'summary' );
 684
 685                 // Tell Title it doesn't know whether it exists
 686                 $title->mArticleID = -1;
 687
 688                 // Tell the link cache it doesn't exists when it really does
 689                 $linkCache->clearLink( $title );
 690                 $linkCache->addBadLinkObj( $title );
 691
 692                 $this->assertEquals(
 693                         false,
 694                         $title->exists(),
 695                         'exists() should rely on link cache unless GAID_FOR_UPDATE is used'
 696                 );
 697                 $this->assertEquals(
 698                         true,
 699                         $title->exists( Title::GAID_FOR_UPDATE ),
 700                         'exists() should re-query database when GAID_FOR_UPDATE is used'
 701                 );
 702         }
 703
 704         public function provideCanHaveTalkPage() {
 705                 return [
 706                         'User page has talk page' => [
 707                                 Title::makeTitle( NS_USER, 'Jane' ), true
 708                         ],
 709                         'Talke page has talk page' => [
 710                                 Title::makeTitle( NS_TALK, 'Foo' ), true
 711                         ],
 712                         'Special page cannot have talk page' => [
 713                                 Title::makeTitle( NS_SPECIAL, 'Thing' ), false
 714                         ],
 715                         'Virtual namespace cannot have talk page' => [
 716                                 Title::makeTitle( NS_MEDIA, 'Kitten.jpg' ), false
 717                         ],
 718                 ];
 719         }
 720
 721         /**
 722          * @dataProvider provideCanHaveTalkPage
 723          * @covers Title::canHaveTalkPage
 724          *
 725          * @param Title $title
 726          * @param bool $expected
 727          */
 728         public function testCanHaveTalkPage( Title $title, $expected ) {
 729                 $actual = $title->canHaveTalkPage();
 730                 $this->assertSame( $expected, $actual, $title->getPrefixedDBkey() );
 731         }
 732
 733         public static function provideGetTalkPage_good() {
 734                 return [
 735                         [ Title::makeTitle( NS_MAIN, 'Test' ), Title::makeTitle( NS_TALK, 'Test' ) ],
 736                         [ Title::makeTitle( NS_TALK, 'Test' ), Title::makeTitle( NS_TALK, 'Test' ) ],
 737                 ];
 738         }
 739
 740         /**
 741          * @dataProvider provideGetTalkPage_good
 742          * @covers Title::getTalkPage
 743          */
 744         public function testGetTalkPage_good( Title $title, Title $expected ) {
 745                 $talk = $title->getTalkPage();
 746                 $this->assertSame(
 747                         $expected->getPrefixedDBKey(),
 748                         $talk->getPrefixedDBKey(),
 749                         $title->getPrefixedDBKey()
 750                 );
 751         }
 752
 753         /**
 754          * @dataProvider provideGetTalkPage_good
 755          * @covers Title::getTalkPageIfDefined
 756          */
 757         public function testGetTalkPageIfDefined_good( Title $title ) {
 758                 $talk = $title->getTalkPageIfDefined();
 759                 $this->assertInstanceOf(
 760                         Title::class,
 761                         $talk,
 762                         $title->getPrefixedDBKey()
 763                 );
 764         }
 765
 766         public static function provideGetTalkPage_bad() {
 767                 return [
 768                         [ Title::makeTitle( NS_SPECIAL, 'Test' ) ],
 769                         [ Title::makeTitle( NS_MEDIA, 'Test' ) ],
 770                 ];
 771         }
 772
 773         /**
 774          * @dataProvider provideGetTalkPage_bad
 775          * @covers Title::getTalkPageIfDefined
 776          */
 777         public function testGetTalkPageIfDefined_bad( Title $title ) {
 778                 $talk = $title->getTalkPageIfDefined();
 779                 $this->assertNull(
 780                         $talk,
 781                         $title->getPrefixedDBKey()
 782                 );
 783         }
 784
 785         public function provideCreateFragmentTitle() {
 786                 return [
 787                         [ Title::makeTitle( NS_MAIN, 'Test' ), 'foo' ],
 788                         [ Title::makeTitle( NS_TALK, 'Test', 'foo' ), '' ],
 789                         [ Title::makeTitle( NS_CATEGORY, 'Test', 'foo' ), 'bar' ],
 790                         [ Title::makeTitle( NS_MAIN, 'Test1', '', 'interwiki' ), 'baz' ]
 791                 ];
 792         }
 793
 794         /**
 795          * @covers Title::createFragmentTarget
 796          * @dataProvider provideCreateFragmentTitle
 797          */
 798         public function testCreateFragmentTitle( Title $title, $fragment ) {
 799                 $this->mergeMwGlobalArrayValue( 'wgHooks', [
 800                         'InterwikiLoadPrefix' => [
 801                                 function ( $prefix, &$iwdata ) {
 802                                         if ( $prefix === 'interwiki' ) {
 803                                                 $iwdata = [
 804                                                         'iw_url' => 'http://example.com/',
 805                                                         'iw_local' => 0,
 806                                                         'iw_trans' => 0,
 807                                                 ];
 808                                                 return false;
 809                                         }
 810                                 },
 811                         ],
 812                 ] );
 813
 814                 $fragmentTitle = $title->createFragmentTarget( $fragment );
 815
 816                 $this->assertEquals( $title->getNamespace(), $fragmentTitle->getNamespace() );
 817                 $this->assertEquals( $title->getText(), $fragmentTitle->getText() );
 818                 $this->assertEquals( $title->getInterwiki(), $fragmentTitle->getInterwiki() );
 819                 $this->assertEquals( $fragment, $fragmentTitle->getFragment() );
 820         }
 821
 822         public function provideGetPrefixedText() {
 823                 return [
 824                         // ns = 0
 825                         [
 826                                 Title::makeTitle( NS_MAIN, 'Foo bar' ),
 827                                 'Foo bar'
 828                         ],
 829                         // ns = 2
 830                         [
 831                                 Title::makeTitle( NS_USER, 'Foo bar' ),
 832                                 'User:Foo bar'
 833                         ],
 834                         // ns = 3
 835                         [
 836                                 Title::makeTitle( NS_USER_TALK, 'Foo bar' ),
 837                                 'User talk:Foo bar'
 838                         ],
 839                         // fragment not included
 840                         [
 841                                 Title::makeTitle( NS_MAIN, 'Foo bar', 'fragment' ),
 842                                 'Foo bar'
 843                         ],
 844                         // ns = -2
 845                         [
 846                                 Title::makeTitle( NS_MEDIA, 'Foo bar' ),
 847                                 'Media:Foo bar'
 848                         ],
 849                         // non-existent namespace
 850                         [
 851                                 Title::makeTitle( 100777, 'Foo bar' ),
 852                                 'Special:Badtitle/NS100777:Foo bar'
 853                         ],
 854                 ];
 855         }
 856
 857         /**
 858          * @covers Title::getPrefixedText
 859          * @dataProvider provideGetPrefixedText
 860          */
 861         public function testGetPrefixedText( Title $title, $expected ) {
 862                 $this->assertEquals( $expected, $title->getPrefixedText() );
 863         }
 864
 865         public function provideGetPrefixedDBKey() {
 866                 return [
 867                         // ns = 0
 868                         [
 869                                 Title::makeTitle( NS_MAIN, 'Foo_bar' ),
 870                                 'Foo_bar'
 871                         ],
 872                         // ns = 2
 873                         [
 874                                 Title::makeTitle( NS_USER, 'Foo_bar' ),
 875                                 'User:Foo_bar'
 876                         ],
 877                         // ns = 3
 878                         [
 879                                 Title::makeTitle( NS_USER_TALK, 'Foo_bar' ),
 880                                 'User_talk:Foo_bar'
 881                         ],
 882                         // fragment not included
 883                         [
 884                                 Title::makeTitle( NS_MAIN, 'Foo_bar', 'fragment' ),
 885                                 'Foo_bar'
 886                         ],
 887                         // ns = -2
 888                         [
 889                                 Title::makeTitle( NS_MEDIA, 'Foo_bar' ),
 890                                 'Media:Foo_bar'
 891                         ],
 892                         // non-existent namespace
 893                         [
 894                                 Title::makeTitle( 100777, 'Foo_bar' ),
 895                                 'Special:Badtitle/NS100777:Foo_bar'
 896                         ],
 897                 ];
 898         }
 899
 900         /**
 901          * @covers Title::getPrefixedDBKey
 902          * @dataProvider provideGetPrefixedDBKey
 903          */
 904         public function testGetPrefixedDBKey( Title $title, $expected ) {
 905                 $this->assertEquals( $expected, $title->getPrefixedDBkey() );
 906         }
 907
 908         /**
 909          * @covers Title::getFragmentForURL
 910          * @dataProvider provideGetFragmentForURL
 911          *
 912          * @param string $titleStr
 913          * @param string $expected
 914          */
 915         public function testGetFragmentForURL( $titleStr, $expected ) {
 916                 $this->setMwGlobals( [
 917                         'wgFragmentMode' => [ 'html5' ],
 918                         'wgExternalInterwikiFragmentMode' => 'legacy',
 919                 ] );
 920                 $dbw = wfGetDB( DB_MASTER );
 921                 $dbw->insert( 'interwiki',
 922                         [
 923                                 [
 924                                         'iw_prefix' => 'de',
 925                                         'iw_url' => 'http://de.wikipedia.org/wiki/',
 926                                         'iw_api' => 'http://de.wikipedia.org/w/api.php',
 927                                         'iw_wikiid' => 'dewiki',
 928                                         'iw_local' => 1,
 929                                         'iw_trans' => 0,
 930                                 ],
 931                                 [
 932                                         'iw_prefix' => 'zz',
 933                                         'iw_url' => 'http://zzwiki.org/wiki/',
 934                                         'iw_api' => 'http://zzwiki.org/w/api.php',
 935                                         'iw_wikiid' => 'zzwiki',
 936                                         'iw_local' => 0,
 937                                         'iw_trans' => 0,
 938                                 ],
 939                         ],
 940                         __METHOD__,
 941                         [ 'IGNORE' ]
 942                 );
 943
 944                 $title = Title::newFromText( $titleStr );
 945                 self::assertEquals( $expected, $title->getFragmentForURL() );
 946
 947                 $dbw->delete( 'interwiki', '*', __METHOD__ );
 948         }
 949
 950         public function provideGetFragmentForURL() {
 951                 return [
 952                         [ 'Foo', '' ],
 953                         [ 'Foo#ümlåût', '#ümlåût' ],
 954                         [ 'de:Foo#Bå®', '#Bå®' ],
 955                         [ 'zz:Foo#тест', '#.D1.82.D0.B5.D1.81.D1.82' ],
 956                 ];
 957         }
 958
 959         /**
 960          * @covers Title::isRawHtmlMessage
 961          * @dataProvider provideIsRawHtmlMessage
 962          */
 963         public function testIsRawHtmlMessage( $textForm, $expected ) {
 964                 $this->setMwGlobals( 'wgRawHtmlMessages', [
 965                         'foobar',
 966                         'foo_bar',
 967                         'foo-bar',
 968                 ] );
 969
 970                 $title = Title::newFromText( $textForm );
 971                 $this->assertSame( $expected, $title->isRawHtmlMessage() );
 972         }
 973
 974         public function provideIsRawHtmlMessage() {
 975                 return [
 976                         [ 'MediaWiki:Foobar', true ],
 977                         [ 'MediaWiki:Foo bar', true ],
 978                         [ 'MediaWiki:Foo-bar', true ],
 979                         [ 'MediaWiki:foo bar', true ],
 980                         [ 'MediaWiki:foo-bar', true ],
 981                         [ 'MediaWiki:foobar', true ],
 982                         [ 'MediaWiki:some-other-message', false ],
 983                         [ 'Main Page', false ],
 984                 ];
 985         }
 986 }