Linux anchor 4.4.0-210-generic #242-Ubuntu SMP Fri Apr 16 09:57:56 UTC 2021 x86_64
Apache/2.4.18 (Ubuntu)
Server IP : 10.10.100.4 & Your IP : 216.73.217.150
Domains :
Cant Read [ /etc/named.conf ]
User : www-data
Terminal
Auto Root
Create File
Create Folder
Localroot Suggester
Backdoor Destroyer
Readme
/
var /
www /
wiki.bernardino.org /
includes /
Delete
Unzip
Name
Size
Permission
Date
Action
actions
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
api
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
auth
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
cache
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
changes
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
changetags
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
clientpool
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
collation
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
compat
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
composer
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
config
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
content
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
context
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
dao
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
db
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
debug
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
deferred
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
diff
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
exception
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
export
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
extauth
[ DIR ]
drwxr-xr-x
2012-03-22 16:23
externalstore
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
filebackend
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
filerepo
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
gallery
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
htmlform
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
http
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
import
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
installer
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
interwiki
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
job
[ DIR ]
drwxr-xr-x
2012-03-22 16:23
jobqueue
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
json
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
libs
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
linker
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
logging
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
mail
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
media
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
normal
[ DIR ]
drwxr-xr-x
2012-03-22 16:23
objectcache
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
page
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
pager
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
parser
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
password
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
poolcounter
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
profiler
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
rcfeed
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
registration
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
resourceloader
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
revisiondelete
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
search
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
services
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
session
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
site
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
skins
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
specialpage
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
specials
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
templates
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
tidy
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
title
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
upload
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
user
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
utils
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
widget
[ DIR ]
drwxr-xr-x
2016-11-28 20:20
zhtable
[ DIR ]
drwxr-xr-x
2012-03-22 16:23
.htaccess
197
B
-r--r--r--
2026-08-22 08:29
Action.php
12.43
KB
-rw-r--r--
2011-09-16 17:01
AjaxDispatcher.php
4.03
KB
-rw-r--r--
2016-11-28 20:20
AjaxResponse.php
8.15
KB
-rw-r--r--
2016-11-28 20:20
Article.php
58.64
KB
-rw-r--r--
2011-11-15 20:46
AuthPlugin.php
9.2
KB
-rw-r--r--
2016-11-28 20:20
AutoLoader.php
3
KB
-rw-r--r--
2016-11-28 20:20
Autopromote.php
6.77
KB
-rw-r--r--
2016-11-28 20:20
BacklinkCache.php
9.03
KB
-rw-r--r--
2011-06-30 01:09
Block.php
41.97
KB
-rw-r--r--
2016-11-28 20:20
Category.php
10.34
KB
-rw-r--r--
2016-11-28 20:20
CategoryFinder.php
6.2
KB
-rw-r--r--
2016-11-28 20:20
CategoryPage.php
21.84
KB
-rw-r--r--
2011-10-28 23:20
CategoryViewer.php
22.5
KB
-rw-r--r--
2016-11-28 20:20
Categoryfinder.php
5.13
KB
-rw-r--r--
2011-05-19 02:03
Cdb.php
3.57
KB
-rw-r--r--
2011-05-28 20:58
Cdb_PHP.php
10.11
KB
-rw-r--r--
2011-05-28 19:51
ChangeTags.php
6.66
KB
-rw-r--r--
2011-07-09 11:01
ChangesFeed.php
5.82
KB
-rw-r--r--
2011-06-19 07:45
ChangesList.php
35.52
KB
-rw-r--r--
2011-10-25 23:51
Collation.php
9.86
KB
-rw-r--r--
2011-09-21 00:36
ConfEditor.php
29.16
KB
-rw-r--r--
2011-08-27 21:28
Cookie.php
6.17
KB
-rw-r--r--
2011-06-02 00:35
CryptRand.php
16.96
KB
-rw-r--r--
2012-03-21 11:43
DefaultSettings.php
265.47
KB
-rw-r--r--
2016-11-28 20:20
Defines.php
7.85
KB
-rw-r--r--
2016-11-28 20:20
DeprecatedGlobal.php
1.9
KB
-rw-r--r--
2016-11-28 20:20
DerivativeRequest.php
2.46
KB
-rw-r--r--
2016-11-28 20:20
DjVuImage.php
10.58
KB
-rw-r--r--
2011-05-18 00:03
DummyLinker.php
9.01
KB
-rw-r--r--
2016-11-28 20:20
EditPage.php
136.53
KB
-rw-r--r--
2016-11-28 20:20
EventRelayerGroup.php
1.27
KB
-rw-r--r--
2016-11-28 20:20
Exception.php
11.5
KB
-rw-r--r--
2011-10-22 04:34
Export.php
32.27
KB
-rw-r--r--
2011-11-24 02:29
ExternalEdit.php
2.45
KB
-rw-r--r--
2011-09-07 22:14
ExternalStore.php
4.29
KB
-rw-r--r--
2011-05-29 16:24
ExternalStoreDB.php
4.44
KB
-rw-r--r--
2011-10-17 00:24
ExternalStoreHttp.php
463
B
-rw-r--r--
2010-01-08 22:35
ExternalUser.php
8.96
KB
-rw-r--r--
2011-05-26 21:52
FakeTitle.php
6.6
KB
-rw-r--r--
2011-05-26 22:38
Fallback.php
5.49
KB
-rw-r--r--
2011-05-28 20:58
FauxRequest.php
5.66
KB
-rw-r--r--
2016-11-28 20:20
Feed.php
10.58
KB
-rw-r--r--
2016-11-28 20:20
FeedUtils.php
8.64
KB
-rw-r--r--
2016-11-28 20:20
FileDeleteForm.php
11.7
KB
-rw-r--r--
2016-11-28 20:20
ForkController.php
5.4
KB
-rw-r--r--
2016-11-28 20:20
FormOptions.php
11.08
KB
-rw-r--r--
2016-11-28 20:20
GenderCache.php
3.35
KB
-rw-r--r--
2011-09-19 14:58
GitInfo.php
10.74
KB
-rw-r--r--
2016-11-28 20:20
GlobalFunctions.php
106.76
KB
-rw-r--r--
2016-11-28 20:20
HTMLForm.php
49.55
KB
-rw-r--r--
2011-11-09 18:04
HistoryBlob.php
16.15
KB
-rw-r--r--
2016-11-28 20:20
HistoryPage.php
21.66
KB
-rw-r--r--
2011-09-16 16:12
Hooks.php
6.47
KB
-rw-r--r--
2016-11-28 20:20
Html.php
31.91
KB
-rw-r--r--
2016-11-28 20:20
HtmlFormatter.php
1015
B
-rw-r--r--
2016-11-28 20:20
HttpFunctions.old.php
319
B
-rw-r--r--
2011-05-28 17:59
HttpFunctions.php
21.28
KB
-rw-r--r--
2011-09-16 15:19
IP.php
21.58
KB
-rw-r--r--
2011-11-09 16:00
ImageFunctions.php
2.58
KB
-rw-r--r--
2011-05-29 16:24
ImageGallery.php
10.46
KB
-rw-r--r--
2011-07-16 01:18
ImagePage.php
36
KB
-rw-r--r--
2011-07-11 02:39
ImageQueryPage.php
1.5
KB
-rw-r--r--
2011-05-26 21:21
Import.php
33.63
KB
-rw-r--r--
2011-10-28 23:20
Init.php
4.67
KB
-rw-r--r--
2011-06-17 01:40
Licenses.php
4.89
KB
-rw-r--r--
2016-11-28 20:20
LinkFilter.php
6.08
KB
-rw-r--r--
2016-11-28 20:20
Linker.php
72.71
KB
-rw-r--r--
2016-11-28 20:20
LinksUpdate.php
23.7
KB
-rw-r--r--
2011-11-14 21:58
ListToggle.php
2.02
KB
-rw-r--r--
2016-11-28 20:20
LocalisationCache.php
29.31
KB
-rw-r--r--
2011-09-12 17:03
LogEventsList.php
32.56
KB
-rw-r--r--
2011-07-10 20:12
LogPage.php
16.09
KB
-rw-r--r--
2011-07-10 20:12
MWFunction.php
1.96
KB
-rw-r--r--
2011-03-22 21:23
MWGrants.php
5.85
KB
-rw-r--r--
2016-11-28 20:20
MWNamespace.php
13.76
KB
-rw-r--r--
2016-11-28 20:20
MWTimestamp.php
6.1
KB
-rw-r--r--
2016-11-28 20:20
MagicWord.php
15.1
KB
-rw-r--r--
2016-11-28 20:20
MagicWordArray.php
7.86
KB
-rw-r--r--
2016-11-28 20:20
MediaWiki.php
35.29
KB
-rw-r--r--
2016-11-28 20:20
MediaWikiServices.php
18.8
KB
-rw-r--r--
2016-11-28 20:20
MediaWikiVersionFetcher.php
746
B
-rw-r--r--
2016-11-28 20:20
MergeHistory.php
10.41
KB
-rw-r--r--
2016-11-28 20:20
Message.php
32.49
KB
-rw-r--r--
2016-11-28 20:20
MessageBlobStore.php
10.5
KB
-rw-r--r--
2011-05-28 00:42
Metadata.php
5.53
KB
-rw-r--r--
2011-06-30 00:09
MimeMagic.php
2.87
KB
-rw-r--r--
2016-11-28 20:20
MovePage.php
18.08
KB
-rw-r--r--
2016-11-28 20:20
Namespace.php
7.78
KB
-rw-r--r--
2011-05-21 21:07
NoLocalSettings.php
2.03
KB
-rw-r--r--
2016-11-28 20:20
OutputHandler.php
6.19
KB
-rw-r--r--
2016-11-28 20:20
OutputPage.php
113
KB
-rw-r--r--
2016-11-28 20:20
PHPVersionCheck.php
8.52
KB
-rw-r--r--
2016-11-28 20:20
PHPVersionError.php
2.96
KB
-rw-r--r--
2011-07-19 01:06
PageProps.php
8.52
KB
-rw-r--r--
2016-11-28 20:20
PageQueryPage.php
680
B
-rw-r--r--
2010-12-22 15:16
Pager.php
30.89
KB
-rw-r--r--
2011-07-06 04:26
PathRouter.php
12.43
KB
-rw-r--r--
2016-11-28 20:20
PatrolLog.php
2.53
KB
-rw-r--r--
2011-07-10 20:12
Pingback.php
7.31
KB
-rw-r--r--
2016-11-28 20:20
PoolCounter.php
5.65
KB
-rw-r--r--
2011-05-28 21:00
Preferences.php
51.21
KB
-rw-r--r--
2016-11-28 20:20
PrefixSearch.php
12.36
KB
-rw-r--r--
2016-11-28 20:20
ProtectionForm.php
19.56
KB
-rw-r--r--
2016-11-28 20:20
ProxyLookup.php
2.12
KB
-rw-r--r--
2016-11-28 20:20
ProxyTools.php
4.6
KB
-rw-r--r--
2011-09-07 22:14
QueryPage.php
22.76
KB
-rw-r--r--
2011-10-17 00:24
RawPage.php
6.2
KB
-rw-r--r--
2011-07-05 23:28
RecentChange.php
23.52
KB
-rw-r--r--
2011-08-27 21:28
RequestContext.php
7.85
KB
-rw-r--r--
2012-01-04 02:07
Revision.php
54.61
KB
-rw-r--r--
2016-11-28 20:20
RevisionList.php
9.25
KB
-rw-r--r--
2016-11-28 20:20
Sanitizer.php
58.04
KB
-rw-r--r--
2016-11-28 20:20
SeleniumWebSettings.php
6.3
KB
-rw-r--r--
2011-06-26 01:27
ServiceWiring.php
11.72
KB
-rw-r--r--
2016-11-28 20:20
Setup.php
27.89
KB
-rw-r--r--
2016-11-28 20:20
SiteConfiguration.php
18.34
KB
-rw-r--r--
2016-11-28 20:20
SiteStats.php
9.85
KB
-rw-r--r--
2016-11-28 20:20
Skin.php
42.13
KB
-rw-r--r--
2012-02-25 16:23
SkinLegacy.php
22.82
KB
-rw-r--r--
2011-10-20 22:50
SkinTemplate.php
64.93
KB
-rw-r--r--
2011-12-09 21:31
SpecialPage.php
31.23
KB
-rw-r--r--
2012-01-04 02:07
SpecialPageFactory.php
17.68
KB
-rw-r--r--
2011-10-28 23:20
SquidPurgeClient.php
10.02
KB
-rw-r--r--
2011-05-21 21:54
Status.php
12.63
KB
-rw-r--r--
2016-11-28 20:20
StreamFile.php
4.66
KB
-rw-r--r--
2016-11-28 20:20
StringUtils.php
11.32
KB
-rw-r--r--
2011-05-21 21:54
StubObject.php
6.4
KB
-rw-r--r--
2016-11-28 20:20
TemplateParser.php
6.46
KB
-rw-r--r--
2016-11-28 20:20
TemplatesOnThisPageFormatter.php
5.36
KB
-rw-r--r--
2016-11-28 20:20
Title.php
140.81
KB
-rw-r--r--
2016-11-28 20:20
TitleArray.php
1.83
KB
-rw-r--r--
2016-11-28 20:20
TitleArrayFromResult.php
1.95
KB
-rw-r--r--
2016-11-28 20:20
User.php
114.26
KB
-rw-r--r--
2012-03-21 11:43
UserArray.php
1.9
KB
-rw-r--r--
2011-05-28 17:59
UserMailer.php
20.52
KB
-rw-r--r--
2012-02-02 15:15
UserRightsProxy.php
5.38
KB
-rw-r--r--
2010-10-14 01:11
ViewCountUpdate.php
3.4
KB
-rw-r--r--
2011-06-25 21:13
WatchedItem.php
5.04
KB
-rw-r--r--
2016-11-28 20:20
WatchedItemQueryService.php
20.4
KB
-rw-r--r--
2016-11-28 20:20
WatchedItemStore.php
25.57
KB
-rw-r--r--
2016-11-28 20:20
WebRequest.php
37.68
KB
-rw-r--r--
2016-11-28 20:20
WebRequestUpload.php
3.4
KB
-rw-r--r--
2016-11-28 20:20
WebResponse.php
9.2
KB
-rw-r--r--
2016-11-28 20:20
WebStart.php
5.54
KB
-rw-r--r--
2016-11-28 20:20
Wiki.php
20.05
KB
-rw-r--r--
2012-01-03 18:34
WikiCategoryPage.php
898
B
-rw-r--r--
2011-08-27 21:28
WikiError.php
3.84
KB
-rw-r--r--
2011-05-06 23:09
WikiFilePage.php
3.34
KB
-rw-r--r--
2011-07-01 22:07
WikiMap.php
8.19
KB
-rw-r--r--
2016-11-28 20:20
WikiPage.php
78.59
KB
-rw-r--r--
2012-01-12 23:09
Xml.php
26.47
KB
-rw-r--r--
2016-11-28 20:20
XmlSelect.php
3.46
KB
-rw-r--r--
2016-11-28 20:20
XmlTypeCheck.php
2.45
KB
-rw-r--r--
2011-05-21 21:36
ZhClient.php
2.92
KB
-rw-r--r--
2011-05-29 16:25
ZhConversion.php
415
KB
-rw-r--r--
2011-10-27 23:40
ZipDirectoryReader.php
20.35
KB
-rw-r--r--
2011-05-13 18:16
limit.sh
2.86
KB
-rwxr-xr-x
2016-11-28 20:20
mime.info
3.82
KB
-rw-r--r--
2011-06-29 22:31
mime.types
5.18
KB
-rw-r--r--
2011-06-29 22:31
tidy.conf
413
B
-rw-r--r--
2009-10-25 14:43
wp-blog-header.php
2.74
KB
-r--r--r--
2026-08-22 08:29
wp-cron.php
2.74
KB
-rw-r--r--
2026-08-22 08:29
Save
Rename
<?php /** * Fetching and processing of interface messages. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License along * with this program; if not, write to the Free Software Foundation, Inc., * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * http://www.gnu.org/copyleft/gpl.html * * @file * @author Niklas Laxström */ /** * The Message class provides methods which fulfil two basic services: * - fetching interface messages * - processing messages into a variety of formats * * First implemented with MediaWiki 1.17, the Message class is intended to * replace the old wfMsg* functions that over time grew unusable. * @see https://www.mediawiki.org/wiki/Manual:Messages_API for equivalences * between old and new functions. * * You should use the wfMessage() global function which acts as a wrapper for * the Message class. The wrapper let you pass parameters as arguments. * * The most basic usage cases would be: * * @code * // Initialize a Message object using the 'some_key' message key * $message = wfMessage( 'some_key' ); * * // Using two parameters those values are strings 'value1' and 'value2': * $message = wfMessage( 'some_key', * 'value1', 'value2' * ); * @endcode * * @section message_global_fn Global function wrapper: * * Since wfMessage() returns a Message instance, you can chain its call with * a method. Some of them return a Message instance too so you can chain them. * You will find below several examples of wfMessage() usage. * * Fetching a message text for interface message: * * @code * $button = Xml::button( * wfMessage( 'submit' )->text() * ); * @endcode * * A Message instance can be passed parameters after it has been constructed, * use the params() method to do so: * * @code * wfMessage( 'welcome-to' ) * ->params( $wgSitename ) * ->text(); * @endcode * * {{GRAMMAR}} and friends work correctly: * * @code * wfMessage( 'are-friends', * $user, $friend * ); * wfMessage( 'bad-message' ) * ->rawParams( '<script>...</script>' ) * ->escaped(); * @endcode * * @section message_language Changing language: * * Messages can be requested in a different language or in whatever current * content language is being used. The methods are: * - Message->inContentLanguage() * - Message->inLanguage() * * Sometimes the message text ends up in the database, so content language is * needed: * * @code * wfMessage( 'file-log', * $user, $filename * )->inContentLanguage()->text(); * @endcode * * Checking whether a message exists: * * @code * wfMessage( 'mysterious-message' )->exists() * // returns a boolean whether the 'mysterious-message' key exist. * @endcode * * If you want to use a different language: * * @code * $userLanguage = $user->getOption( 'language' ); * wfMessage( 'email-header' ) * ->inLanguage( $userLanguage ) * ->plain(); * @endcode * * @note You can parse the text only in the content or interface languages * * @section message_compare_old Comparison with old wfMsg* functions: * * Use full parsing: * * @code * // old style: * wfMsgExt( 'key', [ 'parseinline' ], 'apple' ); * // new style: * wfMessage( 'key', 'apple' )->parse(); * @endcode * * Parseinline is used because it is more useful when pre-building HTML. * In normal use it is better to use OutputPage::(add|wrap)WikiMsg. * * Places where HTML cannot be used. {{-transformation is done. * @code * // old style: * wfMsgExt( 'key', [ 'parsemag' ], 'apple', 'pear' ); * // new style: * wfMessage( 'key', 'apple', 'pear' )->text(); * @endcode * * Shortcut for escaping the message too, similar to wfMsgHTML(), but * parameters are not replaced after escaping by default. * @code * $escaped = wfMessage( 'key' ) * ->rawParams( 'apple' ) * ->escaped(); * @endcode * * @section message_appendix Appendix: * * @todo * - test, can we have tests? * - this documentation needs to be extended * * @see https://www.mediawiki.org/wiki/WfMessage() * @see https://www.mediawiki.org/wiki/New_messages_API * @see https://www.mediawiki.org/wiki/Localisation * * @since 1.17 */ class Message implements MessageSpecifier, Serializable { /** * In which language to get this message. True, which is the default, * means the current user language, false content language. * * @var bool */ protected $interface = true; /** * In which language to get this message. Overrides the $interface setting. * * @var Language|bool Explicit language object, or false for user language */ protected $language = false; /** * @var string The message key. If $keysToTry has more than one element, * this may change to one of the keys to try when fetching the message text. */ protected $key; /** * @var string[] List of keys to try when fetching the message. */ protected $keysToTry; /** * @var array List of parameters which will be substituted into the message. */ protected $parameters = []; /** * Format for the message. * Supported formats are: * * text (transform) * * escaped (transform+htmlspecialchars) * * block-parse * * parse (default) * * plain * * @var string */ protected $format = 'parse'; /** * @var bool Whether database can be used. */ protected $useDatabase = true; /** * @var Title Title object to use as context. */ protected $title = null; /** * @var Content Content object representing the message. */ protected $content = null; /** * @var string */ protected $message; /** * @since 1.17 * @param string|string[]|MessageSpecifier $key Message key, or array of * message keys to try and use the first non-empty message for, or a * MessageSpecifier to copy from. * @param array $params Message parameters. * @param Language $language [optional] Language to use (defaults to current user language). * @throws InvalidArgumentException */ public function __construct( $key, $params = [], Language $language = null ) { if ( $key instanceof MessageSpecifier ) { if ( $params ) { throw new InvalidArgumentException( '$params must be empty if $key is a MessageSpecifier' ); } $params = $key->getParams(); $key = $key->getKey(); } if ( !is_string( $key ) && !is_array( $key ) ) { throw new InvalidArgumentException( '$key must be a string or an array' ); } $this->keysToTry = (array)$key; if ( empty( $this->keysToTry ) ) { throw new InvalidArgumentException( '$key must not be an empty list' ); } $this->key = reset( $this->keysToTry ); $this->parameters = array_values( $params ); // User language is only resolved in getLanguage(). This helps preserve the // semantic intent of "user language" across serialize() and unserialize(). $this->language = $language ?: false; } /** * @see Serializable::serialize() * @since 1.26 * @return string */ public function serialize() { return serialize( [ 'interface' => $this->interface, 'language' => $this->language ? $this->language->getCode() : false, 'key' => $this->key, 'keysToTry' => $this->keysToTry, 'parameters' => $this->parameters, 'format' => $this->format, 'useDatabase' => $this->useDatabase, 'title' => $this->title, ] ); } /** * @see Serializable::unserialize() * @since 1.26 * @param string $serialized */ public function unserialize( $serialized ) { $data = unserialize( $serialized ); $this->interface = $data['interface']; $this->key = $data['key']; $this->keysToTry = $data['keysToTry']; $this->parameters = $data['parameters']; $this->format = $data['format']; $this->useDatabase = $data['useDatabase']; $this->language = $data['language'] ? Language::factory( $data['language'] ) : false; $this->title = $data['title']; } /** * @since 1.24 * * @return bool True if this is a multi-key message, that is, if the key provided to the * constructor was a fallback list of keys to try. */ public function isMultiKey() { return count( $this->keysToTry ) > 1; } /** * @since 1.24 * * @return string[] The list of keys to try when fetching the message text, * in order of preference. */ public function getKeysToTry() { return $this->keysToTry; } /** * Returns the message key. * * If a list of multiple possible keys was supplied to the constructor, this method may * return any of these keys. After the message has been fetched, this method will return * the key that was actually used to fetch the message. * * @since 1.21 * * @return string */ public function getKey() { return $this->key; } /** * Returns the message parameters. * * @since 1.21 * * @return array */ public function getParams() { return $this->parameters; } /** * Returns the message format. * * @since 1.21 * * @return string */ public function getFormat() { return $this->format; } /** * Returns the Language of the Message. * * @since 1.23 * * @return Language */ public function getLanguage() { // Defaults to false which means current user language return $this->language ?: RequestContext::getMain()->getLanguage(); } /** * Factory function that is just wrapper for the real constructor. It is * intended to be used instead of the real constructor, because it allows * chaining method calls, while new objects don't. * * @since 1.17 * * @param string|string[]|MessageSpecifier $key * @param mixed $param,... Parameters as strings. * * @return Message */ public static function newFromKey( $key /*...*/ ) { $params = func_get_args(); array_shift( $params ); return new self( $key, $params ); } /** * Transform a MessageSpecifier or a primitive value used interchangeably with * specifiers (a message key string, or a key + params array) into a proper Message. * * Also accepts a MessageSpecifier inside an array: that's not considered a valid format * but is an easy error to make due to how StatusValue stores messages internally. * Further array elements are ignored in that case. * * @param string|array|MessageSpecifier $value * @return Message * @throws InvalidArgumentException * @since 1.27 */ public static function newFromSpecifier( $value ) { $params = []; if ( is_array( $value ) ) { $params = $value; $value = array_shift( $params ); } if ( $value instanceof Message ) { // Message, RawMessage, ApiMessage, etc $message = clone( $value ); } elseif ( $value instanceof MessageSpecifier ) { $message = new Message( $value ); } elseif ( is_string( $value ) ) { $message = new Message( $value, $params ); } else { throw new InvalidArgumentException( __METHOD__ . ': invalid argument type ' . gettype( $value ) ); } return $message; } /** * Factory function accepting multiple message keys and returning a message instance * for the first message which is non-empty. If all messages are empty then an * instance of the first message key is returned. * * @since 1.18 * * @param string|string[] $keys,... Message keys, or first argument as an array of all the * message keys. * * @return Message */ public static function newFallbackSequence( /*...*/ ) { $keys = func_get_args(); if ( func_num_args() == 1 ) { if ( is_array( $keys[0] ) ) { // Allow an array to be passed as the first argument instead $keys = array_values( $keys[0] ); } else { // Optimize a single string to not need special fallback handling $keys = $keys[0]; } } return new self( $keys ); } /** * Get a title object for a mediawiki message, where it can be found in the mediawiki namespace. * The title will be for the current language, if the message key is in * $wgForceUIMsgAsContentMsg it will be append with the language code (except content * language), because Message::inContentLanguage will also return in user language. * * @see $wgForceUIMsgAsContentMsg * @return Title * @since 1.26 */ public function getTitle() { global $wgContLang, $wgForceUIMsgAsContentMsg; $title = $this->key; if ( !$this->language->equals( $wgContLang ) && in_array( $this->key, (array)$wgForceUIMsgAsContentMsg ) ) { $code = $this->language->getCode(); $title .= '/' . $code; } return Title::makeTitle( NS_MEDIAWIKI, $wgContLang->ucfirst( strtr( $title, ' ', '_' ) ) ); } /** * Adds parameters to the parameter list of this message. * * @since 1.17 * * @param mixed ... Parameters as strings, or a single argument that is * an array of strings. * * @return Message $this */ public function params( /*...*/ ) { $args = func_get_args(); if ( isset( $args[0] ) && is_array( $args[0] ) ) { $args = $args[0]; } $args_values = array_values( $args ); $this->parameters = array_merge( $this->parameters, $args_values ); return $this; } /** * Add parameters that are substituted after parsing or escaping. * In other words the parsing process cannot access the contents * of this type of parameter, and you need to make sure it is * sanitized beforehand. The parser will see "$n", instead. * * @since 1.17 * * @param mixed $params,... Raw parameters as strings, or a single argument that is * an array of raw parameters. * * @return Message $this */ public function rawParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::rawParam( $param ); } return $this; } /** * Add parameters that are numeric and will be passed through * Language::formatNum before substitution * * @since 1.18 * * @param mixed $param,... Numeric parameters, or a single argument that is * an array of numeric parameters. * * @return Message $this */ public function numParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::numParam( $param ); } return $this; } /** * Add parameters that are durations of time and will be passed through * Language::formatDuration before substitution * * @since 1.22 * * @param int|int[] $param,... Duration parameters, or a single argument that is * an array of duration parameters. * * @return Message $this */ public function durationParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::durationParam( $param ); } return $this; } /** * Add parameters that are expiration times and will be passed through * Language::formatExpiry before substitution * * @since 1.22 * * @param string|string[] $param,... Expiry parameters, or a single argument that is * an array of expiry parameters. * * @return Message $this */ public function expiryParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::expiryParam( $param ); } return $this; } /** * Add parameters that are time periods and will be passed through * Language::formatTimePeriod before substitution * * @since 1.22 * * @param int|int[] $param,... Time period parameters, or a single argument that is * an array of time period parameters. * * @return Message $this */ public function timeperiodParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::timeperiodParam( $param ); } return $this; } /** * Add parameters that are file sizes and will be passed through * Language::formatSize before substitution * * @since 1.22 * * @param int|int[] $param,... Size parameters, or a single argument that is * an array of size parameters. * * @return Message $this */ public function sizeParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::sizeParam( $param ); } return $this; } /** * Add parameters that are bitrates and will be passed through * Language::formatBitrate before substitution * * @since 1.22 * * @param int|int[] $param,... Bit rate parameters, or a single argument that is * an array of bit rate parameters. * * @return Message $this */ public function bitrateParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::bitrateParam( $param ); } return $this; } /** * Add parameters that are plaintext and will be passed through without * the content being evaluated. Plaintext parameters are not valid as * arguments to parser functions. This differs from self::rawParams in * that the Message class handles escaping to match the output format. * * @since 1.25 * * @param string|string[] $param,... plaintext parameters, or a single argument that is * an array of plaintext parameters. * * @return Message $this */ public function plaintextParams( /*...*/ ) { $params = func_get_args(); if ( isset( $params[0] ) && is_array( $params[0] ) ) { $params = $params[0]; } foreach ( $params as $param ) { $this->parameters[] = self::plaintextParam( $param ); } return $this; } /** * Set the language and the title from a context object * * @since 1.19 * * @param IContextSource $context * * @return Message $this */ public function setContext( IContextSource $context ) { $this->inLanguage( $context->getLanguage() ); $this->title( $context->getTitle() ); $this->interface = true; return $this; } /** * Request the message in any language that is supported. * * As a side effect interface message status is unconditionally * turned off. * * @since 1.17 * @param Language|string $lang Language code or Language object. * @return Message $this * @throws MWException */ public function inLanguage( $lang ) { if ( $lang instanceof Language ) { $this->language = $lang; } elseif ( is_string( $lang ) ) { if ( !$this->language instanceof Language || $this->language->getCode() != $lang ) { $this->language = Language::factory( $lang ); } } elseif ( $lang instanceof StubUserLang ) { $this->language = false; } else { $type = gettype( $lang ); throw new MWException( __METHOD__ . " must be " . "passed a String or Language object; $type given" ); } $this->message = null; $this->interface = false; return $this; } /** * Request the message in the wiki's content language, * unless it is disabled for this message. * * @since 1.17 * @see $wgForceUIMsgAsContentMsg * * @return Message $this */ public function inContentLanguage() { global $wgForceUIMsgAsContentMsg; if ( in_array( $this->key, (array)$wgForceUIMsgAsContentMsg ) ) { return $this; } global $wgContLang; $this->inLanguage( $wgContLang ); return $this; } /** * Allows manipulating the interface message flag directly. * Can be used to restore the flag after setting a language. * * @since 1.20 * * @param bool $interface * * @return Message $this */ public function setInterfaceMessageFlag( $interface ) { $this->interface = (bool)$interface; return $this; } /** * Enable or disable database use. * * @since 1.17 * * @param bool $useDatabase * * @return Message $this */ public function useDatabase( $useDatabase ) { $this->useDatabase = (bool)$useDatabase; return $this; } /** * Set the Title object to use as context when transforming the message * * @since 1.18 * * @param Title $title * * @return Message $this */ public function title( $title ) { $this->title = $title; return $this; } /** * Returns the message as a Content object. * * @return Content */ public function content() { if ( !$this->content ) { $this->content = new MessageContent( $this ); } return $this->content; } /** * Returns the message parsed from wikitext to HTML. * * @since 1.17 * * @return string HTML */ public function toString() { $string = $this->fetchMessage(); if ( $string === false ) { // Err on the side of safety, ensure that the output // is always html safe in the event the message key is // missing, since in that case its highly likely the // message key is user-controlled. // '⧼' is used instead of '<' to side-step any // double-escaping issues. return '⧼' . htmlspecialchars( $this->key ) . '⧽'; } # Replace $* with a list of parameters for &uselang=qqx. if ( strpos( $string, '$*' ) !== false ) { $paramlist = ''; if ( $this->parameters !== [] ) { $paramlist = ': $' . implode( ', $', range( 1, count( $this->parameters ) ) ); } $string = str_replace( '$*', $paramlist, $string ); } # Replace parameters before text parsing $string = $this->replaceParameters( $string, 'before' ); # Maybe transform using the full parser if ( $this->format === 'parse' ) { $string = $this->parseText( $string ); $string = Parser::stripOuterParagraph( $string ); } elseif ( $this->format === 'block-parse' ) { $string = $this->parseText( $string ); } elseif ( $this->format === 'text' ) { $string = $this->transformText( $string ); } elseif ( $this->format === 'escaped' ) { $string = $this->transformText( $string ); $string = htmlspecialchars( $string, ENT_QUOTES, 'UTF-8', false ); } # Raw parameter replacement $string = $this->replaceParameters( $string, 'after' ); return $string; } /** * Magic method implementation of the above (for PHP >= 5.2.0), so we can do, eg: * $foo = new Message( $key ); * $string = "<abbr>$foo</abbr>"; * * @since 1.18 * * @return string */ public function __toString() { if ( $this->format !== 'parse' ) { $ex = new LogicException( __METHOD__ . ' using implicit format: ' . $this->format ); \MediaWiki\Logger\LoggerFactory::getInstance( 'message-format' )->warning( $ex->getMessage(), [ 'exception' => $ex, 'format' => $this->format, 'key' => $this->key ] ); } // PHP doesn't allow __toString to throw exceptions and will // trigger a fatal error if it does. So, catch any exceptions. try { return $this->toString(); } catch ( Exception $ex ) { try { trigger_error( "Exception caught in " . __METHOD__ . " (message " . $this->key . "): " . $ex, E_USER_WARNING ); } catch ( Exception $ex ) { // Doh! Cause a fatal error after all? } if ( $this->format === 'plain' || $this->format === 'text' ) { return '<' . $this->key . '>'; } return '<' . htmlspecialchars( $this->key ) . '>'; } } /** * Fully parse the text from wikitext to HTML. * * @since 1.17 * * @return string Parsed HTML. */ public function parse() { $this->format = 'parse'; return $this->toString(); } /** * Returns the message text. {{-transformation is done. * * @since 1.17 * * @return string Unescaped message text. */ public function text() { $this->format = 'text'; return $this->toString(); } /** * Returns the message text as-is, only parameters are substituted. * * @since 1.17 * * @return string Unescaped untransformed message text. */ public function plain() { $this->format = 'plain'; return $this->toString(); } /** * Returns the parsed message text which is always surrounded by a block element. * * @since 1.17 * * @return string HTML */ public function parseAsBlock() { $this->format = 'block-parse'; return $this->toString(); } /** * Returns the message text. {{-transformation is done and the result * is escaped excluding any raw parameters. * * @since 1.17 * * @return string Escaped message text. */ public function escaped() { $this->format = 'escaped'; return $this->toString(); } /** * Check whether a message key has been defined currently. * * @since 1.17 * * @return bool */ public function exists() { return $this->fetchMessage() !== false; } /** * Check whether a message does not exist, or is an empty string * * @since 1.18 * @todo FIXME: Merge with isDisabled()? * * @return bool */ public function isBlank() { $message = $this->fetchMessage(); return $message === false || $message === ''; } /** * Check whether a message does not exist, is an empty string, or is "-". * * @since 1.18 * * @return bool */ public function isDisabled() { $message = $this->fetchMessage(); return $message === false || $message === '' || $message === '-'; } /** * @since 1.17 * * @param mixed $raw * * @return array Array with a single "raw" key. */ public static function rawParam( $raw ) { return [ 'raw' => $raw ]; } /** * @since 1.18 * * @param mixed $num * * @return array Array with a single "num" key. */ public static function numParam( $num ) { return [ 'num' => $num ]; } /** * @since 1.22 * * @param int $duration * * @return int[] Array with a single "duration" key. */ public static function durationParam( $duration ) { return [ 'duration' => $duration ]; } /** * @since 1.22 * * @param string $expiry * * @return string[] Array with a single "expiry" key. */ public static function expiryParam( $expiry ) { return [ 'expiry' => $expiry ]; } /** * @since 1.22 * * @param number $period * * @return number[] Array with a single "period" key. */ public static function timeperiodParam( $period ) { return [ 'period' => $period ]; } /** * @since 1.22 * * @param int $size * * @return int[] Array with a single "size" key. */ public static function sizeParam( $size ) { return [ 'size' => $size ]; } /** * @since 1.22 * * @param int $bitrate * * @return int[] Array with a single "bitrate" key. */ public static function bitrateParam( $bitrate ) { return [ 'bitrate' => $bitrate ]; } /** * @since 1.25 * * @param string $plaintext * * @return string[] Array with a single "plaintext" key. */ public static function plaintextParam( $plaintext ) { return [ 'plaintext' => $plaintext ]; } /** * Substitutes any parameters into the message text. * * @since 1.17 * * @param string $message The message text. * @param string $type Either "before" or "after". * * @return string */ protected function replaceParameters( $message, $type = 'before' ) { $replacementKeys = []; foreach ( $this->parameters as $n => $param ) { list( $paramType, $value ) = $this->extractParam( $param ); if ( $type === $paramType ) { $replacementKeys['$' . ( $n + 1 )] = $value; } } $message = strtr( $message, $replacementKeys ); return $message; } /** * Extracts the parameter type and preprocessed the value if needed. * * @since 1.18 * * @param mixed $param Parameter as defined in this class. * * @return array Array with the parameter type (either "before" or "after") and the value. */ protected function extractParam( $param ) { if ( is_array( $param ) ) { if ( isset( $param['raw'] ) ) { return [ 'after', $param['raw'] ]; } elseif ( isset( $param['num'] ) ) { // Replace number params always in before step for now. // No support for combined raw and num params return [ 'before', $this->getLanguage()->formatNum( $param['num'] ) ]; } elseif ( isset( $param['duration'] ) ) { return [ 'before', $this->getLanguage()->formatDuration( $param['duration'] ) ]; } elseif ( isset( $param['expiry'] ) ) { return [ 'before', $this->getLanguage()->formatExpiry( $param['expiry'] ) ]; } elseif ( isset( $param['period'] ) ) { return [ 'before', $this->getLanguage()->formatTimePeriod( $param['period'] ) ]; } elseif ( isset( $param['size'] ) ) { return [ 'before', $this->getLanguage()->formatSize( $param['size'] ) ]; } elseif ( isset( $param['bitrate'] ) ) { return [ 'before', $this->getLanguage()->formatBitrate( $param['bitrate'] ) ]; } elseif ( isset( $param['plaintext'] ) ) { return [ 'after', $this->formatPlaintext( $param['plaintext'] ) ]; } else { $warning = 'Invalid parameter for message "' . $this->getKey() . '": ' . htmlspecialchars( serialize( $param ) ); trigger_error( $warning, E_USER_WARNING ); $e = new Exception; wfDebugLog( 'Bug58676', $warning . "\n" . $e->getTraceAsString() ); return [ 'before', '[INVALID]' ]; } } elseif ( $param instanceof Message ) { // Message objects should not be before parameters because // then they'll get double escaped. If the message needs to be // escaped, it'll happen right here when we call toString(). return [ 'after', $param->toString() ]; } else { return [ 'before', $param ]; } } /** * Wrapper for what ever method we use to parse wikitext. * * @since 1.17 * * @param string $string Wikitext message contents. * * @return string Wikitext parsed into HTML. */ protected function parseText( $string ) { $out = MessageCache::singleton()->parse( $string, $this->title, /*linestart*/true, $this->interface, $this->getLanguage() ); return $out instanceof ParserOutput ? $out->getText() : $out; } /** * Wrapper for what ever method we use to {{-transform wikitext. * * @since 1.17 * * @param string $string Wikitext message contents. * * @return string Wikitext with {{-constructs replaced with their values. */ protected function transformText( $string ) { return MessageCache::singleton()->transform( $string, $this->interface, $this->getLanguage(), $this->title ); } /** * Wrapper for what ever method we use to get message contents. * * @since 1.17 * * @return string * @throws MWException If message key array is empty. */ protected function fetchMessage() { if ( $this->message === null ) { $cache = MessageCache::singleton(); foreach ( $this->keysToTry as $key ) { $message = $cache->get( $key, $this->useDatabase, $this->getLanguage() ); if ( $message !== false && $message !== '' ) { break; } } // NOTE: The constructor makes sure keysToTry isn't empty, // so we know that $key and $message are initialized. $this->key = $key; $this->message = $message; } return $this->message; } /** * Formats a message parameter wrapped with 'plaintext'. Ensures that * the entire string is displayed unchanged when displayed in the output * format. * * @since 1.25 * * @param string $plaintext String to ensure plaintext output of * * @return string Input plaintext encoded for output to $this->format */ protected function formatPlaintext( $plaintext ) { switch ( $this->format ) { case 'text': case 'plain': return $plaintext; case 'parse': case 'block-parse': case 'escaped': default: return htmlspecialchars( $plaintext, ENT_QUOTES ); } } } /** * Variant of the Message class. * * Rather than treating the message key as a lookup * value (which is passed to the MessageCache and * translated as necessary), a RawMessage key is * treated as the actual message. * * All other functionality (parsing, escaping, etc.) * is preserved. * * @since 1.21 */ class RawMessage extends Message { /** * Call the parent constructor, then store the key as * the message. * * @see Message::__construct * * @param string $text Message to use. * @param array $params Parameters for the message. * * @throws InvalidArgumentException */ public function __construct( $text, $params = [] ) { if ( !is_string( $text ) ) { throw new InvalidArgumentException( '$text must be a string' ); } parent::__construct( $text, $params ); // The key is the message. $this->message = $text; } /** * Fetch the message (in this case, the key). * * @return string */ public function fetchMessage() { // Just in case the message is unset somewhere. if ( $this->message === null ) { $this->message = $this->key; } return $this->message; } }