25use Liuggio\StatsdClient\Factory\StatsdDataFactory;
28use Wikimedia\ScopedCallback;
99 if ( $this->config ===
null ) {
102 $this->config = MediaWikiServices::getInstance()->getMainConfig();
123 if ( $this->request ===
null ) {
144 return MediaWikiServices::getInstance()->getStatsdDataFactory();
153 if ( $this->timing ===
null ) {
154 $this->timing =
new Timing( [
155 'logger' => LoggerFactory::getInstance(
'Timing' )
169 $this->wikipage =
null;
178 if ( $this->title ===
null ) {
179 global
$wgTitle; # fallback to $wg till we can improve
this
183 __METHOD__ .
' called by ' .
wfGetAllCallers( 5 ) .
' with no title set.'
197 return $this->title !==
null;
209 if ( $this->wikipage ) {
216 return $title ? $title->canExist() :
false;
226 $pageTitle = $p->getTitle();
227 if ( !$this->
hasTitle() || !$pageTitle->equals( $this->getTitle() ) ) {
231 $this->wikipage = $p;
245 if ( $this->wikipage ===
null ) {
247 if ( $title ===
null ) {
248 throw new MWException( __METHOD__ .
' called without Title object set' );
269 if ( $this->
output ===
null ) {
291 if ( $this->user ===
null ) {
292 $this->user = User::newFromSession( $this->
getRequest() );
312 wfDebug(
"Invalid user language code\n" );
329 } elseif ( is_string( $l ) ) {
331 $obj = Language::factory( $l );
334 throw new MWException( __METHOD__ .
" was passed an invalid type of data." );
346 if ( isset( $this->recursion ) ) {
347 trigger_error(
"Recursion detected in " . __METHOD__, E_USER_WARNING );
349 wfDebugLog(
'recursion-guard',
"Recursion detected:\n" .
$e->getTraceAsString() );
352 $this->lang = Language::factory(
$code );
353 } elseif ( $this->lang ===
null ) {
354 $this->recursion =
true;
363 if (
$code ===
'user' ) {
364 $code = $user->getOption(
'language' );
368 Hooks::run(
'UserGetLanguageObject', [ $user, &
$code, $this ] );
373 $obj = Language::factory(
$code );
377 unset( $this->recursion );
379 catch ( Exception $ex ) {
380 unset( $this->recursion );
395 $this->
skin->setContext( $this );
404 if ( $this->
skin ===
null ) {
406 Hooks::run(
'RequestContextCreateSkin', [ $this, &$skin ] );
407 $factory = SkinFactory::getDefaultInstance();
410 if ( $skin instanceof
Skin ) {
412 } elseif ( is_string( $skin ) ) {
415 $this->
skin = $factory->makeSkin( $normalized );
420 if ( $this->
skin ===
null ) {
421 if ( !in_array(
'skin', $this->
getConfig()->
get(
'HiddenPrefs' ) ) ) {
423 $userSkin = $this->
getUser()->getOption(
'skin' );
424 $userSkin = $this->
getRequest()->getVal(
'useskin', $userSkin );
426 # if we're not allowing users to override, then use the default
427 $userSkin = $this->
getConfig()->get(
'DefaultSkin' );
436 $this->
skin = $factory->makeSkin( $normalized );
440 $this->
skin->setContext( $this );
457 public function msg( $key ) {
458 $args = func_get_args();
460 return call_user_func_array(
'wfMessage',
$args )->setContext( $this );
471 if ( self::$instance ===
null ) {
472 self::$instance =
new self;
487 wfDebug( $func .
' called without context. ' .
488 "Using RequestContext::getMain() for sanity\n" );
497 if ( !( defined(
'MW_PHPUNIT_TEST' ) || defined(
'MW_PARSER_TEST' ) ) ) {
498 throw new MWException( __METHOD__ .
'() should be called only from unit tests!' );
500 self::$instance =
null;
511 $session = MediaWiki\Session\SessionManager::getGlobalSession();
514 'headers' => $this->
getRequest()->getAllHeaders(),
515 'sessionId' => $session->isPersistent() ? $session->getId() :
'',
516 'userId' => $this->
getUser()->getId()
543 if ( strlen(
$params[
'sessionId'] ) &&
544 MediaWiki\Session\SessionManager::getGlobalSession()->isPersistent()
548 throw new MWException(
"Sessions can only be imported when none is active." );
549 } elseif ( !IP::isValid(
$params[
'ip'] ) ) {
550 throw new MWException(
"Invalid client IP address '{$params['ip']}'." );
554 $user = User::newFromId(
$params[
'userId'] );
556 if ( !$user->getId() ) {
557 throw new MWException(
"No user with ID '{$params['userId']}'." );
560 $user = User::newFromName(
$params[
'ip'],
false );
569 if (
MediaWiki\Session\PHPSessionHandler::isEnabled() ) {
570 session_write_close();
577 if ( strlen(
$params[
'sessionId'] ) ) {
578 $manager = MediaWiki\Session\SessionManager::singleton();
579 $session = $manager->getSessionById(
$params[
'sessionId'],
true )
580 ?: $manager->getEmptySession();
594 if ( $session &&
MediaWiki\Session\PHPSessionHandler::isEnabled() ) {
595 session_id( $session->getId() );
596 MediaWiki\quietCall(
'session_start' );
612 $importSessionFunc( $user,
$params );
615 return new ScopedCallback(
616 function () use ( $importSessionFunc, $oUser, $oParams, $oRequest ) {
618 $importSessionFunc( $oUser, $oParams );
648 $context->user = User::newFromName(
'127.0.0.1',
false );
$wgLanguageCode
Site language code.
wfDebug( $text, $dest='all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
wfGetAllCallers( $limit=3)
Return a string consisting of callers in the stack.
wfDebugLog( $logGroup, $text, $dest='all', array $context=[])
Send a line to a supplementary debug log file, if configured, or main debug log if not.
global $wgCommandLineMode
if(! $wgDBerrorLogTZ) $wgRequest
if(! $wgRequest->checkUrlExtension()) if(isset($_SERVER[ 'PATH_INFO']) &&$_SERVER[ 'PATH_INFO'] !='') if(! $wgEnableAPI) $wgTitle
WebRequest clone which takes values from a provided array.
Internationalisation code.
This class should be covered by a general architecture document which does not exist as of January 20...
Group all the pieces relevant to the context of a request into one instance.
static getMainAndWarn( $func=__METHOD__)
Get the RequestContext object associated with the main request and gives a warning to the log,...
getRequest()
Get the WebRequest object.
canUseWikiPage()
Check whether a WikiPage object can be get with getWikiPage().
getSkin()
Get the Skin object.
static importScopedSession(array $params)
Import an client IP address, HTTP headers, user ID, and session ID.
setSkin(Skin $s)
Set the Skin object.
getTiming()
Get the timing object.
setRequest(WebRequest $r)
Set the WebRequest object.
static RequestContext $instance
static sanitizeLangCode( $code)
Accepts a language code and ensures it's sane.
setConfig(Config $c)
Set the Config object.
getUser()
Get the User object.
hasTitle()
Check, if a Title object is set.
msg( $key)
Helpful methods.
getStats()
Get the Stats object.
setUser(User $u)
Set the User object.
getTitle()
Get the Title object.
getConfig()
Get the Config object.
setTitle(Title $title=null)
Set the Title object.
setWikiPage(WikiPage $p)
Set the WikiPage object.
static newExtraneousContext(Title $title, $request=[])
Create a new extraneous context.
exportSession()
Export the resolved user IP, HTTP headers, user ID, and session ID.
getOutput()
Get the OutputPage object.
static resetMain()
Resets singleton returned by getMain().
setLanguage( $l)
Set the Language object.
static getMain()
Static methods.
getLanguage()
Get the Language object.
getWikiPage()
Get the WikiPage object.
The main skin class which provides methods and properties for all other skins.
static normalizeKey( $key)
Normalize a skin preference value to a form that can be loaded.
An interface to help developers measure the performance of their applications.
Represents a title within MediaWiki.
canExist()
Is this in a namespace that allows actual pages?
The User object encapsulates all of the user-specific settings (user_id, name, rights,...
The WebRequest class encapsulates getting at data passed in the URL or via a POSTed form stripping il...
getVal( $name, $default=null)
Fetch a scalar from the input or return $default if it's not set.
Class representing a MediaWiki article and history.
static factory(Title $title)
Create a WikiPage object of the appropriate class for the given title.
this class mediates it Skin Encapsulates a look and feel for the wiki All of the functions that render HTML and make choices about how to render it are here and are called from various other places when and is meant to be subclassed with other skins that may override some of its functions The User object contains a reference to a and so rather than having a global skin object we just rely on the global User and get the skin with $wgUser and also has some character encoding functions and other locale stuff The current user interface language is instantiated as and the local content language as $wgContLang
this class mediates it Skin Encapsulates a look and feel for the wiki All of the functions that render HTML and make choices about how to render it are here and are called from various other places when and is meant to be subclassed with other skins that may override some of its functions The User object contains a reference to a skin(according to that user 's preference)
design txt This is a brief overview of the new design More thorough and up to date information is available on the documentation wiki at etc Handles the details of getting and saving to the user table of the and dealing with sessions and cookies OutputPage Encapsulates the entire HTML page that will be sent in response to any server request It is used by calling its functions to add in any and then calling output() to send it all. It could be easily changed to send incrementally if that becomes useful
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
do that in ParserLimitReportFormat instead use this to modify the parameters of the image all existing parser cache entries will be invalid To avoid you ll need to handle that somehow(e.g. with the RejectParserCacheValue hook) because MediaWiki won 't do it for you. & $defaults also a ContextSource after deleting those rows but within the same transaction you ll probably need to make sure the header is varied on and they can depend only on the ResourceLoaderContext $context
returning false will NOT prevent logging $e
Interface for objects which can provide a MediaWiki context on request.