63 'sunday',
'monday',
'tuesday',
'wednesday',
'thursday',
68 'sun',
'mon',
'tue',
'wed',
'thu',
'fri',
'sat'
72 'january',
'february',
'march',
'april',
'may_long',
'june',
73 'july',
'august',
'september',
'october',
'november',
77 'january-gen',
'february-gen',
'march-gen',
'april-gen',
'may-gen',
'june-gen',
78 'july-gen',
'august-gen',
'september-gen',
'october-gen',
'november-gen',
82 'jan',
'feb',
'mar',
'apr',
'may',
'jun',
'jul',
'aug',
83 'sep',
'oct',
'nov',
'dec'
87 'iranian-calendar-m1',
'iranian-calendar-m2',
'iranian-calendar-m3',
88 'iranian-calendar-m4',
'iranian-calendar-m5',
'iranian-calendar-m6',
89 'iranian-calendar-m7',
'iranian-calendar-m8',
'iranian-calendar-m9',
90 'iranian-calendar-m10',
'iranian-calendar-m11',
'iranian-calendar-m12'
94 'hebrew-calendar-m1',
'hebrew-calendar-m2',
'hebrew-calendar-m3',
95 'hebrew-calendar-m4',
'hebrew-calendar-m5',
'hebrew-calendar-m6',
96 'hebrew-calendar-m7',
'hebrew-calendar-m8',
'hebrew-calendar-m9',
97 'hebrew-calendar-m10',
'hebrew-calendar-m11',
'hebrew-calendar-m12',
98 'hebrew-calendar-m6a',
'hebrew-calendar-m6b'
102 'hebrew-calendar-m1-gen',
'hebrew-calendar-m2-gen',
'hebrew-calendar-m3-gen',
103 'hebrew-calendar-m4-gen',
'hebrew-calendar-m5-gen',
'hebrew-calendar-m6-gen',
104 'hebrew-calendar-m7-gen',
'hebrew-calendar-m8-gen',
'hebrew-calendar-m9-gen',
105 'hebrew-calendar-m10-gen',
'hebrew-calendar-m11-gen',
'hebrew-calendar-m12-gen',
106 'hebrew-calendar-m6a-gen',
'hebrew-calendar-m6b-gen'
110 'hijri-calendar-m1',
'hijri-calendar-m2',
'hijri-calendar-m3',
111 'hijri-calendar-m4',
'hijri-calendar-m5',
'hijri-calendar-m6',
112 'hijri-calendar-m7',
'hijri-calendar-m8',
'hijri-calendar-m9',
113 'hijri-calendar-m10',
'hijri-calendar-m11',
'hijri-calendar-m12'
120 static public $durationIntervals = [
121 'millennia' => 31556952000,
122 'centuries' => 3155695200,
123 'decades' => 315569520,
138 static private $fallbackLanguageCache = [];
155 static private $lre =
"\xE2\x80\xAA";
156 static private $rle =
"\xE2\x80\xAB";
157 static private $pdf =
"\xE2\x80\xAC";
172 static private $strongDirRegex =
'/(?:([\x{41}-\x{5a}\x{61}-\x{7a}\x{aa}\x{b5}\x{ba}\x{c0}-\x{d6}\x{d8}-\x{f6}\x{f8}-\x{2b8}\x{2bb}-\x{2c1}\x{2d0}\x{2d1}\x{2e0}-\x{2e4}\x{2ee}\x{370}-\x{373}\x{376}\x{377}\x{37a}-\x{37d}\x{37f}\x{386}\x{388}-\x{38a}\x{38c}\x{38e}-\x{3a1}\x{3a3}-\x{3f5}\x{3f7}-\x{482}\x{48a}-\x{52f}\x{531}-\x{556}\x{559}-\x{55f}\x{561}-\x{587}\x{589}\x{903}-\x{939}\x{93b}\x{93d}-\x{940}\x{949}-\x{94c}\x{94e}-\x{950}\x{958}-\x{961}\x{964}-\x{980}\x{982}\x{983}\x{985}-\x{98c}\x{98f}\x{990}\x{993}-\x{9a8}\x{9aa}-\x{9b0}\x{9b2}\x{9b6}-\x{9b9}\x{9bd}-\x{9c0}\x{9c7}\x{9c8}\x{9cb}\x{9cc}\x{9ce}\x{9d7}\x{9dc}\x{9dd}\x{9df}-\x{9e1}\x{9e6}-\x{9f1}\x{9f4}-\x{9fa}\x{a03}\x{a05}-\x{a0a}\x{a0f}\x{a10}\x{a13}-\x{a28}\x{a2a}-\x{a30}\x{a32}\x{a33}\x{a35}\x{a36}\x{a38}\x{a39}\x{a3e}-\x{a40}\x{a59}-\x{a5c}\x{a5e}\x{a66}-\x{a6f}\x{a72}-\x{a74}\x{a83}\x{a85}-\x{a8d}\x{a8f}-\x{a91}\x{a93}-\x{aa8}\x{aaa}-\x{ab0}\x{ab2}\x{ab3}\x{ab5}-\x{ab9}\x{abd}-\x{ac0}\x{ac9}\x{acb}\x{acc}\x{ad0}\x{ae0}\x{ae1}\x{ae6}-\x{af0}\x{af9}\x{b02}\x{b03}\x{b05}-\x{b0c}\x{b0f}\x{b10}\x{b13}-\x{b28}\x{b2a}-\x{b30}\x{b32}\x{b33}\x{b35}-\x{b39}\x{b3d}\x{b3e}\x{b40}\x{b47}\x{b48}\x{b4b}\x{b4c}\x{b57}\x{b5c}\x{b5d}\x{b5f}-\x{b61}\x{b66}-\x{b77}\x{b83}\x{b85}-\x{b8a}\x{b8e}-\x{b90}\x{b92}-\x{b95}\x{b99}\x{b9a}\x{b9c}\x{b9e}\x{b9f}\x{ba3}\x{ba4}\x{ba8}-\x{baa}\x{bae}-\x{bb9}\x{bbe}\x{bbf}\x{bc1}\x{bc2}\x{bc6}-\x{bc8}\x{bca}-\x{bcc}\x{bd0}\x{bd7}\x{be6}-\x{bf2}\x{c01}-\x{c03}\x{c05}-\x{c0c}\x{c0e}-\x{c10}\x{c12}-\x{c28}\x{c2a}-\x{c39}\x{c3d}\x{c41}-\x{c44}\x{c58}-\x{c5a}\x{c60}\x{c61}\x{c66}-\x{c6f}\x{c7f}\x{c82}\x{c83}\x{c85}-\x{c8c}\x{c8e}-\x{c90}\x{c92}-\x{ca8}\x{caa}-\x{cb3}\x{cb5}-\x{cb9}\x{cbd}-\x{cc4}\x{cc6}-\x{cc8}\x{cca}\x{ccb}\x{cd5}\x{cd6}\x{cde}\x{ce0}\x{ce1}\x{ce6}-\x{cef}\x{cf1}\x{cf2}\x{d02}\x{d03}\x{d05}-\x{d0c}\x{d0e}-\x{d10}\x{d12}-\x{d3a}\x{d3d}-\x{d40}\x{d46}-\x{d48}\x{d4a}-\x{d4c}\x{d4e}\x{d57}\x{d5f}-\x{d61}\x{d66}-\x{d75}\x{d79}-\x{d7f}\x{d82}\x{d83}\x{d85}-\x{d96}\x{d9a}-\x{db1}\x{db3}-\x{dbb}\x{dbd}\x{dc0}-\x{dc6}\x{dcf}-\x{dd1}\x{dd8}-\x{ddf}\x{de6}-\x{def}\x{df2}-\x{df4}\x{e01}-\x{e30}\x{e32}\x{e33}\x{e40}-\x{e46}\x{e4f}-\x{e5b}\x{e81}\x{e82}\x{e84}\x{e87}\x{e88}\x{e8a}\x{e8d}\x{e94}-\x{e97}\x{e99}-\x{e9f}\x{ea1}-\x{ea3}\x{ea5}\x{ea7}\x{eaa}\x{eab}\x{ead}-\x{eb0}\x{eb2}\x{eb3}\x{ebd}\x{ec0}-\x{ec4}\x{ec6}\x{ed0}-\x{ed9}\x{edc}-\x{edf}\x{f00}-\x{f17}\x{f1a}-\x{f34}\x{f36}\x{f38}\x{f3e}-\x{f47}\x{f49}-\x{f6c}\x{f7f}\x{f85}\x{f88}-\x{f8c}\x{fbe}-\x{fc5}\x{fc7}-\x{fcc}\x{fce}-\x{fda}\x{1000}-\x{102c}\x{1031}\x{1038}\x{103b}\x{103c}\x{103f}-\x{1057}\x{105a}-\x{105d}\x{1061}-\x{1070}\x{1075}-\x{1081}\x{1083}\x{1084}\x{1087}-\x{108c}\x{108e}-\x{109c}\x{109e}-\x{10c5}\x{10c7}\x{10cd}\x{10d0}-\x{1248}\x{124a}-\x{124d}\x{1250}-\x{1256}\x{1258}\x{125a}-\x{125d}\x{1260}-\x{1288}\x{128a}-\x{128d}\x{1290}-\x{12b0}\x{12b2}-\x{12b5}\x{12b8}-\x{12be}\x{12c0}\x{12c2}-\x{12c5}\x{12c8}-\x{12d6}\x{12d8}-\x{1310}\x{1312}-\x{1315}\x{1318}-\x{135a}\x{1360}-\x{137c}\x{1380}-\x{138f}\x{13a0}-\x{13f5}\x{13f8}-\x{13fd}\x{1401}-\x{167f}\x{1681}-\x{169a}\x{16a0}-\x{16f8}\x{1700}-\x{170c}\x{170e}-\x{1711}\x{1720}-\x{1731}\x{1735}\x{1736}\x{1740}-\x{1751}\x{1760}-\x{176c}\x{176e}-\x{1770}\x{1780}-\x{17b3}\x{17b6}\x{17be}-\x{17c5}\x{17c7}\x{17c8}\x{17d4}-\x{17da}\x{17dc}\x{17e0}-\x{17e9}\x{1810}-\x{1819}\x{1820}-\x{1877}\x{1880}-\x{18a8}\x{18aa}\x{18b0}-\x{18f5}\x{1900}-\x{191e}\x{1923}-\x{1926}\x{1929}-\x{192b}\x{1930}\x{1931}\x{1933}-\x{1938}\x{1946}-\x{196d}\x{1970}-\x{1974}\x{1980}-\x{19ab}\x{19b0}-\x{19c9}\x{19d0}-\x{19da}\x{1a00}-\x{1a16}\x{1a19}\x{1a1a}\x{1a1e}-\x{1a55}\x{1a57}\x{1a61}\x{1a63}\x{1a64}\x{1a6d}-\x{1a72}\x{1a80}-\x{1a89}\x{1a90}-\x{1a99}\x{1aa0}-\x{1aad}\x{1b04}-\x{1b33}\x{1b35}\x{1b3b}\x{1b3d}-\x{1b41}\x{1b43}-\x{1b4b}\x{1b50}-\x{1b6a}\x{1b74}-\x{1b7c}\x{1b82}-\x{1ba1}\x{1ba6}\x{1ba7}\x{1baa}\x{1bae}-\x{1be5}\x{1be7}\x{1bea}-\x{1bec}\x{1bee}\x{1bf2}\x{1bf3}\x{1bfc}-\x{1c2b}\x{1c34}\x{1c35}\x{1c3b}-\x{1c49}\x{1c4d}-\x{1c7f}\x{1cc0}-\x{1cc7}\x{1cd3}\x{1ce1}\x{1ce9}-\x{1cec}\x{1cee}-\x{1cf3}\x{1cf5}\x{1cf6}\x{1d00}-\x{1dbf}\x{1e00}-\x{1f15}\x{1f18}-\x{1f1d}\x{1f20}-\x{1f45}\x{1f48}-\x{1f4d}\x{1f50}-\x{1f57}\x{1f59}\x{1f5b}\x{1f5d}\x{1f5f}-\x{1f7d}\x{1f80}-\x{1fb4}\x{1fb6}-\x{1fbc}\x{1fbe}\x{1fc2}-\x{1fc4}\x{1fc6}-\x{1fcc}\x{1fd0}-\x{1fd3}\x{1fd6}-\x{1fdb}\x{1fe0}-\x{1fec}\x{1ff2}-\x{1ff4}\x{1ff6}-\x{1ffc}\x{200e}\x{2071}\x{207f}\x{2090}-\x{209c}\x{2102}\x{2107}\x{210a}-\x{2113}\x{2115}\x{2119}-\x{211d}\x{2124}\x{2126}\x{2128}\x{212a}-\x{212d}\x{212f}-\x{2139}\x{213c}-\x{213f}\x{2145}-\x{2149}\x{214e}\x{214f}\x{2160}-\x{2188}\x{2336}-\x{237a}\x{2395}\x{249c}-\x{24e9}\x{26ac}\x{2800}-\x{28ff}\x{2c00}-\x{2c2e}\x{2c30}-\x{2c5e}\x{2c60}-\x{2ce4}\x{2ceb}-\x{2cee}\x{2cf2}\x{2cf3}\x{2d00}-\x{2d25}\x{2d27}\x{2d2d}\x{2d30}-\x{2d67}\x{2d6f}\x{2d70}\x{2d80}-\x{2d96}\x{2da0}-\x{2da6}\x{2da8}-\x{2dae}\x{2db0}-\x{2db6}\x{2db8}-\x{2dbe}\x{2dc0}-\x{2dc6}\x{2dc8}-\x{2dce}\x{2dd0}-\x{2dd6}\x{2dd8}-\x{2dde}\x{3005}-\x{3007}\x{3021}-\x{3029}\x{302e}\x{302f}\x{3031}-\x{3035}\x{3038}-\x{303c}\x{3041}-\x{3096}\x{309d}-\x{309f}\x{30a1}-\x{30fa}\x{30fc}-\x{30ff}\x{3105}-\x{312d}\x{3131}-\x{318e}\x{3190}-\x{31ba}\x{31f0}-\x{321c}\x{3220}-\x{324f}\x{3260}-\x{327b}\x{327f}-\x{32b0}\x{32c0}-\x{32cb}\x{32d0}-\x{32fe}\x{3300}-\x{3376}\x{337b}-\x{33dd}\x{33e0}-\x{33fe}\x{3400}-\x{4db5}\x{4e00}-\x{9fd5}\x{a000}-\x{a48c}\x{a4d0}-\x{a60c}\x{a610}-\x{a62b}\x{a640}-\x{a66e}\x{a680}-\x{a69d}\x{a6a0}-\x{a6ef}\x{a6f2}-\x{a6f7}\x{a722}-\x{a787}\x{a789}-\x{a7ad}\x{a7b0}-\x{a7b7}\x{a7f7}-\x{a801}\x{a803}-\x{a805}\x{a807}-\x{a80a}\x{a80c}-\x{a824}\x{a827}\x{a830}-\x{a837}\x{a840}-\x{a873}\x{a880}-\x{a8c3}\x{a8ce}-\x{a8d9}\x{a8f2}-\x{a8fd}\x{a900}-\x{a925}\x{a92e}-\x{a946}\x{a952}\x{a953}\x{a95f}-\x{a97c}\x{a983}-\x{a9b2}\x{a9b4}\x{a9b5}\x{a9ba}\x{a9bb}\x{a9bd}-\x{a9cd}\x{a9cf}-\x{a9d9}\x{a9de}-\x{a9e4}\x{a9e6}-\x{a9fe}\x{aa00}-\x{aa28}\x{aa2f}\x{aa30}\x{aa33}\x{aa34}\x{aa40}-\x{aa42}\x{aa44}-\x{aa4b}\x{aa4d}\x{aa50}-\x{aa59}\x{aa5c}-\x{aa7b}\x{aa7d}-\x{aaaf}\x{aab1}\x{aab5}\x{aab6}\x{aab9}-\x{aabd}\x{aac0}\x{aac2}\x{aadb}-\x{aaeb}\x{aaee}-\x{aaf5}\x{ab01}-\x{ab06}\x{ab09}-\x{ab0e}\x{ab11}-\x{ab16}\x{ab20}-\x{ab26}\x{ab28}-\x{ab2e}\x{ab30}-\x{ab65}\x{ab70}-\x{abe4}\x{abe6}\x{abe7}\x{abe9}-\x{abec}\x{abf0}-\x{abf9}\x{ac00}-\x{d7a3}\x{d7b0}-\x{d7c6}\x{d7cb}-\x{d7fb}\x{e000}-\x{fa6d}\x{fa70}-\x{fad9}\x{fb00}-\x{fb06}\x{fb13}-\x{fb17}\x{ff21}-\x{ff3a}\x{ff41}-\x{ff5a}\x{ff66}-\x{ffbe}\x{ffc2}-\x{ffc7}\x{ffca}-\x{ffcf}\x{ffd2}-\x{ffd7}\x{ffda}-\x{ffdc}\x{10000}-\x{1000b}\x{1000d}-\x{10026}\x{10028}-\x{1003a}\x{1003c}\x{1003d}\x{1003f}-\x{1004d}\x{10050}-\x{1005d}\x{10080}-\x{100fa}\x{10100}\x{10102}\x{10107}-\x{10133}\x{10137}-\x{1013f}\x{101d0}-\x{101fc}\x{10280}-\x{1029c}\x{102a0}-\x{102d0}\x{10300}-\x{10323}\x{10330}-\x{1034a}\x{10350}-\x{10375}\x{10380}-\x{1039d}\x{1039f}-\x{103c3}\x{103c8}-\x{103d5}\x{10400}-\x{1049d}\x{104a0}-\x{104a9}\x{10500}-\x{10527}\x{10530}-\x{10563}\x{1056f}\x{10600}-\x{10736}\x{10740}-\x{10755}\x{10760}-\x{10767}\x{11000}\x{11002}-\x{11037}\x{11047}-\x{1104d}\x{11066}-\x{1106f}\x{11082}-\x{110b2}\x{110b7}\x{110b8}\x{110bb}-\x{110c1}\x{110d0}-\x{110e8}\x{110f0}-\x{110f9}\x{11103}-\x{11126}\x{1112c}\x{11136}-\x{11143}\x{11150}-\x{11172}\x{11174}-\x{11176}\x{11182}-\x{111b5}\x{111bf}-\x{111c9}\x{111cd}\x{111d0}-\x{111df}\x{111e1}-\x{111f4}\x{11200}-\x{11211}\x{11213}-\x{1122e}\x{11232}\x{11233}\x{11235}\x{11238}-\x{1123d}\x{11280}-\x{11286}\x{11288}\x{1128a}-\x{1128d}\x{1128f}-\x{1129d}\x{1129f}-\x{112a9}\x{112b0}-\x{112de}\x{112e0}-\x{112e2}\x{112f0}-\x{112f9}\x{11302}\x{11303}\x{11305}-\x{1130c}\x{1130f}\x{11310}\x{11313}-\x{11328}\x{1132a}-\x{11330}\x{11332}\x{11333}\x{11335}-\x{11339}\x{1133d}-\x{1133f}\x{11341}-\x{11344}\x{11347}\x{11348}\x{1134b}-\x{1134d}\x{11350}\x{11357}\x{1135d}-\x{11363}\x{11480}-\x{114b2}\x{114b9}\x{114bb}-\x{114be}\x{114c1}\x{114c4}-\x{114c7}\x{114d0}-\x{114d9}\x{11580}-\x{115b1}\x{115b8}-\x{115bb}\x{115be}\x{115c1}-\x{115db}\x{11600}-\x{11632}\x{1163b}\x{1163c}\x{1163e}\x{11641}-\x{11644}\x{11650}-\x{11659}\x{11680}-\x{116aa}\x{116ac}\x{116ae}\x{116af}\x{116b6}\x{116c0}-\x{116c9}\x{11700}-\x{11719}\x{11720}\x{11721}\x{11726}\x{11730}-\x{1173f}\x{118a0}-\x{118f2}\x{118ff}\x{11ac0}-\x{11af8}\x{12000}-\x{12399}\x{12400}-\x{1246e}\x{12470}-\x{12474}\x{12480}-\x{12543}\x{13000}-\x{1342e}\x{14400}-\x{14646}\x{16800}-\x{16a38}\x{16a40}-\x{16a5e}\x{16a60}-\x{16a69}\x{16a6e}\x{16a6f}\x{16ad0}-\x{16aed}\x{16af5}\x{16b00}-\x{16b2f}\x{16b37}-\x{16b45}\x{16b50}-\x{16b59}\x{16b5b}-\x{16b61}\x{16b63}-\x{16b77}\x{16b7d}-\x{16b8f}\x{16f00}-\x{16f44}\x{16f50}-\x{16f7e}\x{16f93}-\x{16f9f}\x{1b000}\x{1b001}\x{1bc00}-\x{1bc6a}\x{1bc70}-\x{1bc7c}\x{1bc80}-\x{1bc88}\x{1bc90}-\x{1bc99}\x{1bc9c}\x{1bc9f}\x{1d000}-\x{1d0f5}\x{1d100}-\x{1d126}\x{1d129}-\x{1d166}\x{1d16a}-\x{1d172}\x{1d183}\x{1d184}\x{1d18c}-\x{1d1a9}\x{1d1ae}-\x{1d1e8}\x{1d360}-\x{1d371}\x{1d400}-\x{1d454}\x{1d456}-\x{1d49c}\x{1d49e}\x{1d49f}\x{1d4a2}\x{1d4a5}\x{1d4a6}\x{1d4a9}-\x{1d4ac}\x{1d4ae}-\x{1d4b9}\x{1d4bb}\x{1d4bd}-\x{1d4c3}\x{1d4c5}-\x{1d505}\x{1d507}-\x{1d50a}\x{1d50d}-\x{1d514}\x{1d516}-\x{1d51c}\x{1d51e}-\x{1d539}\x{1d53b}-\x{1d53e}\x{1d540}-\x{1d544}\x{1d546}\x{1d54a}-\x{1d550}\x{1d552}-\x{1d6a5}\x{1d6a8}-\x{1d6da}\x{1d6dc}-\x{1d714}\x{1d716}-\x{1d74e}\x{1d750}-\x{1d788}\x{1d78a}-\x{1d7c2}\x{1d7c4}-\x{1d7cb}\x{1d800}-\x{1d9ff}\x{1da37}-\x{1da3a}\x{1da6d}-\x{1da74}\x{1da76}-\x{1da83}\x{1da85}-\x{1da8b}\x{1f110}-\x{1f12e}\x{1f130}-\x{1f169}\x{1f170}-\x{1f19a}\x{1f1e6}-\x{1f202}\x{1f210}-\x{1f23a}\x{1f240}-\x{1f248}\x{1f250}\x{1f251}\x{20000}-\x{2a6d6}\x{2a700}-\x{2b734}\x{2b740}-\x{2b81d}\x{2b820}-\x{2cea1}\x{2f800}-\x{2fa1d}\x{f0000}-\x{ffffd}\x{100000}-\x{10fffd}])|([\x{590}\x{5be}\x{5c0}\x{5c3}\x{5c6}\x{5c8}-\x{5ff}\x{7c0}-\x{7ea}\x{7f4}\x{7f5}\x{7fa}-\x{815}\x{81a}\x{824}\x{828}\x{82e}-\x{858}\x{85c}-\x{89f}\x{200f}\x{fb1d}\x{fb1f}-\x{fb28}\x{fb2a}-\x{fb4f}\x{10800}-\x{1091e}\x{10920}-\x{10a00}\x{10a04}\x{10a07}-\x{10a0b}\x{10a10}-\x{10a37}\x{10a3b}-\x{10a3e}\x{10a40}-\x{10ae4}\x{10ae7}-\x{10b38}\x{10b40}-\x{10e5f}\x{10e7f}-\x{10fff}\x{1e800}-\x{1e8cf}\x{1e8d7}-\x{1edff}\x{1ef00}-\x{1efff}\x{608}\x{60b}\x{60d}\x{61b}-\x{64a}\x{66d}-\x{66f}\x{671}-\x{6d5}\x{6e5}\x{6e6}\x{6ee}\x{6ef}\x{6fa}-\x{710}\x{712}-\x{72f}\x{74b}-\x{7a5}\x{7b1}-\x{7bf}\x{8a0}-\x{8e2}\x{fb50}-\x{fd3d}\x{fd40}-\x{fdcf}\x{fdf0}-\x{fdfc}\x{fdfe}\x{fdff}\x{fe70}-\x{fefe}\x{1ee00}-\x{1eeef}\x{1eef2}-\x{1eeff}]))/u';
184 if ( isset( $wgDummyLanguageCodes[
$code] ) ) {
185 $code = $wgDummyLanguageCodes[
$code];
189 $langObj = isset( self::$mLangObjCache[$code] )
190 ? self::$mLangObjCache[
$code]
191 : self::newFromCode( $code );
194 self::$mLangObjCache = array_merge( [ $code => $langObj ], self::$mLangObjCache );
196 self::$mLangObjCache = array_slice( self::$mLangObjCache, 0, $wgLangObjCacheSize,
true );
209 throw new MWException(
"Invalid language code \"$code\"" );
221 $class = self::classFromCode(
$code );
222 if ( class_exists( $class ) ) {
229 foreach ( $fallbacks
as $fallbackCode ) {
231 throw new MWException(
"Invalid fallback '$fallbackCode' in fallback sequence for '$code'" );
234 $class = self::classFromCode( $fallbackCode );
235 if ( class_exists( $class ) ) {
242 throw new MWException(
"Invalid fallback sequence for language '$code'" );
254 if ( !self::isValidBuiltInCode(
$code ) ) {
258 if (
$code ===
'qqq' ) {
262 return is_readable( self::getMessagesFileName(
$code ) ) ||
263 is_readable( self::getJsonMessagesFileName(
$code ) );
284 $alphanum =
'[a-z0-9]';
285 $x =
'x'; #
private use singleton
286 $singleton =
'[a-wy-z]'; #
other singleton
287 $s = $lenient ?
'[-_]' :
'-';
289 $language =
"$alpha{2,8}|$alpha{2,3}$s$alpha{3}";
290 $script =
"$alpha{4}"; # ISO 15924
291 $region =
"(?:$alpha{2}|$digit{3})"; # ISO 3166-1 alpha-2
or UN M.49
292 $variant =
"(?:$alphanum{5,8}|$digit$alphanum{3})";
293 $extension =
"$singleton(?:$s$alphanum{2,8})+";
294 $privateUse =
"$x(?:$s$alphanum{1,8})+";
296 # Define certain grandfathered codes, since otherwise the regex is pretty useless.
297 # Since these are limited, this is safe even later changes to the registry --
298 # the only oddity is that it might change the type of the tag, and thus
299 # the results from the capturing groups.
300 # https://www.iana.org/assignments/language-subtag-registry
302 $grandfathered =
"en{$s}GB{$s}oed"
303 .
"|i{$s}(?:ami|bnn|default|enochian|hak|klingon|lux|mingo|navajo|pwn|tao|tay|tsu)"
304 .
"|no{$s}(?:bok|nyn)"
305 .
"|sgn{$s}(?:BE{$s}(?:fr|nl)|CH{$s}de)"
306 .
"|zh{$s}min{$s}nan";
308 $variantList =
"$variant(?:$s$variant)*";
309 $extensionList =
"$extension(?:$s$extension)*";
311 $langtag =
"(?:($language)"
314 .
"(?:$s$variantList)?"
315 .
"(?:$s$extensionList)?"
316 .
"(?:$s$privateUse)?)";
318 # The final breakdown, with capturing groups for each of these components
319 # The variants, extensions, grandfathered, and private-use may have interior '-'
321 $root =
"^(?:$langtag|$privateUse|$grandfathered)$";
323 return (
bool)preg_match(
"/$root/", strtolower(
$code ) );
344 strcspn( $code,
":/\\\000&<>'\"" ) === strlen( $code )
362 if ( !is_string(
$code ) ) {
363 if ( is_object(
$code ) ) {
364 $addmsg =
" of class " . get_class(
$code );
369 throw new MWException( __METHOD__ .
" must be passed a string, $type given$addmsg" );
372 return (
bool)preg_match(
'/^[a-z0-9-]{2,}$/',
$code );
386 if ( !self::isValidBuiltInCode(
$tag ) ) {
391 || self::fetchLanguageName( $tag, $tag ) !==
''
405 if ( is_null( self::$dataCache ) ) {
407 $class = $wgLocalisationCacheConf[
'class'];
408 self::$dataCache =
new $class( $wgLocalisationCacheConf );
410 return self::$dataCache;
416 if ( get_class( $this ) ==
'Language' ) {
419 $this->mCode = str_replace(
'_',
'-', strtolower( substr( get_class( $this ), 8 ) ) );
421 self::getLocalisationCache();
429 unset( $this->
$name );
445 return self::getFallbacksFor( $this->mCode );
453 return self::$dataCache->getItem( $this->mCode,
'bookstoreList' );
463 if ( is_null( $this->namespaceNames ) ) {
466 $this->namespaceNames = self::$dataCache->getItem( $this->mCode,
'namespaceNames' );
469 $this->namespaceNames = $wgExtraNamespaces + $this->namespaceNames + $validNamespaces;
472 if ( $wgMetaNamespaceTalk ) {
480 # Sometimes a language will be localised but not actually exist on this wiki.
481 foreach ( $this->namespaceNames
as $key => $text ) {
482 if ( !isset( $validNamespaces[$key] ) ) {
483 unset( $this->namespaceNames[$key] );
487 # The above mixing may leave namespaces out of canonical order.
488 # Re-order by namespace ID number...
489 ksort( $this->namespaceNames );
491 Hooks::run(
'LanguageGetNamespaces', [ &$this->namespaceNames ] );
503 $this->mNamespaceIds = null;
510 $this->namespaceNames = null;
511 $this->mNamespaceIds = null;
512 $this->namespaceAliases = null;
523 foreach ( $ns
as $k => $v ) {
524 $ns[$k] = strtr( $v,
'_',
' ' );
542 return isset( $ns[$index] ) ? $ns[$index] :
false;
560 return strtr( $ns,
'_',
' ' );
574 $ns = $wgExtraGenderNamespaces +
575 (
array)self::$dataCache->getItem( $this->mCode,
'namespaceGenderAliases' );
577 return isset( $ns[$index][$gender] ) ? $ns[$index][$gender] : $this->
getNsText( $index );
588 if ( count( $wgExtraGenderNamespaces ) > 0 ) {
591 } elseif ( isset( $wgExtraNamespaces[
NS_USER] ) && isset( $wgExtraNamespaces[
NS_USER_TALK] ) ) {
597 $aliases = self::$dataCache->getItem( $this->mCode,
'namespaceGenderAliases' );
598 return count( $aliases ) > 0;
611 $lctext = $this->
lc( $text );
613 return isset( $ids[$lctext] ) ? $ids[$lctext] :
false;
620 if ( is_null( $this->namespaceAliases ) ) {
621 $aliases = self::$dataCache->getItem( $this->mCode,
'namespaceAliases' );
625 foreach ( $aliases
as $name => $index ) {
627 unset( $aliases[
$name] );
629 $aliases[
$name] = $index;
635 $genders = $wgExtraGenderNamespaces +
636 (
array)self::$dataCache->getItem( $this->mCode,
'namespaceGenderAliases' );
637 foreach ( $genders
as $index => $forms ) {
638 foreach ( $forms
as $alias ) {
639 $aliases[$alias] = $index;
643 # Also add converted namespace names as aliases, to avoid confusion.
644 $convertedNames = [];
646 if ( $variant === $this->mCode ) {
650 $convertedNames[$this->
getConverter()->convertNamespace( $ns, $variant )] = $ns;
654 $this->namespaceAliases = $aliases + $convertedNames;
664 if ( is_null( $this->mNamespaceIds ) ) {
666 # Put namespace names and aliases into a hashtable.
667 # If this is too slow, then we should arrange it so that it is done
668 # before caching. The catch is that at pre-cache time, the above
669 # class-specific fixup hasn't been done.
670 $this->mNamespaceIds = [];
672 $this->mNamespaceIds[$this->
lc(
$name )] = $index;
675 $this->mNamespaceIds[$this->
lc(
$name )] = $index;
677 if ( $wgNamespaceAliases ) {
678 foreach ( $wgNamespaceAliases
as $name => $index ) {
679 $this->mNamespaceIds[$this->
lc(
$name )] = $index;
694 $lctext = $this->
lc( $text );
696 if ( $ns !== null ) {
700 return isset( $ids[$lctext] ) ? $ids[$lctext] :
false;
711 $msg =
"variantname-$code";
712 if ( $usemsg &&
wfMessage( $msg )->exists() ) {
717 return $name; #
if it's defined as a language name, show that
719 # otherwise, output the language code
727 public function getDatePreferences() {
728 return self::$dataCache->getItem( $this->mCode, 'datePreferences
' );
734 function getDateFormats() {
735 return self::$dataCache->getItem( $this->mCode, 'dateFormats
' );
741 public function getDefaultDateFormat() {
742 $df = self::$dataCache->getItem( $this->mCode, 'defaultDateFormat
' );
743 if ( $df === 'dmy
or mdy
' ) {
744 global $wgAmericanDates;
745 return $wgAmericanDates ? 'mdy
' : 'dmy
';
754 public function getDatePreferenceMigrationMap() {
755 return self::$dataCache->getItem( $this->mCode, 'datePreferenceMigrationMap
' );
762 function getImageFile( $image ) {
763 return self::$dataCache->getSubitem( $this->mCode, 'imageFiles
', $image );
770 public function getImageFiles() {
771 return self::$dataCache->getItem( $this->mCode, 'imageFiles
' );
777 public function getExtraUserToggles() {
778 return (array)self::$dataCache->getItem( $this->mCode, 'extraUserToggles
' );
785 function getUserToggle( $tog ) {
786 return $this->getMessageFromDB( "tog-$tog" );
800 public static function fetchLanguageNames( $inLanguage = null, $include = 'mw
' ) {
801 $cacheKey = $inLanguage === null ? 'null
' : $inLanguage;
802 $cacheKey .= ":$include";
803 if ( self::$languageNameCache === null ) {
804 self::$languageNameCache = new HashBagOStuff( [ 'maxKeys
' => 20 ] );
807 $ret = self::$languageNameCache->get( $cacheKey );
809 $ret = self::fetchLanguageNamesUncached( $inLanguage, $include );
810 self::$languageNameCache->set( $cacheKey, $ret );
825 private static function fetchLanguageNamesUncached( $inLanguage = null, $include = 'mw
' ) {
826 global $wgExtraLanguageNames;
828 // If passed an invalid language code to use, fallback to en
829 if ( $inLanguage !== null && !Language::isValidCode( $inLanguage ) ) {
836 # TODO: also include when $inLanguage is null, when this code is more efficient
837 Hooks::run( 'LanguageGetTranslatedLanguageNames
', [ &$names, $inLanguage ] );
840 $mwNames = $wgExtraLanguageNames + MediaWiki\Languages\Data\Names::$names;
841 foreach ( $mwNames as $mwCode => $mwName ) {
842 # - Prefer own MediaWiki native name when not using the hook
843 # - For other names just add if not added through the hook
844 if ( $mwCode === $inLanguage || !isset( $names[$mwCode] ) ) {
845 $names[$mwCode] = $mwName;
849 if ( $include === 'all
' ) {
855 $coreCodes = array_keys( $mwNames );
856 foreach ( $coreCodes as $coreCode ) {
857 $returnMw[$coreCode] = $names[$coreCode];
860 if ( $include === 'mwfile
' ) {
862 # We do this using a foreach over the codes instead of a directory
863 # loop so that messages files in extensions will work correctly.
864 foreach ( $returnMw as $code => $value ) {
865 if ( is_readable( self::getMessagesFileName( $code ) )
866 || is_readable( self::getJsonMessagesFileName( $code ) )
868 $namesMwFile[$code] = $names[$code];
872 ksort( $namesMwFile );
889 $code = strtolower( $code );
890 $array = self::fetchLanguageNames( $inLanguage, $include );
891 return !array_key_exists( $code, $array ) ?
'' : $array[
$code];
901 return $this->
msg( $msg )->text();
910 protected function msg( $msg ) {
911 return wfMessage( $msg )->inLanguage( $this );
926 $monthNames = [
'' ];
927 for ( $i = 1; $i < 13; $i++ ) {
953 $monthNames = [
'' ];
954 for ( $i = 1; $i < 13; $i++ ) {
981 return $this->
getMessageFromDB( self::$mIranianCalendarMonthMsgs[$key - 1] );
989 return $this->
getMessageFromDB( self::$mHebrewCalendarMonthMsgs[$key - 1] );
997 return $this->
getMessageFromDB( self::$mHebrewCalendarMonthGenMsgs[$key - 1] );
1005 return $this->
getMessageFromDB( self::$mHijriCalendarMonthMsgs[$key - 1] );
1017 if ( !$dateTimeObj ) {
1018 $dateTimeObj = DateTime::createFromFormat(
1022 return $dateTimeObj->format(
$code );
1099 $dateTimeObj =
false;
1108 $usedSecond =
false;
1109 $usedMinute =
false;
1116 $usedISOYear =
false;
1117 $usedIsLeapYear =
false;
1119 $usedHebrewMonth =
false;
1120 $usedIranianMonth =
false;
1121 $usedHijriMonth =
false;
1122 $usedHebrewYear =
false;
1123 $usedIranianYear =
false;
1124 $usedHijriYear =
false;
1125 $usedTennoYear =
false;
1127 if ( strlen( $ts ) !== 14 ) {
1128 throw new MWException( __METHOD__ .
": The timestamp $ts should have 14 characters" );
1131 if ( !ctype_digit( $ts ) ) {
1132 throw new MWException( __METHOD__ .
": The timestamp $ts should be a number" );
1135 $formatLength = strlen( $format );
1136 for ( $p = 0; $p < $formatLength; $p++ ) {
1138 $code = $format[$p];
1139 if (
$code ==
'x' && $p < $formatLength - 1 ) {
1140 $code .= $format[++$p];
1143 if ( (
$code ===
'xi'
1149 && $p < $formatLength - 1 ) {
1150 $code .= $format[++$p];
1161 $rawToggle = !$rawToggle;
1174 $usedHebrewMonth =
true;
1176 $hebrew = self::tsToHebrew( $ts );
1182 $num = substr( $ts, 6, 2 );
1192 $num = intval( substr( $ts, 6, 2 ) );
1197 $iranian = self::tsToIranian( $ts );
1204 $hijri = self::tsToHijri( $ts );
1211 $hebrew = self::tsToHebrew( $ts );
1226 $usedIranianMonth =
true;
1228 $iranian = self::tsToIranian( $ts );
1233 $usedHijriMonth =
true;
1235 $hijri = self::tsToHijri( $ts );
1240 $usedHebrewMonth =
true;
1242 $hebrew = self::tsToHebrew( $ts );
1248 $num = substr( $ts, 4, 2 );
1256 $num = intval( substr( $ts, 4, 2 ) );
1259 $usedIranianMonth =
true;
1261 $iranian = self::tsToIranian( $ts );
1266 $usedHijriMonth =
true;
1268 $hijri = self::tsToHijri( $ts );
1273 $usedHebrewMonth =
true;
1275 $hebrew = self::tsToHebrew( $ts );
1280 $usedHebrewMonth =
true;
1282 $hebrew = self::tsToHebrew( $ts );
1288 $num = substr( $ts, 0, 4 );
1291 $usedIranianYear =
true;
1293 $iranian = self::tsToIranian( $ts );
1298 $usedHijriYear =
true;
1300 $hijri = self::tsToHijri( $ts );
1305 $usedHebrewYear =
true;
1307 $hebrew = self::tsToHebrew( $ts );
1314 $thai = self::tsToYear( $ts,
'thai' );
1321 $minguo = self::tsToYear( $ts,
'minguo' );
1326 $usedTennoYear =
true;
1328 $tenno = self::tsToYear( $ts,
'tenno' );
1334 $num = substr( $ts, 2, 2 );
1337 $usedIranianYear =
true;
1339 $iranian = self::tsToIranian( $ts );
1341 $num = substr( $iranian[0], -2 );
1344 $usedIranianYear =
true;
1346 $iranian = self::tsToIranian( $ts );
1348 $num = self::$IRANIAN_DAYS[$iranian[1] - 1];
1351 $usedIranianYear =
true;
1353 $iranian = self::tsToIranian( $ts );
1359 $s .= intval( substr( $ts, 8, 2 ) ) < 12 ?
'am' :
'pm';
1363 $s .= intval( substr( $ts, 8, 2 ) ) < 12 ?
'AM' :
'PM';
1367 $h = substr( $ts, 8, 2 );
1368 $num = $h % 12 ? $h % 12 : 12;
1372 $num = intval( substr( $ts, 8, 2 ) );
1376 $h = substr( $ts, 8, 2 );
1377 $num = sprintf(
'%02d', $h % 12 ? $h % 12 : 12 );
1381 $num = substr( $ts, 8, 2 );
1385 $num = substr( $ts, 10, 2 );
1389 $num = substr( $ts, 12, 2 );
1416 $usedIsLeapYear =
true;
1420 $usedISOYear =
true;
1431 # Backslash escaping
1432 if ( $p < $formatLength - 1 ) {
1433 $s .= $format[++$p];
1440 if ( $p < $formatLength - 1 ) {
1441 $endQuote = strpos( $format,
'"', $p + 1 );
1442 if ( $endQuote ===
false ) {
1443 # No terminating quote, assume literal "
1446 $s .= substr( $format, $p + 1, $endQuote - $p - 1 );
1450 # Quote at end of string, assume literal "
1457 if ( $num !==
false ) {
1458 if ( $rawToggle || $raw ) {
1461 } elseif ( $roman ) {
1464 } elseif ( $hebrewNum ) {
1465 $s .= self::hebrewNumeral( $num );
1473 if ( $ttl ===
'unused' ) {
1475 } elseif ( $usedSecond ) {
1477 } elseif ( $usedMinute ) {
1478 $ttl = 60 - substr( $ts, 12, 2 );
1479 } elseif ( $usedHour ) {
1480 $ttl = 3600 - substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1481 } elseif ( $usedAMPM ) {
1482 $ttl = 43200 - ( substr( $ts, 8, 2 ) % 12 ) * 3600 -
1483 substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1487 $usedIranianMonth ||
1496 $ttl = 86400 - substr( $ts, 8, 2 ) * 3600 -
1497 substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1500 $timeRemainingInDay = 86400 - substr( $ts, 8, 2 ) * 3600 -
1501 substr( $ts, 10, 2 ) * 60 - substr( $ts, 12, 2 );
1505 $timeRemainingInDay;
1506 } elseif ( $usedISOYear ) {
1509 $lastWeekOfISOYear = DateTime::createFromFormat(
1511 substr( $ts, 0, 4 ) .
'1228',
1515 $weeksRemaining = $lastWeekOfISOYear - $currentISOWeek;
1516 $timeRemainingInWeek =
1518 + $timeRemainingInDay;
1519 $possibleTtls[] = $weeksRemaining * 604800 + $timeRemainingInWeek;
1525 substr( $ts, 6, 2 ) ) * 86400
1526 + $timeRemainingInDay;
1527 } elseif ( $usedYear ) {
1531 + $timeRemainingInDay;
1532 } elseif ( $usedIsLeapYear ) {
1533 $year = substr( $ts, 0, 4 );
1534 $timeRemainingInYear =
1537 + $timeRemainingInDay;
1539 if ( $mod || ( !( $year % 100 ) && $year % 400 ) ) {
1541 $nextCandidate = $year - $mod + 4;
1542 if ( $nextCandidate % 100 || !( $nextCandidate % 400 ) ) {
1543 $possibleTtls[] = ( $nextCandidate - $year - 1 ) * 365 * 86400 +
1544 $timeRemainingInYear;
1546 $possibleTtls[] = ( $nextCandidate - $year + 3 ) * 365 * 86400 +
1547 $timeRemainingInYear;
1551 $possibleTtls[] = $timeRemainingInYear;
1555 if ( $possibleTtls ) {
1556 $ttl = min( $possibleTtls );
1563 private static $GREG_DAYS = [ 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 ];
1564 private static $IRANIAN_DAYS = [ 31, 31, 31, 31, 31, 31, 30, 30, 30, 30, 30, 29 ];
1579 $gy = substr( $ts, 0, 4 ) -1600;
1580 $gm = substr( $ts, 4, 2 ) -1;
1581 $gd = substr( $ts, 6, 2 ) -1;
1583 # Days passed from the beginning (including leap years)
1585 + floor( ( $gy + 3 ) / 4 )
1586 - floor( ( $gy + 99 ) / 100 )
1587 + floor( ( $gy + 399 ) / 400 );
1590 for ( $i = 0; $i < $gm; $i++ ) {
1591 $gDayNo += self::$GREG_DAYS[$i];
1595 if ( $gm > 1 && ( ( $gy % 4 === 0 && $gy % 100 !== 0 || ( $gy % 400 == 0 ) ) ) ) {
1600 $gDayNo += (int)$gd;
1602 $jDayNo = $gDayNo - 79;
1604 $jNp = floor( $jDayNo / 12053 );
1607 $jy = 979 + 33 * $jNp + 4 * floor( $jDayNo / 1461 );
1610 if ( $jDayNo >= 366 ) {
1611 $jy += floor( ( $jDayNo - 1 ) / 365 );
1612 $jDayNo = floor( ( $jDayNo - 1 ) % 365 );
1617 for ( $i = 0; $i < 11 && $jDayNo >= self::$IRANIAN_DAYS[$i]; $i++ ) {
1618 $jDayNo -= self::$IRANIAN_DAYS[$i];
1624 return [ $jy, $jm, $jd, $jz ];
1639 $year = substr( $ts, 0, 4 );
1640 $month = substr( $ts, 4, 2 );
1641 $day = substr( $ts, 6, 2 );
1649 ( $zy > 1582 ) || ( ( $zy == 1582 ) && ( $zm > 10 ) ) ||
1650 ( ( $zy == 1582 ) && ( $zm == 10 ) && ( $zd > 14 ) )
1652 $zjd = (int)( ( 1461 * ( $zy + 4800 + (
int)( ( $zm - 14 ) / 12 ) ) ) / 4 ) +
1653 (
int)( ( 367 * ( $zm - 2 - 12 * ( (int)( ( $zm - 14 ) / 12 ) ) ) ) / 12 ) -
1654 (
int)( ( 3 * (int)( ( ( $zy + 4900 + (
int)( ( $zm - 14 ) / 12 ) ) / 100 ) ) ) / 4 ) +
1657 $zjd = 367 * $zy - (int)( ( 7 * ( $zy + 5001 + (
int)( ( $zm - 9 ) / 7 ) ) ) / 4 ) +
1658 (
int)( ( 275 * $zm ) / 9 ) + $zd + 1729777;
1661 $zl = $zjd -1948440 + 10632;
1662 $zn = (int)( ( $zl - 1 ) / 10631 );
1663 $zl = $zl - 10631 * $zn + 354;
1664 $zj = ( (int)( ( 10985 - $zl ) / 5316 ) ) * ( (int)( ( 50 * $zl ) / 17719 ) ) +
1665 ( (int)( $zl / 5670 ) ) * ( (
int)( ( 43 * $zl ) / 15238 ) );
1666 $zl = $zl - ( (int)( ( 30 - $zj ) / 15 ) ) * ( (int)( ( 17719 * $zj ) / 50 ) ) -
1667 ( (int)( $zj / 16 ) ) * ( (
int)( ( 15238 * $zj ) / 43 ) ) + 29;
1668 $zm = (int)( ( 24 * $zl ) / 709 );
1669 $zd = $zl - (int)( ( 709 * $zm ) / 24 );
1670 $zy = 30 * $zn + $zj - 30;
1672 return [ $zy, $zm, $zd ];
1692 $year = substr( $ts, 0, 4 );
1693 $month = substr( $ts, 4, 2 );
1694 $day = substr( $ts, 6, 2 );
1696 # Calculate Hebrew year
1697 $hebrewYear = $year + 3760;
1699 # Month number when September = 1, August = 12
1701 if ( $month > 12 ) {
1708 # Calculate day of year from 1 September
1710 for ( $i = 1; $i < $month; $i++ ) {
1714 # Check if the year is leap
1715 if ( $year % 400 == 0 || ( $year % 4 == 0 && $year % 100 > 0 ) ) {
1718 } elseif ( $i == 8 || $i == 10 || $i == 1 || $i == 3 ) {
1725 # Calculate the start of the Hebrew year
1726 $start = self::hebrewYearStart( $hebrewYear );
1728 # Calculate next year's start
1729 if ( $dayOfYear <= $start ) {
1730 # Day is before the start of the year - it is the previous year
1732 $nextStart = $start;
1736 # Add days since previous year's 1 September
1738 if ( ( $year % 400 == 0 ) || ( $year % 100 != 0 && $year % 4 == 0 ) ) {
1742 # Start of the new (previous) year
1743 $start = self::hebrewYearStart( $hebrewYear );
1746 $nextStart = self::hebrewYearStart( $hebrewYear + 1 );
1749 # Calculate Hebrew day of year
1750 $hebrewDayOfYear = $dayOfYear - $start;
1752 # Difference between year's days
1753 $diff = $nextStart - $start;
1754 # Add 12 (or 13 for leap years) days to ignore the difference between
1755 # Hebrew and Gregorian year (353 at least vs. 365/6) - now the
1756 # difference is only about the year type
1757 if ( ( $year % 400 == 0 ) || ( $year % 100 != 0 && $year % 4 == 0 ) ) {
1763 # Check the year pattern, and is leap year
1764 # 0 means an incomplete year, 1 means a regular year, 2 means a complete year
1765 # This is mod 30, to work on both leap years (which add 30 days of Adar I)
1766 # and non-leap years
1767 $yearPattern = $diff % 30;
1768 # Check if leap year
1769 $isLeap = $diff >= 30;
1771 # Calculate day in the month from number of day in the Hebrew year
1772 # Don't check Adar - if the day is not in Adar, we will stop before;
1773 # if it is in Adar, we will use it to check if it is Adar I or Adar II
1774 $hebrewDay = $hebrewDayOfYear;
1777 while ( $hebrewMonth <= 12 ) {
1778 # Calculate days in this month
1779 if ( $isLeap && $hebrewMonth == 6 ) {
1780 # Adar in a leap year
1782 # Leap year - has Adar I, with 30 days, and Adar II, with 29 days
1784 if ( $hebrewDay <= $days ) {
1788 # Subtract the days of Adar I
1789 $hebrewDay -= $days;
1792 if ( $hebrewDay <= $days ) {
1798 } elseif ( $hebrewMonth == 2 && $yearPattern == 2 ) {
1799 # Cheshvan in a complete year (otherwise as the rule below)
1801 } elseif ( $hebrewMonth == 3 && $yearPattern == 0 ) {
1802 # Kislev in an incomplete year (otherwise as the rule below)
1805 # Odd months have 30 days, even have 29
1806 $days = 30 - ( $hebrewMonth - 1 ) % 2;
1808 if ( $hebrewDay <= $days ) {
1809 # In the current month
1812 # Subtract the days of the current month
1813 $hebrewDay -= $days;
1814 # Try in the next month
1819 return [ $hebrewYear, $hebrewMonth, $hebrewDay, $days ];
1832 $a = intval( ( 12 * ( $year - 1 ) + 17 ) % 19 );
1833 $b = intval( ( $year - 1 ) % 4 );
1834 $m = 32.044093161144 + 1.5542417966212 * $a + $b / 4.0 - 0.0031777940220923 * ( $year - 1 );
1838 $Mar = intval( $m );
1844 $c = intval( ( $Mar + 3 * ( $year - 1 ) + 5 * $b + 5 ) % 7 );
1845 if ( $c == 0 && $a > 11 && $m >= 0.89772376543210 ) {
1847 } elseif ( $c == 1 && $a > 6 && $m >= 0.63287037037037 ) {
1849 } elseif ( $c == 2 || $c == 4 || $c == 6 ) {
1853 $Mar += intval( ( $year - 3761 ) / 100 ) - intval( ( $year - 3761 ) / 400 ) - 24;
1870 $gy = substr( $ts, 0, 4 );
1871 $gm = substr( $ts, 4, 2 );
1872 $gd = substr( $ts, 6, 2 );
1874 if ( !strcmp( $cName,
'thai' ) ) {
1876 # Add 543 years to the Gregorian calendar
1877 # Months and days are identical
1878 $gy_offset = $gy + 543;
1879 } elseif ( ( !strcmp( $cName,
'minguo' ) ) || !strcmp( $cName,
'juche' ) ) {
1881 # Deduct 1911 years from the Gregorian calendar
1882 # Months and days are identical
1883 $gy_offset = $gy - 1911;
1884 } elseif ( !strcmp( $cName,
'tenno' ) ) {
1885 # Nengō dates up to Meiji period
1886 # Deduct years from the Gregorian calendar
1887 # depending on the nengo periods
1888 # Months and days are identical
1890 || ( ( $gy == 1912 ) && ( $gm < 7 ) )
1891 || ( ( $gy == 1912 ) && ( $gm == 7 ) && ( $gd < 31 ) )
1894 $gy_gannen = $gy - 1868 + 1;
1895 $gy_offset = $gy_gannen;
1896 if ( $gy_gannen == 1 ) {
1899 $gy_offset =
'明治' . $gy_offset;
1901 ( ( $gy == 1912 ) && ( $gm == 7 ) && ( $gd == 31 ) ) ||
1902 ( ( $gy == 1912 ) && ( $gm >= 8 ) ) ||
1903 ( ( $gy > 1912 ) && ( $gy < 1926 ) ) ||
1904 ( ( $gy == 1926 ) && ( $gm < 12 ) ) ||
1905 ( ( $gy == 1926 ) && ( $gm == 12 ) && ( $gd < 26 ) )
1908 $gy_gannen = $gy - 1912 + 1;
1909 $gy_offset = $gy_gannen;
1910 if ( $gy_gannen == 1 ) {
1913 $gy_offset =
'大正' . $gy_offset;
1915 ( ( $gy == 1926 ) && ( $gm == 12 ) && ( $gd >= 26 ) ) ||
1916 ( ( $gy > 1926 ) && ( $gy < 1989 ) ) ||
1917 ( ( $gy == 1989 ) && ( $gm == 1 ) && ( $gd < 8 ) )
1920 $gy_gannen = $gy - 1926 + 1;
1921 $gy_offset = $gy_gannen;
1922 if ( $gy_gannen == 1 ) {
1925 $gy_offset =
'昭和' . $gy_offset;
1928 $gy_gannen = $gy - 1989 + 1;
1929 $gy_offset = $gy_gannen;
1930 if ( $gy_gannen == 1 ) {
1933 $gy_offset =
'平成' . $gy_offset;
1939 return [ $gy_offset, $gm, $gd ];
1956 if ( !preg_match( self::$strongDirRegex, $text,
$matches ) ) {
1974 [
'',
'I',
'II',
'III',
'IV',
'V',
'VI',
'VII',
'VIII',
'IX',
'X' ],
1975 [
'',
'X',
'XX',
'XXX',
'XL',
'L',
'LX',
'LXX',
'LXXX',
'XC',
'C' ],
1976 [
'',
'C',
'CC',
'CCC',
'CD',
'D',
'DC',
'DCC',
'DCCC',
'CM',
'M' ],
1977 [
'',
'M',
'MM',
'MMM',
'MMMM',
'MMMMM',
'MMMMMM',
'MMMMMMM',
1978 'MMMMMMMM',
'MMMMMMMMM',
'MMMMMMMMMM' ]
1981 $num = intval( $num );
1982 if ( $num > 10000 || $num <= 0 ) {
1987 for ( $pow10 = 1000, $i = 3; $i >= 0; $pow10 /= 10, $i-- ) {
1988 if ( $num >= $pow10 ) {
1989 $s .= $table[$i][(int)floor( $num / $pow10 )];
1991 $num = $num % $pow10;
2005 [
'',
'א',
'ב',
'ג',
'ד',
'ה',
'ו',
'ז',
'ח',
'ט',
'י' ],
2006 [
'',
'י',
'כ',
'ל',
'מ',
'נ',
'ס',
'ע',
'פ',
'צ',
'ק' ],
2019 [
'',
'א',
'ב',
'ג',
'ד',
'ה',
'ו',
'ז',
'ח',
'ט',
'י' ]
2022 $num = intval( $num );
2023 if ( $num > 9999 || $num <= 0 ) {
2028 if ( $num === 1000 ) {
2030 } elseif ( $num % 1000 === 0 ) {
2031 return $table[0][$num / 1000] .
"' אלפים";
2036 for ( $pow10 = 1000, $i = 3; $i >= 0; $pow10 /= 10, $i-- ) {
2037 if ( $num >= $pow10 ) {
2038 if ( $num === 15 || $num === 16 ) {
2039 $letters[] = $table[0][9];
2040 $letters[] = $table[0][$num - 9];
2043 $letters = array_merge(
2045 (
array)$table[$i][intval( $num / $pow10 )]
2048 if ( $pow10 === 1000 ) {
2054 $num = $num % $pow10;
2057 $preTransformLength = count( $letters );
2058 if ( $preTransformLength === 1 ) {
2062 $lastIndex = $preTransformLength - 1;
2063 $letters[$lastIndex] = str_replace(
2064 [
'כ',
'מ',
'נ',
'פ',
'צ' ],
2065 [
'ך',
'ם',
'ן',
'ף',
'ץ' ],
2066 $letters[$lastIndex]
2072 if ( $letters[1] ===
"'" && $preTransformLength === 3 ) {
2075 array_splice( $letters, -1, 0,
'"' );
2079 return implode( $letters );
2093 if ( $tz ===
false ) {
2094 $tz = $wgUser->getOption(
'timecorrection' );
2097 $data = explode(
'|', $tz, 3 );
2099 if ( $data[0] ==
'ZoneInfo' ) {
2100 MediaWiki\suppressWarnings();
2101 $userTZ = timezone_open( $data[2] );
2102 MediaWiki\restoreWarnings();
2103 if ( $userTZ !==
false ) {
2104 $date = date_create( $ts, timezone_open(
'UTC' ) );
2105 date_timezone_set( $date, $userTZ );
2106 $date = date_format( $date,
'YmdHis' );
2109 # Unrecognized timezone, default to 'Offset' with the stored offset.
2110 $data[0] =
'Offset';
2113 if ( $data[0] ==
'System' || $tz ==
'' ) {
2114 # Global offset in minutes.
2116 } elseif ( $data[0] ==
'Offset' ) {
2117 $minDiff = intval( $data[1] );
2119 $data = explode(
':', $tz );
2120 if ( count( $data ) == 2 ) {
2121 $data[0] = intval( $data[0] );
2122 $data[1] = intval( $data[1] );
2123 $minDiff = abs( $data[0] ) * 60 + $data[1];
2124 if ( $data[0] < 0 ) {
2125 $minDiff = -$minDiff;
2128 $minDiff = intval( $data[0] ) * 60;
2132 # No difference ? Return time unchanged
2133 if ( 0 == $minDiff ) {
2137 MediaWiki\suppressWarnings();
2138 # Generate an adjusted date; take advantage of the fact that mktime
2139 # will normalize out-of-range values so we don't have to split $minDiff
2140 # into hours and minutes.
2142 (
int)substr( $ts, 8, 2 ) ), # Hours
2143 (
int)substr( $ts, 10, 2 ) + $minDiff, # Minutes
2144 (
int)substr( $ts, 12, 2 ), # Seconds
2145 (
int)substr( $ts, 4, 2 ), # Month
2146 (
int)substr( $ts, 6, 2 ), # Day
2147 (
int)substr( $ts, 0, 4 ) ); # Year
2149 $date =
date(
'YmdHis',
$t );
2150 MediaWiki\restoreWarnings();
2175 if ( is_bool( $usePrefs ) ) {
2177 $datePreference = $wgUser->getDatePreference();
2182 $datePreference = (
string)$usePrefs;
2186 if ( $datePreference ==
'' ) {
2190 return $datePreference;
2204 $wasDefault =
false;
2205 if ( $pref ==
'default' ) {
2210 if ( !isset( $this->dateFormatStrings[
$type][$pref] ) ) {
2211 $df = self::$dataCache->getSubitem( $this->mCode,
'dateFormats',
"$pref $type" );
2213 if (
$type ===
'pretty' && $df === null ) {
2217 if ( !$wasDefault && $df === null ) {
2219 $df = self::$dataCache->getSubitem( $this->mCode,
'dateFormats',
"$pref $type" );
2222 $this->dateFormatStrings[
$type][$pref] = $df;
2224 return $this->dateFormatStrings[
$type][$pref];
2237 public function date( $ts, $adj =
false, $format =
true, $timecorrection =
false ) {
2240 $ts = $this->
userAdjust( $ts, $timecorrection );
2256 public function time( $ts, $adj =
false, $format =
true, $timecorrection =
false ) {
2259 $ts = $this->
userAdjust( $ts, $timecorrection );
2276 public function timeanddate( $ts, $adj =
false, $format =
true, $timecorrection =
false ) {
2279 $ts = $this->
userAdjust( $ts, $timecorrection );
2300 foreach ( $intervals
as $intervalName => $intervalValue ) {
2303 $message =
wfMessage(
'duration-' . $intervalName )->numParams( $intervalValue );
2304 $segments[] = $message->inLanguage( $this )->escaped();
2322 if ( empty( $chosenIntervals ) ) {
2323 $chosenIntervals = [
2335 $intervals = array_intersect_key( self::$durationIntervals, array_flip( $chosenIntervals ) );
2336 $sortedNames = array_keys( $intervals );
2337 $smallestInterval = array_pop( $sortedNames );
2341 foreach ( $intervals
as $name => $length ) {
2342 $value = floor( $seconds / $length );
2344 if (
$value > 0 || (
$name == $smallestInterval && empty( $segments ) ) ) {
2345 $seconds -=
$value * $length;
2374 $options += [
'timecorrection' =>
true,
'format' =>
true ];
2375 if ( $options[
'timecorrection'] !==
false ) {
2376 if ( $options[
'timecorrection'] ===
true ) {
2377 $offset = $user->
getOption(
'timecorrection' );
2379 $offset = $options[
'timecorrection'];
2383 if ( $options[
'format'] ===
true ) {
2386 $format = $options[
'format'];
2479 if ( $relativeTo === null ) {
2482 if (
$user === null ) {
2488 $offsetRel = $relativeTo->offsetForUser(
$user );
2491 if (
Hooks::run(
'GetHumanTimestamp', [ &$ts, $time, $relativeTo,
$user, $this ] ) ) {
2496 $time->timestamp->sub( $offsetThis );
2497 $relativeTo->timestamp->sub( $offsetRel );
2516 $diff = $ts->
diff( $relativeTo );
2517 $diffDay = (bool)( (
int)$ts->timestamp->
format(
'w' ) -
2518 (int)$relativeTo->timestamp->
format(
'w' ) );
2519 $days = $diff->days ?: (int)$diffDay;
2520 if ( $diff->invert || $days > 5
2521 && $ts->timestamp->
format(
'Y' ) !== $relativeTo->timestamp->
format(
'Y' )
2530 } elseif ( $days > 5 ) {
2534 } elseif ( $days > 1 ) {
2537 $weekday = self::$mWeekdayMsgs[$ts->timestamp->
format(
'w' )];
2541 ->inLanguage( $this )
2544 } elseif ( $days == 1 ) {
2548 ->inLanguage( $this )
2551 } elseif ( $diff->h > 1 || $diff->h == 1 && $diff->i > 30 ) {
2555 ->inLanguage( $this )
2561 } elseif ( $diff->h == 1 ) {
2563 $ts =
wfMessage(
'hours-ago' )->inLanguage( $this )->numParams( 1 )->text();
2564 } elseif ( $diff->i >= 1 ) {
2566 $ts =
wfMessage(
'minutes-ago' )->inLanguage( $this )->numParams( $diff->i )->text();
2567 } elseif ( $diff->s >= 30 ) {
2569 $ts =
wfMessage(
'seconds-ago' )->inLanguage( $this )->numParams( $diff->s )->text();
2583 return self::$dataCache->getSubitem( $this->mCode,
'messages', $key );
2590 return self::$dataCache->getItem( $this->mCode,
'messages' );
2600 # Even with //IGNORE iconv can whine about illegal characters in
2601 # *input* string. We just ignore those too.
2602 # REF: https://bugs.php.net/bug.php?id=37166
2603 # REF: https://phabricator.wikimedia.org/T18885
2604 MediaWiki\suppressWarnings();
2605 $text =
iconv( $in,
$out .
'//IGNORE', $string );
2606 MediaWiki\restoreWarnings();
2625 return mb_strtoupper(
$matches[0] );
2633 return mb_strtoupper(
$matches[0] );
2647 } elseif ( $o < 128 ) {
2651 return $this->
uc( $str,
true );
2663 public function uc( $str, $first =
false ) {
2666 return mb_strtoupper( mb_substr( $str, 0, 1 ) ) . mb_substr( $str, 1 );
2671 return $this->
isMultibyte( $str ) ? mb_strtoupper( $str ) : strtoupper( $str );
2682 return strval( $str );
2683 } elseif ( $o >= 128 ) {
2684 return $this->
lc( $str,
true );
2685 } elseif ( $o > 96 ) {
2688 $str[0] = strtolower( $str[0] );
2698 function lc( $str, $first =
false ) {
2701 return mb_strtolower( mb_substr( $str, 0, 1 ) ) . mb_substr( $str, 1 );
2703 return strtolower( substr( $str, 0, 1 ) ) . substr( $str, 1 );
2706 return $this->
isMultibyte( $str ) ? mb_strtolower( $str ) : strtolower( $str );
2715 return strlen( $str ) !== mb_strlen( $str );
2724 $str = $this->
lc( $str );
2727 $replaceRegexp =
"/^([a-z]|[\\xc0-\\xff][\\x80-\\xbf]*)| ([a-z]|[\\xc0-\\xff][\\x80-\\xbf]*)/";
2730 return preg_replace_callback(
2732 [ $this,
'ucwordsCallbackMB' ],
2736 return ucwords( strtolower( $str ) );
2748 $str = $this->
lc( $str );
2751 $breaks =
"[ \-\(\)\}\{\.,\?!]";
2754 $replaceRegexp =
"/^([a-z]|[\\xc0-\\xff][\\x80-\\xbf]*)|" .
2755 "$breaks([a-z]|[\\xc0-\\xff][\\x80-\\xbf]*)/";
2757 return preg_replace_callback(
2759 [ $this,
'ucwordbreaksCallbackMB' ],
2763 return preg_replace_callback(
2764 '/\b([\w\x80-\xff]+)\b/',
2765 [ $this,
'ucwordbreaksCallbackAscii' ],
2787 return $this->
uc(
$s );
2796 if ( is_array(
$s ) ) {
2797 throw new MWException(
'Given array to checkTitleEncoding.' );
2810 return self::$dataCache->getItem( $this->mCode,
'fallback8bitEncoding' );
2844 return self::convertDoubleWidth( $string );
2856 static $full = null;
2857 static $half = null;
2859 if ( $full === null ) {
2860 $fullWidth =
"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
2861 $halfWidth =
"0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
2862 $full = str_split( $fullWidth, 3 );
2863 $half = str_split( $halfWidth );
2866 $string = str_replace( $full, $half, $string );
2876 $string = preg_replace( $pattern,
" $1 ", $string );
2877 $string = preg_replace(
'/ +/',
' ', $string );
2886 # some languages, e.g. Chinese, need to do a conversion
2887 # in order for search results to be displayed correctly
2900 '/^([\x00-\x7f]|[\xc0-\xdf][\x80-\xbf]|' .
2901 '[\xe0-\xef][\x80-\xbf]{2}|[\xf0-\xf7][\x80-\xbf]{3})/',
2907 if ( strlen(
$matches[1] ) != 3 ) {
2915 } elseif (
$code < 0xb098 ) {
2916 return "\xe3\x84\xb1";
2917 } elseif (
$code < 0xb2e4 ) {
2918 return "\xe3\x84\xb4";
2919 } elseif (
$code < 0xb77c ) {
2920 return "\xe3\x84\xb7";
2921 } elseif (
$code < 0xb9c8 ) {
2922 return "\xe3\x84\xb9";
2923 } elseif (
$code < 0xbc14 ) {
2924 return "\xe3\x85\x81";
2925 } elseif (
$code < 0xc0ac ) {
2926 return "\xe3\x85\x82";
2927 } elseif (
$code < 0xc544 ) {
2928 return "\xe3\x85\x85";
2929 } elseif (
$code < 0xc790 ) {
2930 return "\xe3\x85\x87";
2931 } elseif (
$code < 0xcc28 ) {
2932 return "\xe3\x85\x88";
2933 } elseif (
$code < 0xce74 ) {
2934 return "\xe3\x85\x8a";
2935 } elseif (
$code < 0xd0c0 ) {
2936 return "\xe3\x85\x8b";
2937 } elseif (
$code < 0xd30c ) {
2938 return "\xe3\x85\x8c";
2939 } elseif (
$code < 0xd558 ) {
2940 return "\xe3\x85\x8d";
2942 return "\xe3\x85\x8e";
2987 $s = UtfNormal\Validator::cleanUp(
$s );
2988 if ( $wgAllUnicodeFixes ) {
3011 if ( !isset( $this->transformData[$file] ) ) {
3013 if ( $data ===
false ) {
3014 throw new MWException( __METHOD__ .
": The transformation file $file is missing" );
3018 return $this->transformData[$file]->replace( $string );
3027 return self::$dataCache->getItem( $this->mCode,
'rtl' );
3035 return $this->
isRTL() ?
'rtl' :
'ltr';
3047 return $this->
isRTL() ?
'right' :
'left';
3059 return $this->
isRTL() ?
'left' :
'right';
3075 return $this->
isRTL() ?
'‎' :
'‏';
3077 return $this->
isRTL() ?
'‏' :
'‎';
3091 $lrm =
"\xE2\x80\x8E"; # LEFT-TO-RIGHT MARK, commonly abbreviated LRM
3092 $rlm =
"\xE2\x80\x8F"; # RIGHT-TO-LEFT MARK, commonly abbreviated RLM
3094 return $this->
isRTL() ? $lrm : $rlm;
3096 return $this->
isRTL() ? $rlm : $lrm;
3103 return self::$dataCache->getItem( $this->mCode,
'capitalizeAllNouns' );
3114 switch ( $direction ) {
3116 return $this->
isRTL() ?
'←' :
'→';
3118 return $this->
isRTL() ?
'→' :
'←';
3136 return self::$dataCache->getItem( $this->mCode,
'linkPrefixExtension' );
3144 return self::$dataCache->getItem( $this->mCode,
'magicWords' );
3151 if ( $this->mMagicHookDone ) {
3154 $this->mMagicHookDone =
true;
3155 Hooks::run(
'LanguageGetMagic', [ &$this->mMagicExtensions, $this->
getCode() ] );
3165 if ( !$this->mMagicHookDone ) {
3169 if ( isset( $this->mMagicExtensions[$mw->mId] ) ) {
3170 $rawEntry = $this->mMagicExtensions[$mw->mId];
3172 $rawEntry = self::$dataCache->getSubitem(
3173 $this->mCode,
'magicWords', $mw->mId );
3176 if ( !is_array( $rawEntry ) ) {
3177 wfWarn(
"\"$rawEntry\" is not a valid magic word for \"$mw->mId\"" );
3179 $mw->mCaseSensitive = $rawEntry[0];
3180 $mw->mSynonyms = array_slice( $rawEntry, 1 );
3191 $fallbackChain = array_reverse( $fallbackChain );
3192 foreach ( $fallbackChain
as $code ) {
3193 if ( isset( $newWords[$code] ) ) {
3206 if ( is_null( $this->mExtendedSpecialPageAliases ) ) {
3208 $this->mExtendedSpecialPageAliases =
3209 self::$dataCache->getItem( $this->mCode,
'specialPageAliases' );
3211 [ &$this->mExtendedSpecialPageAliases, $this->
getCode() ] );
3224 return "<em>$text</em>";
3251 if ( !$nocommafy ) {
3252 $number = $this->
commafy( $number );
3255 $number = strtr( $number,
$s );
3259 if ( $wgTranslateNumerals ) {
3262 $number = strtr( $number,
$s );
3278 return $this->
formatNum( $number,
true );
3289 $s = array_filter(
$s );
3290 $number = strtr( $number, array_flip(
$s ) );
3296 $s = array_filter(
$s );
3297 $number = strtr( $number, array_flip(
$s ) );
3300 $number = strtr( $number, [
',' =>
'' ] );
3312 if ( $number === null ) {
3318 return strrev( (
string)preg_replace(
'/(\d{3})(?=\d)(?!\d*\.)/',
'$1,', strrev( $number ) ) );
3322 if ( intval( $number ) < 0 ) {
3325 $number = substr( $number, 1 );
3330 preg_match(
"/\d+/", $number, $integerPart );
3331 preg_match(
"/\.\d*/", $number, $decimalPart );
3332 $groupedNumber = ( count( $decimalPart ) > 0 ) ? $decimalPart[0] :
"";
3333 if ( $groupedNumber === $number ) {
3335 return $sign . $groupedNumber;
3337 $start = $end = ( $integerPart ) ? strlen( $integerPart[0] ) : 0;
3338 while ( $start > 0 ) {
3339 $match =
$matches[0][$numMatches - 1];
3340 $matchLen = strlen( $match );
3341 $start = $end - $matchLen;
3345 $groupedNumber = substr( $number, $start, $end -$start ) . $groupedNumber;
3347 if ( $numMatches > 1 ) {
3352 $groupedNumber =
"," . $groupedNumber;
3355 return $sign . $groupedNumber;
3363 return self::$dataCache->getItem( $this->mCode,
'digitGroupingPattern' );
3370 return self::$dataCache->getItem( $this->mCode,
'digitTransformTable' );
3377 return self::$dataCache->getItem( $this->mCode,
'separatorTransformTable' );
3390 $m = count( $l ) - 1;
3395 $and = $this->
msg(
'and' )->escaped();
3396 $space = $this->
msg(
'word-separator' )->escaped();
3398 $comma = $this->
msg(
'comma-separator' )->escaped();
3402 for ( $i = $m - 1; $i >= 0; $i-- ) {
3403 if ( $i == $m - 1 ) {
3404 $s = $l[$i] . $and . $space .
$s;
3406 $s = $l[$i] . $comma .
$s;
3420 wfMessage(
'comma-separator' )->inLanguage( $this )->escaped(),
3433 wfMessage(
'semicolon-separator' )->inLanguage( $this )->escaped(),
3445 wfMessage(
'pipe-separator' )->inLanguage( $this )->escaped(),
3467 function truncate( $string, $length, $ellipsis =
'...', $adjustLength =
true ) {
3468 # Use the localized ellipsis character
3469 if ( $ellipsis ==
'...' ) {
3470 $ellipsis =
wfMessage(
'ellipsis' )->inLanguage( $this )->escaped();
3472 # Check if there is no need to truncate
3473 if ( $length == 0 ) {
3475 } elseif ( strlen( $string ) <= abs( $length ) ) {
3478 $stringOriginal = $string;
3479 # If ellipsis length is >= $length then we can't apply $adjustLength
3480 if ( $adjustLength && strlen( $ellipsis ) >= abs( $length ) ) {
3481 $string = $ellipsis;
3482 # Otherwise, truncate and add ellipsis...
3484 $eLength = $adjustLength ? strlen( $ellipsis ) : 0;
3485 if ( $length > 0 ) {
3486 $length -= $eLength;
3487 $string = substr( $string, 0, $length );
3489 $string = rtrim( $string );
3490 $string = $string . $ellipsis;
3492 $length += $eLength;
3493 $string = substr( $string, $length );
3495 $string = ltrim( $string );
3496 $string = $ellipsis . $string;
3499 # Do not truncate if the ellipsis makes the string longer/equal (bug 22181).
3500 # This check is *not* redundant if $adjustLength, due to the single case where
3501 # LEN($ellipsis) > ABS($limit arg); $stringOriginal could be shorter than $string.
3502 if ( strlen( $string ) < strlen( $stringOriginal ) ) {
3505 return $stringOriginal;
3517 if ( $string !=
'' ) {
3518 $char = ord( $string[strlen( $string ) - 1] );
3520 if ( $char >= 0xc0 ) {
3521 # We got the first byte only of a multibyte char; remove it.
3522 $string = substr( $string, 0, -1 );
3523 } elseif ( $char >= 0x80 &&
3525 preg_match(
'/^(.*)(?:[\xe0-\xef][\x80-\xbf]|' .
3526 '[\xf0-\xf7][\x80-\xbf]{1,2})$/s', $string, $m )
3528 # We chopped in the middle of a character; remove it
3543 if ( $string !=
'' ) {
3544 $char = ord( $string[0] );
3545 if ( $char >= 0x80 && $char < 0xc0 ) {
3546 # We chopped in the middle of a character; remove the whole thing
3547 $string = preg_replace(
'/^[\x80-\xbf]+/',
'', $string );
3569 # Use the localized ellipsis character
3570 if ( $ellipsis ==
'...' ) {
3571 $ellipsis =
wfMessage(
'ellipsis' )->inLanguage( $this )->escaped();
3573 # Check if there is clearly no need to truncate
3574 if ( $length <= 0 ) {
3576 } elseif ( strlen( $text ) <= $length ) {
3581 $testingEllipsis =
false;
3589 $textLen = strlen( $text );
3590 $neLength = max( 0, $length - strlen( $ellipsis ) );
3591 for ( $pos = 0;
true; ++$pos ) {
3592 # Consider truncation once the display length has reached the maximim.
3593 # We check if $dispLen > 0 to grab tags for the $neLength = 0 case.
3594 # Check that we're not in the middle of a bracket/entity...
3595 if ( $dispLen && $dispLen >= $neLength && $bracketState == 0 && !$entityState ) {
3596 if ( !$testingEllipsis ) {
3597 $testingEllipsis =
true;
3598 # Save where we are; we will truncate here unless there turn out to
3599 # be so few remaining characters that truncation is not necessary.
3600 if ( !$maybeState ) {
3601 $maybeState = [
$ret, $openTags ];
3603 } elseif ( $dispLen > $length && $dispLen > strlen( $ellipsis ) ) {
3604 # String in fact does need truncation, the truncation point was OK.
3605 list(
$ret, $openTags ) = $maybeState;
3611 if ( $pos >= $textLen ) {
3615 # Read the next char...
3617 $lastCh = $pos ? $text[$pos - 1] :
'';
3623 } elseif ( $ch ==
'>' ) {
3627 } elseif ( $bracketState == 1 ) {
3635 } elseif ( $bracketState == 2 ) {
3642 } elseif ( $bracketState == 0 ) {
3643 if ( $entityState ) {
3649 if ( $neLength == 0 && !$maybeState ) {
3652 $maybeState = [ substr(
$ret, 0, -1 ), $openTags ];
3659 $max = ( $testingEllipsis ? $length : $neLength ) - $dispLen;
3661 $dispLen += $skipped;
3669 while ( count( $openTags ) > 0 ) {
3670 $ret .=
'</' . array_pop( $openTags ) .
'>';
3687 if ( $len === null ) {
3689 } elseif ( $len < 0 ) {
3693 if ( $start < strlen( $text ) ) {
3694 $skipCount = strcspn( $text, $search, $start, $len );
3695 $ret .= substr( $text, $start, $skipCount );
3712 if ( $tagType == 0 && $lastCh !=
'/' ) {
3714 } elseif ( $tagType == 1 ) {
3715 if ( $openTags &&
$tag == $openTags[count( $openTags ) - 1] ) {
3716 array_pop( $openTags );
3733 if ( isset( $wgGrammarForms[$this->
getCode()][$case][$word] ) ) {
3734 return $wgGrammarForms[$this->
getCode()][$case][$word];
3747 if ( isset( $wgGrammarForms[$this->
getCode()] )
3748 && is_array( $wgGrammarForms[$this->
getCode()] )
3750 return $wgGrammarForms[$this->
getCode()];
3766 $languageCode = $this->
getCode();
3768 if ( self::$grammarTransformations === null ) {
3769 self::$grammarTransformations =
new MapCacheLRU( 10 );
3772 if ( self::$grammarTransformations->has( $languageCode ) ) {
3773 return self::$grammarTransformations->get( $languageCode );
3778 $grammarDataFile = __DIR__ .
"/data/grammarTransformations/$languageCode.json";
3779 if ( is_readable( $grammarDataFile ) ) {
3781 file_get_contents( $grammarDataFile ),
3785 if ( $data === null ) {
3786 throw new MWException(
"Invalid grammar data for \"$languageCode\"." );
3789 self::$grammarTransformations->set( $languageCode, $data );
3815 if ( !count( $forms ) ) {
3819 if ( $gender ===
'male' ) {
3822 if ( $gender ===
'female' ) {
3825 return isset( $forms[2] ) ? $forms[2] : $forms[0];
3846 if ( is_string( $forms ) ) {
3849 if ( !count( $forms ) ) {
3854 $pluralForm = min( $pluralForm, count( $forms ) - 1 );
3855 return $forms[$pluralForm];
3874 foreach ( $forms
as $index => $form ) {
3875 if ( preg_match(
'/\d+=/i', $form ) ) {
3876 $pos = strpos( $form,
'=' );
3877 if ( substr( $form, 0, $pos ) === (
string)
$count ) {
3878 return substr( $form, $pos + 1 );
3880 unset( $forms[$index] );
3883 return array_values( $forms );
3895 while ( count( $forms ) <
$count ) {
3896 $forms[] = $forms[count( $forms ) - 1];
3919 if (
$dir ===
'ltr' ) {
3921 return self::$lre . $text . self::$pdf;
3923 if (
$dir ===
'rtl' ) {
3925 return self::$rle . $text . self::$pdf;
3945 foreach ( $duration
as $show =>
$value ) {
3946 if ( strcmp( $str,
$value ) == 0 ) {
3947 return htmlspecialchars( trim( $show ) );
3952 foreach ( $duration
as $show =>
$value ) {
3954 return htmlspecialchars( trim( $show ) );
3960 $time = strtotime( $str, 0 );
3961 if (
$time ===
false ) {
3963 } elseif (
$time !== strtotime( $str, 1 ) ) {
3967 if (
$time === 0 ) {
3969 $time =
'19700101000000';
4016 return $this->mConverter->autoConvertToAllVariants( $text );
4026 return $this->mConverter->convert( $text );
4036 return $this->mConverter->convertTitle(
$title );
4046 return $this->mConverter->convertNamespace( $ns );
4066 return (
bool)$this->mConverter->validateVariant( $variant );
4077 return htmlspecialchars( $this->
convert( $text, $isTitle ) );
4085 return $this->mConverter->convertCategoryKey( $key );
4095 return $this->mConverter->getVariants();
4102 return $this->mConverter->getPreferredVariant();
4109 return $this->mConverter->getDefaultVariant();
4116 return $this->mConverter->getURLVariant();
4132 $this->mConverter->findVariantLink(
$link, $nt, $ignoreOtherCond );
4142 return $this->mConverter->getExtraHashOptions();
4153 return $this->mConverter->getParsedTitle();
4163 $this->mConverter->updateConversionTable( $title );
4181 return $this->mConverter->markNoConversion( $text );
4194 return self::$dataCache->getItem( $this->mCode,
'linkTrail' );
4204 return self::$dataCache->getItem( $this->mCode,
'linkPrefixCharset' );
4215 if ( $this->mParentLanguage !==
false ) {
4221 $this->mParentLanguage = null;
4225 if ( !
$lang->hasVariant( $this->getCode() ) ) {
4226 $this->mParentLanguage = null;
4230 $this->mParentLanguage =
$lang;
4268 if ( is_null( $this->mHtmlCode ) ) {
4278 $this->mCode =
$code;
4280 $this->mHtmlCode = null;
4281 $this->mParentLanguage =
false;
4293 preg_match(
'/' . preg_quote( $prefix,
'/' ) .
'([A-Z][a-z_]+)' .
4294 preg_quote( $suffix,
'/' ) .
'/', $filename, $m );
4295 if ( !count( $m ) ) {
4298 return str_replace(
'_',
'-', strtolower( $m[1] ) );
4306 if (
$code ==
'en' ) {
4309 return 'Language' . str_replace(
'-',
'_',
ucfirst(
$code ) );
4322 if ( !self::isValidBuiltInCode(
$code ) ) {
4323 throw new MWException(
"Invalid language code \"$code\"" );
4326 return $prefix . str_replace(
'-',
'_',
ucfirst(
$code ) ) . $suffix;
4335 $file = self::getFileName(
"$IP/languages/messages/Messages",
$code,
'.php' );
4349 if ( !self::isValidBuiltInCode(
$code ) ) {
4350 throw new MWException(
"Invalid language code \"$code\"" );
4353 return "$IP/languages/i18n/$code.json";
4364 $fallbacks = self::getFallbacksFor(
$code );
4366 return $fallbacks[0];
4384 return self::getLocalisationCache()->getItem(
$code,
'fallbackSequence' ) ?: [
'en' ];
4400 $cacheKey =
"{$code}-{$wgLanguageCode}";
4402 if ( !array_key_exists( $cacheKey, self::$fallbackLanguageCache ) ) {
4403 $fallbacks = self::getFallbacksFor(
$code );
4406 $siteFallbacks = self::getFallbacksFor( $wgLanguageCode );
4407 array_unshift( $siteFallbacks, $wgLanguageCode );
4410 $siteFallbacks = array_diff( $siteFallbacks, $fallbacks );
4412 self::$fallbackLanguageCache[$cacheKey] = [ $fallbacks, $siteFallbacks ];
4414 return self::$fallbackLanguageCache[$cacheKey];
4427 return self::getLocalisationCache()->getItem(
$code,
'messages' );
4439 return self::getLocalisationCache()->getSubitem(
$code,
'messages', $key );
4451 return self::getLocalisationCache()->getSubitemList(
$code,
'messages' );
4459 if ( strpos( $talk,
'$1' ) ===
false ) {
4464 $talk = str_replace(
'$1', $wgMetaNamespace, $talk );
4466 # Allow grammar transformations
4467 # Allowing full message-style parsing would make simple requests
4468 # such as action=raw much more expensive than they need to be.
4469 # This will hopefully cover most cases.
4470 $talk = preg_replace_callback(
'/{{grammar:(.*?)\|(.*?)}}/i',
4471 [ $this,
'replaceGrammarInNamespace' ], $talk );
4472 return str_replace(
' ',
'_', $talk );
4493 public function formatExpiry( $expiry, $format =
true, $infinity =
'infinity' ) {
4495 if ( $dbInfinity === null ) {
4499 if ( $expiry ==
'' || $expiry ===
'infinity' || $expiry == $dbInfinity ) {
4500 return $format ===
true
4504 return $format ===
true
4524 if ( !is_array( $format ) ) {
4525 $format = [
'avoid' => $format ];
4527 if ( !isset( $format[
'avoid'] ) ) {
4528 $format[
'avoid'] =
false;
4530 if ( !isset( $format[
'noabbrevs'] ) ) {
4531 $format[
'noabbrevs'] =
false;
4534 $format[
'noabbrevs'] ?
'seconds' :
'seconds-abbrev' )->inLanguage( $this );
4536 $format[
'noabbrevs'] ?
'minutes' :
'minutes-abbrev' )->inLanguage( $this );
4538 $format[
'noabbrevs'] ?
'hours' :
'hours-abbrev' )->inLanguage( $this );
4540 $format[
'noabbrevs'] ?
'days' :
'days-abbrev' )->inLanguage( $this );
4542 if ( round( $seconds * 10 ) < 100 ) {
4543 $s = $this->
formatNum( sprintf(
"%.1f", round( $seconds * 10 ) / 10 ) );
4544 $s = $secondsMsg->params(
$s )->text();
4545 } elseif ( round( $seconds ) < 60 ) {
4547 $s = $secondsMsg->params(
$s )->text();
4548 } elseif ( round( $seconds ) < 3600 ) {
4549 $minutes = floor( $seconds / 60 );
4550 $secondsPart = round( fmod( $seconds, 60 ) );
4551 if ( $secondsPart == 60 ) {
4555 $s = $minutesMsg->params( $this->
formatNum( $minutes ) )->text();
4557 $s .= $secondsMsg->params( $this->
formatNum( $secondsPart ) )->text();
4558 } elseif ( round( $seconds ) <= 2 * 86400 ) {
4559 $hours = floor( $seconds / 3600 );
4560 $minutes = floor( ( $seconds - $hours * 3600 ) / 60 );
4561 $secondsPart = round( $seconds - $hours * 3600 - $minutes * 60 );
4562 if ( $secondsPart == 60 ) {
4566 if ( $minutes == 60 ) {
4570 $s = $hoursMsg->params( $this->
formatNum( $hours ) )->text();
4572 $s .= $minutesMsg->params( $this->
formatNum( $minutes ) )->text();
4573 if ( !in_array( $format[
'avoid'], [
'avoidseconds',
'avoidminutes' ] ) ) {
4574 $s .=
' ' . $secondsMsg->params( $this->
formatNum( $secondsPart ) )->text();
4577 $days = floor( $seconds / 86400 );
4578 if ( $format[
'avoid'] ===
'avoidminutes' ) {
4579 $hours = round( ( $seconds - $days * 86400 ) / 3600 );
4580 if ( $hours == 24 ) {
4584 $s = $daysMsg->params( $this->
formatNum( $days ) )->text();
4586 $s .= $hoursMsg->params( $this->
formatNum( $hours ) )->text();
4587 } elseif ( $format[
'avoid'] ===
'avoidseconds' ) {
4588 $hours = floor( ( $seconds - $days * 86400 ) / 3600 );
4589 $minutes = round( ( $seconds - $days * 86400 - $hours * 3600 ) / 60 );
4590 if ( $minutes == 60 ) {
4594 if ( $hours == 24 ) {
4598 $s = $daysMsg->params( $this->
formatNum( $days ) )->text();
4600 $s .= $hoursMsg->params( $this->
formatNum( $hours ) )->text();
4602 $s .= $minutesMsg->params( $this->
formatNum( $minutes ) )->text();
4604 $s = $daysMsg->params( $this->
formatNum( $days ) )->text();
4635 return str_replace(
'$1', $this->
formatNum( $size ),
4639 $sizes = [
'',
'kilo',
'mega',
'giga',
'tera',
'peta',
'exa',
'zeta',
'yotta' ];
4642 $maxIndex = count( $sizes ) - 1;
4643 while ( $size >= $boundary && $index < $maxIndex ) {
4654 $msg = str_replace(
'$1', $sizes[$index], $messageKey );
4656 $size = round( $size, $round );
4658 return str_replace(
'$1', $this->
formatNum( $size ), $text );
4693 $this->
msg(
'word-separator' )->escaped() .
4694 $this->
msg(
'parentheses' )->rawParams( $details )->escaped();
4712 # Make 'previous' link
4713 $prev =
wfMessage(
'prevn' )->inLanguage( $this )->title( $title )->numParams(
$limit )->text();
4714 if ( $offset > 0 ) {
4716 $query, $prev,
'prevn-title',
'mw-prevlink' );
4718 $plink = htmlspecialchars( $prev );
4722 $next =
wfMessage(
'nextn' )->inLanguage( $this )->title( $title )->numParams(
$limit )->text();
4724 $nlink = htmlspecialchars( $next );
4727 $query, $next,
'nextn-title',
'mw-nextlink' );
4730 # Make links to set number of items per page
4732 foreach ( [ 20, 50, 100, 250, 500 ]
as $num ) {
4733 $numLinks[] = $this->
numLink( $title, $offset, $num,
4737 return wfMessage(
'viewprevnext' )->inLanguage( $this )->title( $title
4738 )->rawParams( $plink, $nlink, $this->
pipeList( $numLinks ) )->escaped();
4756 $query = [
'limit' =>
$limit,
'offset' => $offset ] +
$query;
4757 $tooltip =
wfMessage( $tooltipMsg )->inLanguage( $this )->title( $title )
4758 ->numParams(
$limit )->text();
4761 'title' => $tooltip,
'class' => $class ],
$link );
4770 return $this->mConverter->getConvRuleTitle();
4779 $pluralRules = self::$dataCache->getItem( strtolower( $this->mCode ),
'compiledPluralRules' );
4781 if ( !$pluralRules ) {
4782 foreach ( $fallbacks
as $fallbackCode ) {
4783 $pluralRules = self::$dataCache->getItem( strtolower( $fallbackCode ),
'compiledPluralRules' );
4784 if ( $pluralRules ) {
4789 return $pluralRules;
4798 $pluralRules = self::$dataCache->getItem( strtolower( $this->mCode ),
'pluralRules' );
4800 if ( !$pluralRules ) {
4801 foreach ( $fallbacks
as $fallbackCode ) {
4802 $pluralRules = self::$dataCache->getItem( strtolower( $fallbackCode ),
'pluralRules' );
4803 if ( $pluralRules ) {
4808 return $pluralRules;
4817 $pluralRuleTypes = self::$dataCache->getItem( strtolower( $this->mCode ),
'pluralRuleTypes' );
4819 if ( !$pluralRuleTypes ) {
4820 foreach ( $fallbacks
as $fallbackCode ) {
4821 $pluralRuleTypes = self::$dataCache->getItem( strtolower( $fallbackCode ),
'pluralRuleTypes' );
4822 if ( $pluralRuleTypes ) {
4827 return $pluralRuleTypes;
4837 $form = Evaluator::evaluateCompiled( $number, $pluralRules );
4852 if ( isset( $pluralRuleTypes[$index] ) ) {
4853 return $pluralRuleTypes[$index];
utf8ToCodepoint($char)
Determine the Unicode codepoint of a single-character UTF-8 sequence.
#define the
table suitable for use with IDatabase::select()
formatTimePeriod($seconds, $format=[])
Formats a time given in seconds into a string representation of that time.
getDirMark($opposite=false)
A hidden direction mark (LRM or RLM), depending on the language direction.
getSpecialPageAliases()
Get special page names, as an associative array canonical name => array of valid names, including aliases.
getWeekdayAbbreviation($key)
getDateFormatString($type, $pref)
Get a format string for a given type and preference.
getPluralRuleTypes()
Get the plural rule types for the language.
getHumanTimestamp(MWTimestamp $time, MWTimestamp $relativeTo=null, User $user=null)
Get the timestamp in a human-friendly relative format, e.g., "3 days ago".
static getLocalisationCache()
Get the LocalisationCache instance.
convertPlural($count, $forms)
Plural form transformations, needed for some languages.
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
doMagicHook()
Run the LanguageGetMagic hook once.
wfGetDB($db, $groups=[], $wiki=false)
Get a Database object.
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output $out
static isKnownLanguageTag($tag)
Returns true if a language code is an IETF tag known to MediaWiki.
the array() calling protocol came about after MediaWiki 1.4rc1.
static insertSpace($string, $pattern)
null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify $query
convertGrammar($word, $case)
Grammatical transformations, needed for inflected languages Invoked by putting {{grammar:case|word}} ...
static LocalisationCache $dataCache
handleExplicitPluralForms($count, array $forms)
Handles explicit plural forms for Language::convertPlural()
hasVariant($variant)
Check if the language has the specific variant.
markNoConversion($text, $noParse=false)
Prepare external link text for conversion.
setNamespaces(array $namespaces)
Arbitrarily set all of the namespace names at once.
static HashBagOStuff null $languageNameCache
Cache for language names.
transformUsingPairFile($file, $string)
Transform a string using serialized data stored in the given file (which must be in the serialized su...
date($ts, $adj=false, $format=true, $timecorrection=false)
getHtmlCode()
Get the code in BCP 47 format which we can use inside of html lang="" tags.
truncate_skip(&$ret, $text, $search, $start, $len=null)
truncateHtml() helper function like strcspn() but adds the skipped chars to $ret
static isWellFormedLanguageTag($code, $lenient=false)
Returns true if a language code string is a well-formed language tag according to RFC 5646...
equals(Language $lang)
Compare with an other language object.
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses & $ret
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
removeBadCharFirst($string)
Remove bytes that represent an incomplete Unicode character at the start of string (e...
convertNamespace($ns)
Convert a namespace index to a string in the preferred variant.
static getMessageFor($key, $code)
Get a message for a given language.
offsetForUser(User $user)
Adjust the timestamp depending on the given user's preferences.
getLocalNsIndex($text)
Get a namespace key by value, case insensitive.
alignEnd()
Return 'right' or 'left' as appropriate alignment for line-end for this language's text direction...
firstChar($s)
Get the first character of a string.
globals txt Globals are evil The original MediaWiki code relied on globals for processing context far too often MediaWiki development since then has been a story of slowly moving context out of global variables and into objects Storing processing context in object member variables allows those objects to be reused in a much more flexible way Consider the elegance of
database rows
$wgLangObjCacheSize
Language cache size, or really how many languages can we handle simultaneously without degrading to c...
if(!isset($args[0])) $lang
hasVariants()
Check if this is a language with variants.
getCompiledPluralRules()
Get the compiled plural rules for the language.
getNsIndex($text)
Get a namespace key by value, case insensitive.
getNsText($index)
Get a namespace value by key.
This code would result in ircNotify being run twice when an article is and once for brion Hooks can return three possible true was required This is the default since MediaWiki *some string
iconv($in, $out, $string)
$wgMetaNamespace
Name of the project namespace.
formatComputingNumbers($size, $boundary, $messageKey)
static getFallbacksIncludingSiteLanguage($code)
Get the ordered list of fallback languages, ending with the fallback language chain for the site lang...
formatNumNoSeparators($number)
Front-end for non-commafied formatNum.
truncate_endBracket(&$tag, $tagType, $lastCh, &$openTags)
truncateHtml() helper function (a) push or pop $tag from $openTags as needed (b) clear $tag value ...
A fake language converter.
linkTrail()
A regular expression to match legal word-trailing characters which should be merged onto a link of th...
wfUrlProtocolsWithoutProtRel()
Like wfUrlProtocols(), but excludes '//' from the protocol list.
normalize($s)
Convert a UTF-8 string to normal form C.
$wgNamespaceAliases
Namespace aliases.
static getCodeFromFileName($filename, $prefix= 'Language', $suffix= '.php')
Get the language code from a file name.
internalUserTimeAndDate($type, $ts, User $user, array $options)
Internal helper function for userDate(), userTime() and userTimeAndDate()
static getMessageKeysFor($code)
Get all message keys for a given language.
static tsToHijri($ts)
Converting Gregorian dates to Hijri dates.
formatExpiry($expiry, $format=true, $infinity= 'infinity')
Decode an expiry (block, protection, etc) which has come from the DB.
getVariants()
Get the list of variants supported by this language see sample implementation in LanguageZh.php.
dateFormat($usePrefs=true)
This is meant to be used by time(), date(), and timeanddate() to get the date preference they're supp...
when a variable name is used in a it is silently declared as a new local masking the global
autoConvertToAllVariants($text)
convert text to all supported variants
static getFallbacksFor($code)
Get the ordered list of fallback languages.
We ve cleaned up the code here by removing clumps of infrequently used code and moving them off somewhere else It s much easier for someone working with this code to see what s _really_ going and make changes or fix bugs In we can take all the code that deals with the little used title reversing options(say) and put it in one place.Instead of having little title-reversing if-blocks spread all over the codebase in showAnArticle
$wgExtraGenderNamespaces
Same as above, but for namespaces with gender distinction.
return['DBLoadBalancerFactory'=> function(MediaWikiServices $services){$mainConfig=$services->getMainConfig();$lbConf=MWLBFactory::applyDefaultConfig($mainConfig->get( 'LBFactoryConf'), $mainConfig);$class=MWLBFactory::getLBFactoryClass($lbConf);return new $class($lbConf);},'DBLoadBalancer'=> function(MediaWikiServices $services){return $services->getDBLoadBalancerFactory() ->getMainLB();},'SiteStore'=> function(MediaWikiServices $services){$rawSiteStore=new DBSiteStore($services->getDBLoadBalancer());$cache=wfGetCache(wfIsHHVM()?CACHE_ACCEL:CACHE_ANYTHING);return new CachingSiteStore($rawSiteStore, $cache);},'SiteLookup'=> function(MediaWikiServices $services){return $services->getSiteStore();},'ConfigFactory'=> function(MediaWikiServices $services){$registry=$services->getBootstrapConfig() ->get( 'ConfigRegistry');$factory=new ConfigFactory();foreach($registry as $name=> $callback){$factory->register($name, $callback);}return $factory;},'MainConfig'=> function(MediaWikiServices $services){return $services->getConfigFactory() ->makeConfig( 'main');},'InterwikiLookup'=> function(MediaWikiServices $services){global $wgContLang;$config=$services->getMainConfig();return new ClassicInterwikiLookup($wgContLang, ObjectCache::getMainWANInstance(), $config->get( 'InterwikiExpiry'), $config->get( 'InterwikiCache'), $config->get( 'InterwikiScopes'), $config->get( 'InterwikiFallbackSite'));},'StatsdDataFactory'=> function(MediaWikiServices $services){return new BufferingStatsdDataFactory(rtrim($services->getMainConfig() ->get( 'StatsdMetricPrefix'), '.'));},'EventRelayerGroup'=> function(MediaWikiServices $services){return new EventRelayerGroup($services->getMainConfig() ->get( 'EventRelayerConfig'));},'SearchEngineFactory'=> function(MediaWikiServices $services){return new SearchEngineFactory($services->getSearchEngineConfig());},'SearchEngineConfig'=> function(MediaWikiServices $services){global $wgContLang;return new SearchEngineConfig($services->getMainConfig(), $wgContLang);},'SkinFactory'=> function(MediaWikiServices $services){$factory=new SkinFactory();$names=$services->getMainConfig() ->get( 'ValidSkinNames');foreach($names as $name=> $skin){$factory->register($name, $skin, function() use($name, $skin){$class="Skin$skin";return new $class($name);});}$factory->register( 'fallback', 'Fallback', function(){return new SkinFallback;});$factory->register( 'apioutput', 'ApiOutput', function(){return new SkinApi;});return $factory;},'WatchedItemStore'=> function(MediaWikiServices $services){$store=new WatchedItemStore($services->getDBLoadBalancer(), new HashBagOStuff([ 'maxKeys'=> 100]));$store->setStatsdDataFactory($services->getStatsdDataFactory());return $store;},'WatchedItemQueryService'=> function(MediaWikiServices $services){return new WatchedItemQueryService($services->getDBLoadBalancer());},'CryptRand'=> function(MediaWikiServices $services){$secretKey=$services->getMainConfig() ->get( 'SecretKey');return new CryptRand(['wfHostname','wfWikiID', function() use($secretKey){return $secretKey?: '';}], defined( 'MW_CONFIG_FILE')?[MW_CONFIG_FILE]:[], LoggerFactory::getInstance( 'CryptRand'));},'CryptHKDF'=> function(MediaWikiServices $services){$config=$services->getMainConfig();$secret=$config->get( 'HKDFSecret')?:$config->get( 'SecretKey');if(!$secret){throw new RuntimeException("Cannot use MWCryptHKDF without a secret.");}$context=[microtime(), getmypid(), gethostname()];$cache=$services->getLocalServerObjectCache();if($cache instanceof EmptyBagOStuff){$cache=ObjectCache::getLocalClusterInstance();}return new CryptHKDF($secret, $config->get( 'HKDFAlgorithm'), $cache, $context, $services->getCryptRand());},'MediaHandlerFactory'=> function(MediaWikiServices $services){return new MediaHandlerFactory($services->getMainConfig() ->get( 'MediaHandlers'));},'MimeAnalyzer'=> function(MediaWikiServices $services){return new MimeMagic(MimeMagic::applyDefaultParameters([], $services->getMainConfig()));},'ProxyLookup'=> function(MediaWikiServices $services){$mainConfig=$services->getMainConfig();return new ProxyLookup($mainConfig->get( 'SquidServers'), $mainConfig->get( 'SquidServersNoPurge'));},'LinkCache'=> function(MediaWikiServices $services){return new LinkCache($services->getTitleFormatter(), ObjectCache::getMainWANInstance());},'LinkRendererFactory'=> function(MediaWikiServices $services){return new LinkRendererFactory($services->getTitleFormatter(), $services->getLinkCache());},'LinkRenderer'=> function(MediaWikiServices $services){global $wgUser;if(defined( 'MW_NO_SESSION')){return $services->getLinkRendererFactory() ->create();}else{return $services->getLinkRendererFactory() ->createForUser($wgUser);}},'GenderCache'=> function(MediaWikiServices $services){return new GenderCache();},'_MediaWikiTitleCodec'=> function(MediaWikiServices $services){global $wgContLang;return new MediaWikiTitleCodec($wgContLang, $services->getGenderCache(), $services->getMainConfig() ->get( 'LocalInterwikis'));},'TitleFormatter'=> function(MediaWikiServices $services){return $services->getService( '_MediaWikiTitleCodec');},'TitleParser'=> function(MediaWikiServices $services){return $services->getService( '_MediaWikiTitleCodec');},'MainObjectStash'=> function(MediaWikiServices $services){$mainConfig=$services->getMainConfig();$id=$mainConfig->get( 'MainStash');if(!isset($mainConfig->get( 'ObjectCaches')[$id])){throw new UnexpectedValueException("Cache type \"$id\" is not present in \$wgObjectCaches.");}return\ObjectCache::newFromParams($mainConfig->get( 'ObjectCaches')[$id]);},'MainWANObjectCache'=> function(MediaWikiServices $services){$mainConfig=$services->getMainConfig();$id=$mainConfig->get( 'MainWANCache');if(!isset($mainConfig->get( 'WANObjectCaches')[$id])){throw new UnexpectedValueException("WAN cache type \"$id\" is not present in \$wgWANObjectCaches.");}$params=$mainConfig->get( 'WANObjectCaches')[$id];$objectCacheId=$params['cacheId'];if(!isset($mainConfig->get( 'ObjectCaches')[$objectCacheId])){throw new UnexpectedValueException("Cache type \"$objectCacheId\" is not present in \$wgObjectCaches.");}$params['store']=$mainConfig->get( 'ObjectCaches')[$objectCacheId];return\ObjectCache::newWANCacheFromParams($params);},'LocalServerObjectCache'=> function(MediaWikiServices $services){$mainConfig=$services->getMainConfig();if(function_exists( 'apc_fetch')){$id= 'apc';}elseif(function_exists( 'apcu_fetch')){$id= 'apcu';}elseif(function_exists( 'xcache_get')&&wfIniGetBool( 'xcache.var_size')){$id= 'xcache';}elseif(function_exists( 'wincache_ucache_get')){$id= 'wincache';}else{$id=CACHE_NONE;}if(!isset($mainConfig->get( 'ObjectCaches')[$id])){throw new UnexpectedValueException("Cache type \"$id\" is not present in \$wgObjectCaches.");}return\ObjectCache::newFromParams($mainConfig->get( 'ObjectCaches')[$id]);},'VirtualRESTServiceClient'=> function(MediaWikiServices $services){$config=$services->getMainConfig() ->get( 'VirtualRestConfig');$vrsClient=new VirtualRESTServiceClient(new MultiHttpClient([]));foreach($config['paths'] as $prefix=> $serviceConfig){$class=$serviceConfig['class'];$constructArg=isset($serviceConfig['options'])?$serviceConfig['options']:[];$constructArg+=$config['global'];$vrsClient->mount($prefix, [ 'class'=> $class, 'config'=> $constructArg]);}return $vrsClient;},]
when a variable name is used in a function
parseFormattedNumber($number)
$wgTranslateNumerals
For Hindi and Arabic use local numerals instead of Western style (0-9) numerals in interface...
static isUtf8($value)
Test whether a string is valid UTF-8.
static $mWeekdayAbbrevMsgs
diff(ConvertibleTimestamp $relativeTo)
Calculate the difference between two ConvertibleTimestamp objects.
static newFromCode($code)
Create a language object for a given language code.
usually copyright or history_copyright This message must be in HTML not wikitext & $link
time($ts, $adj=false, $format=true, $timecorrection=false)
embedBidi($text= '')
Wraps argument with unicode control characters for directionality safety.
static getJsonMessagesFileName($code)
wfTimestamp($outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
$wgLanguageCode
Site language code.
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return true
formatSize($size)
Format a size in bytes for output, using an appropriate unit (B, KB, MB, GB, TB, PB, EB, ZB or YB) according to the magnitude in question.
semicolonList(array $list)
Take a list of strings and build a locale-friendly semicolon-separated list, using the local semicolo...
addMagicWordsByLang($newWords)
Add magic words to the extension array.
segmentForDiff($text)
languages like Chinese need to be segmented in order for the diff to be of any use ...
static $lre
Unicode directional formatting characters, for embedBidi()
convertHtml($text, $isTitle=false)
Perform output conversion on a string, and encode for safe HTML output.
ucwordbreaksCallbackAscii($matches)
static $mHijriCalendarMonthMsgs
ucwordsCallbackMB($matches)
linkPrefixCharset()
A regular expression character set to match legal word-prefixing characters which should be merged on...
static getMain()
Static methods.
getIranianCalendarMonthName($key)
LanguageConverter $mConverter
msg($msg)
Get message object in this language.
__destruct()
Reduce memory usage.
formatBitrate($bps)
Format a bitrate for output, using an appropriate unit (bps, kbps, Mbps, Gbps, Tbps, Pbps, Ebps, Zbps or Ybps) according to the magnitude in question.
truncateHtml($text, $length, $ellipsis= '...')
Truncate a string of valid HTML to a specified length in bytes, appending an optional string (e...
$wgLocalisationCacheConf
Localisation cache configuration.
getArrow($direction= 'forwards')
An arrow, depending on the language direction.
wfWarn($msg, $callerOffset=1, $level=E_USER_NOTICE)
Send a warning either to the debug log or in a PHP error depending on $wgDevelopmentWarnings.
static convertDoubleWidth($string)
convert double-width roman characters to single-width.
either a unescaped string or a HtmlArmor object after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a set this to the key of the message First element is the message additional optional elements are parameters for the key that are processed with wfMessage() -> params() ->parseAsBlock()-offset Set to overwrite offset parameter in $wgRequest set to ''to unsetoffset-wrap String Wrap the message in html(usually something like"<
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist removed from all revisions and log entries to which it was applied This gives extensions a chance to take it off their books as the deletion has already been partly carried out by this point or something similar the user will be unable to create the tag set and then return false from the hook function Ensure you consume the ChangeTagAfterDelete hook to carry out custom deletion actions as context called by AbstractContent::getParserOutput May be used to override the normal model specific rendering of page content as context as context $options
viewPrevNext(Title $title, $offset, $limit, array $query=[], $atend=false)
Generate (prev x| next x) (20|50|100...) type links for paging.
getConverter()
Return the LanguageConverter used in the Language.
static $mIranianCalendarMonthMsgs
static hebrewNumeral($num)
Hebrew Gematria number formatting up to 9999.
getFormattedNsText($index)
A convenience function that returns the same thing as getNsText() except with '_' changed to ' '...
getMonthAbbreviation($key)
getLocalURL($query= '', $query2=false)
Get a URL with no fragment or server name (relative URL) from a Title object.
static tsToHebrew($ts)
Converting Gregorian dates to Hebrew dates.
getBookstoreList()
Exports $wgBookstoreListEn.
listToText(array $l)
Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separa...
$wgDummyLanguageCodes
List of language codes that don't correspond to an actual language.
format($format)
Format the timestamp in a given format.
caseFold($s)
Return a case-folded representation of $s.
static getMessagesFileName($code)
$wgAllUnicodeFixes
Set this to always convert certain Unicode sequences to modern ones regardless of the content languag...
static isValidBuiltInCode($code)
Returns true if a language code is of a valid form for the purposes of internal customisation of Medi...
getTimestamp($style=TS_UNIX)
Get the timestamp represented by this object in a certain form.
static isValidCode($code)
Returns true if a language code string is of a valid form, whether or not it exists.
uc($str, $first=false)
Convert a string to uppercase.
static getMessagesFor($code)
Get all messages for a given language WARNING: this may take a long time.
ucwordbreaksCallbackMB($matches)
static $strongDirRegex
Directionality test regex for embedBidi().
needsGenderDistinction()
Whether this language uses gender-dependent namespace aliases.
wfIsInfinity($str)
Determine input string is represents as infinity.
getHebrewCalendarMonthNameGen($key)
const TS_MW
MediaWiki concatenated string timestamp (YYYYMMDDHHMMSS)
updateConversionTable(Title $title)
Refresh the cache of conversion tables when MediaWiki:Conversiontable* is updated.
convertTitle($title)
Convert a Title object to a string in the preferred variant.
convert($text)
convert text to different variants of a language.
wfBCP47($code)
Get the normalised IETF language tag See unit test for examples.
$wgMetaNamespaceTalk
Name of the project talk namespace.
namespace and then decline to actually register it file or subcat img or subcat $title
getVariantname($code, $usemsg=true)
short names for language variants used for language conversion links.
static getFileName($prefix= 'Language', $code, $suffix= '.php')
Get the name of a file for a certain language code.
formatDuration($seconds, array $chosenIntervals=[])
Takes a number of seconds and turns it into a text using values such as hours and minutes...
static run($event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
static getSuggestedDurations($lang=null)
Get an array of suggested block durations from MediaWiki:Ipboptions.
ucwordbreaks($str)
capitalize words at word breaks
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist removed from all revisions and log entries to which it was applied This gives extensions a chance to take it off their books $tag
userTime($ts, User $user, array $options=[])
Get the formatted time for the given timestamp and formatted for the given user.
static $mHebrewCalendarMonthMsgs
pipeList(array $list)
Same as commaList, but separate it with the pipe instead.
getMessageFromDB($msg)
Get a message from the MediaWiki namespace.
formatNum($number, $nocommafy=false)
Normally we output all numbers in plain en_US style, that is 293,291.235 for twohundredninetythreetho...
$mExtendedSpecialPageAliases
namespace and then decline to actually register it & $namespaces
This document is intended to provide useful advice for parties seeking to redistribute MediaWiki to end users It s targeted particularly at maintainers for Linux since it s been observed that distribution packages of MediaWiki often break We ve consistently had to recommend that users seeking support use official tarballs instead of their distribution s and this often solves whatever problem the user is having It would be nice if this could such as
getPluralRules()
Get the plural rules for the language.
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable & $code
static fetchLanguageName($code, $inLanguage=null, $include= 'all')
resetNamespaces()
Resets all of the namespace caches.
please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account $user
static MapCacheLRU null $grammarTransformations
Cache for grammar rules data.
segmentByWord($string)
Some languages such as Chinese require word segmentation, Specify such segmentation when overridden i...
getMagicWords()
Get all magic words from cache.
getGrammarTransformations()
Get the grammar transformations data for the language.
numLink(Title $title, $offset, $limit, array $query, $link, $tooltipMsg, $class)
Helper function for viewPrevNext() that generates links.
ucfirst($str)
Make a string's first character uppercase.
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist removed from all revisions and log entries to which it was applied This gives extensions a chance to take it off their books as the deletion has already been partly carried out by this point or something similar the user will be unable to create the tag set and then return false from the hook function Ensure you consume the ChangeTagAfterDelete hook to carry out custom deletion actions as context called by AbstractContent::getParserOutput May be used to override the normal model specific rendering of page content as context as context the output can only depend on parameters provided to this hook not on global state indicating whether full HTML should be generated If generation of HTML may be but other information should still be present in the ParserOutput object to manipulate or replace but no entry for that model exists in $wgContentHandlers if desired whether it is OK to use $contentModel on $title Handler functions that modify $ok should generally return false to prevent further hooks from further modifying $ok inclusive false for true for descending in case the handler function wants to provide a converted Content object Note that $result getContentModel() must return $toModel. 'CustomEditor'$rcid is used in generating this variable which contains information about the new such as the revision s whether the revision was marked as a minor edit or not
getOption($oname, $defaultOverride=null, $ignoreHidden=false)
Get the user's current setting for a given option.
getHijriCalendarMonthName($key)
static getFallbackFor($code)
Get the first fallback for a given language.
timeanddate($ts, $adj=false, $format=true, $timecorrection=false)
getPluralRuleType($number)
Find the plural rule type appropriate for the given number For example, if the language is set to Ara...
userAdjust($ts, $tz=false)
Used by date() and time() to adjust the time output.
userDate($ts, User $user, array $options=[])
Get the formatted date for the given timestamp and formatted for the given user.
getConvRuleTitle()
Get the conversion rule title, if any.
getMagic($mw)
Fill a MagicWord object with data from here.
static classFromCode($code)
$wgExtraNamespaces
Additional namespaces.
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
getHumanTimestampInternal(MWTimestamp $ts, MWTimestamp $relativeTo, User $user)
Convert an MWTimestamp into a pretty human-readable timestamp using the given user preferences and re...
getCode()
Get the internal language code for this language object.
replaceGrammarInNamespace($m)
commafy($number)
Adds commas to a given number.
sprintfDate($format, $ts, DateTimeZone $zone=null, &$ttl= 'unused')
This is a workalike of PHP's date() function, but with better internationalisation, a reduced set of format characters, and a better escaping format.
userTimeAndDate($ts, User $user, array $options=[])
Get the formatted date and time for the given timestamp and formatted for the given user...
translateBlockExpiry($str, User $user=null)
truncate($string, $length, $ellipsis= '...', $adjustLength=true)
Truncate a string to a specified length in bytes, appending an optional string (e.g.
static romanNumeral($num)
Roman number formatting up to 10000.
convertForSearchResult($termsArray)
removeBadCharLast($string)
Remove bytes that represent an incomplete Unicode character at the end of string (e.g.
static tsToIranian($ts)
Algorithm by Roozbeh Pournader and Mohammad Toossi to convert Gregorian dates to Iranian dates...
$transformData
ReplacementArray object caches.
specialList($page, $details, $oppositedm=true)
Make a list item, used by various special pages.
getExtraHashOptions()
returns language specific options used by User::getPageRenderHash() for example, the preferred langua...
getParsedTitle()
For languages that support multiple variants, the title of an article may be displayed differently in...
preConvertPlural($forms, $count)
Checks that convertPlural was given an array and pads it to requested amount of forms by copying the ...
findVariantLink(&$link, &$nt, $ignoreOtherCond=false)
If a language supports multiple variants, it is possible that non-existing link in one variant actual...
$wgGrammarForms
Some languages need different word forms, usually for different cases.
emphasize($text)
Italic is unsuitable for some languages.
getDirMarkEntity($opposite=false)
A hidden direction mark (LRM or RLM), depending on the language direction.
separatorTransformTable()
isRTL()
For right-to-left language support.
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist removed from all revisions and log entries to which it was applied This gives extensions a chance to take it off their books as the deletion has already been partly carried out by this point or something similar the user will be unable to create the tag set and then return false from the hook function Ensure you consume the ChangeTagAfterDelete hook to carry out custom deletion actions as context called by AbstractContent::getParserOutput May be used to override the normal model specific rendering of page content as context as context the output can only depend on parameters provided to this hook not on global state indicating whether full HTML should be generated If generation of HTML may be but other information should still be present in the ParserOutput object to manipulate or replace but no entry for that model exists in $wgContentHandlers if desired whether it is OK to use $contentModel on $title Handler functions that modify $ok should generally return false to prevent further hooks from further modifying $ok inclusive $limit
getDatePreference()
Get the user's preferred date format.
getParentLanguage()
Get the "parent" language which has a converter to convert a "compatible" language (in another varian...
getDir()
Return the correct HTML 'dir' attribute value for this language.
getFormattedNamespaces()
A convenience function that returns getNamespaces() with spaces instead of underscores in values...
$wgLocalTZoffset
Set an offset from UTC in minutes to use for the default timezone setting for anonymous users and new...
normalizeForSearch($string)
Some languages have special punctuation need to be normalized.
getDurationIntervals($seconds, array $chosenIntervals=[])
Takes a number of seconds and returns an array with a set of corresponding intervals.
linkPrefixExtension()
To allow "foo[[bar]]" to extend the link over the whole word "foobar".
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring which defines all default service and specifies how they depend on each other("wiring").When a new service is added to MediaWiki core
getGrammarForms()
Get the grammar forms for the content language.
static dateTimeObjFormat(&$dateTimeObj, $ts, $zone, $code)
Pass through result from $dateTimeObj->format()
=Architecture==Two class hierarchies are used to provide the functionality associated with the different content models:*Content interface(and AbstractContent base class) define functionality that acts on the concrete content of a page, and *ContentHandler base class provides functionality specific to a content model, but not acting on concrete content.The most important function of ContentHandler is to act as a factory for the appropriate implementation of Content.These Content objects are to be used by MediaWiki everywhere, instead of passing page content around as text.All manipulation and analysis of page content must be done via the appropriate methods of the Content object.For each content model, a subclass of ContentHandler has to be registered with $wgContentHandlers.The ContentHandler object for a given content model can be obtained using ContentHandler::getForModelID($id).Also Title, WikiPage and Revision now have getContentHandler() methods for convenience.ContentHandler objects are singletons that provide functionality specific to the content type, but not directly acting on the content of some page.ContentHandler::makeEmptyContent() and ContentHandler::unserializeContent() can be used to create a Content object of the appropriate type.However, it is recommended to instead use WikiPage::getContent() resp.Revision::getContent() to get a page's content as a Content object.These two methods should be the ONLY way in which page content is accessed.Another important function of ContentHandler objects is to define custom action handlers for a content model, see ContentHandler::getActionOverrides().This is similar to what WikiPage::getActionOverrides() was already doing.==Serialization==With the ContentHandler facility, page content no longer has to be text based.Objects implementing the Content interface are used to represent and handle the content internally.For storage and data exchange, each content model supports at least one serialization format via ContentHandler::serializeContent($content).The list of supported formats for a given content model can be accessed using ContentHandler::getSupportedFormats().Content serialization formats are identified using MIME type like strings.The following formats are built in:*text/x-wiki-wikitext *text/javascript-for js pages *text/css-for css pages *text/plain-for future use, e.g.with plain text messages.*text/html-for future use, e.g.with plain html messages.*application/vnd.php.serialized-for future use with the api and for extensions *application/json-for future use with the api, and for use by extensions *application/xml-for future use with the api, and for use by extensions In PHP, use the corresponding CONTENT_FORMAT_XXX constant.Note that when using the API to access page content, especially action=edit, action=parse and action=query &prop=revisions, the model and format of the content should always be handled explicitly.Without that information, interpretation of the provided content is not reliable.The same applies to XML dumps generated via maintenance/dumpBackup.php or Special:Export.Also note that the API will provide encapsulated, serialized content-so if the API was called with format=json, and contentformat is also json(or rather, application/json), the page content is represented as a string containing an escaped json structure.Extensions that use JSON to serialize some types of page content may provide specialized API modules that allow access to that content in a more natural form.==Compatibility==The ContentHandler facility is introduced in a way that should allow all existing code to keep functioning at least for pages that contain wikitext or other text based content.However, a number of functions and hooks have been deprecated in favor of new versions that are aware of the page's content model, and will now generate warnings when used.Most importantly, the following functions have been deprecated:*Revisions::getText() is deprecated in favor Revisions::getContent()*WikiPage::getText() is deprecated in favor WikiPage::getContent() Also, the old Article::getContent()(which returns text) is superceded by Article::getContentObject().However, both methods should be avoided since they do not provide clean access to the page's actual content.For instance, they may return a system message for non-existing pages.Use WikiPage::getContent() instead.Code that relies on a textual representation of the page content should eventually be rewritten.However, ContentHandler::getContentText() provides a stop-gap that can be used to get text for a page.Its behavior is controlled by $wgContentHandlerTextFallback it
getGenderNsText($index, $gender)
Returns gender-dependent namespace alias if available.
static getDefaultOption($opt)
Get a given default option value.
initContLang()
Hook which will be called if this is the content language.
static factory($code)
Get a cached or new language object for a given language code.
fixVariableInNamespace($talk)
getNamespaces()
Returns an array of localised namespaces indexed by their numbers.
wfGetPrecompiledData($name)
Get an object from the precompiled serialized directory.
gender($gender, $forms)
Provides an alternative text depending on specified gender.
commaList(array $list)
Take a list of strings and build a locale-friendly comma-separated list, using the local comma-separa...
static $mHebrewCalendarMonthGenMsgs
static array $languagesWithVariants
languages supporting variants
static element($element, $attribs=[], $contents= '')
Identical to rawElement(), but HTML-escapes $contents (like Xml::element()).
static getCanonicalIndex($name)
Returns the index for a given canonical name, or NULL The input must be converted to lower case first...
static getCanonicalNamespaces($rebuild=false)
Returns array of all defined namespaces with their canonical (English) names.
getMonthAbbreviationsArray()
Library for creating and parsing MW-style timestamps.
do that in ParserLimitReportFormat instead use this to modify the parameters of the image and a DIV can begin in one section and end in another Make sure your code can handle that case gracefully See the EditSectionClearerLink extension for an example zero but section is usually empty its values are the globals values before the output is cached one of or reset my talk my contributions etc etc otherwise the built in rate limiting checks are if enabled allows for interception of redirect as a string mapping parameter names to values & $type
hasWordBreaks()
Most writing systems use whitespace to break up words.
static strongDirFromContent($text= '')
Gets directionality of the first strongly directional codepoint, for embedBidi()
static isSupportedLanguage($code)
Checks whether any localisation is available for that language tag in MediaWiki (MessagesXx.php exists).
alignStart()
Return 'left' or 'right' as appropriate alignment for line-start for this language's text direction...
static tsToYear($ts, $cName)
Algorithm to convert Gregorian dates to Thai solar dates, Minguo dates or Minguo dates.
getPluralRuleIndexNumber($number)
Find the index number of the plural rule appropriate for the given number.
see documentation in includes Linker php for Linker::makeImageLink & $time
static hebrewYearStart($year)
This calculates the Hebrew year start, as days since 1 September.
do that in ParserLimitReportFormat instead use this to modify the parameters of the image and a DIV can begin in one section and end in another Make sure your code can handle that case gracefully See the EditSectionClearerLink extension for an example zero but section is usually empty its values are the globals values before the output is cached $page
getHebrewCalendarMonthName($key)
unsegmentForDiff($text)
and unsegment to show the result
Allows to change the fields on the form that will be generated $name