MediaWiki  master
RequestContext.php
Go to the documentation of this file.
1 <?php
29 
37  private $request;
38 
42  private $title;
43 
47  private $wikipage;
48 
52  private $output;
53 
57  private $user;
58 
62  private $lang;
63 
67  private $skin;
68 
72  private $timing;
73 
77  private $config;
78 
82  private static $instance = null;
83 
87  public function setConfig( Config $config ) {
88  $this->config = $config;
89  }
90 
94  public function getConfig() {
95  if ( $this->config === null ) {
96  // @todo In the future, we could move this to WebStart.php so
97  // the Config object is ready for when initialization happens
98  $this->config = MediaWikiServices::getInstance()->getMainConfig();
99  }
100 
101  return $this->config;
102  }
103 
107  public function setRequest( WebRequest $request ) {
108  $this->request = $request;
109  }
110 
114  public function getRequest() {
115  if ( $this->request === null ) {
116  global $wgCommandLineMode;
117  // create the WebRequest object on the fly
118  if ( $wgCommandLineMode ) {
119  $this->request = new FauxRequest( [] );
120  } else {
121  $this->request = new WebRequest();
122  }
123  }
124 
125  return $this->request;
126  }
127 
133  public function getStats() {
134  return MediaWikiServices::getInstance()->getStatsdDataFactory();
135  }
136 
140  public function getTiming() {
141  if ( $this->timing === null ) {
142  $this->timing = new Timing( [
143  'logger' => LoggerFactory::getInstance( 'Timing' )
144  ] );
145  }
146  return $this->timing;
147  }
148 
152  public function setTitle( Title $title = null ) {
153  $this->title = $title;
154  // Erase the WikiPage so a new one with the new title gets created.
155  $this->wikipage = null;
156  }
157 
161  public function getTitle() {
162  if ( $this->title === null ) {
163  global $wgTitle; # fallback to $wg till we can improve this
164  $this->title = $wgTitle;
165  wfDebugLog(
166  'GlobalTitleFail',
167  __METHOD__ . ' called by ' . wfGetAllCallers( 5 ) . ' with no title set.'
168  );
169  }
170 
171  return $this->title;
172  }
173 
180  public function hasTitle() {
181  return $this->title !== null;
182  }
183 
192  public function canUseWikiPage() {
193  if ( $this->wikipage ) {
194  // If there's a WikiPage object set, we can for sure get it
195  return true;
196  }
197  // Only pages with legitimate titles can have WikiPages.
198  // That usually means pages in non-virtual namespaces.
199  $title = $this->getTitle();
200  return $title ? $title->canExist() : false;
201  }
202 
207  public function setWikiPage( WikiPage $wikiPage ) {
208  $pageTitle = $wikiPage->getTitle();
209  if ( !$this->hasTitle() || !$pageTitle->equals( $this->getTitle() ) ) {
210  $this->setTitle( $pageTitle );
211  }
212  // Defer this to the end since setTitle sets it to null.
213  $this->wikipage = $wikiPage;
214  }
215 
226  public function getWikiPage() {
227  if ( $this->wikipage === null ) {
228  $title = $this->getTitle();
229  if ( $title === null ) {
230  throw new MWException( __METHOD__ . ' called without Title object set' );
231  }
232  $this->wikipage = WikiPage::factory( $title );
233  }
234 
235  return $this->wikipage;
236  }
237 
241  public function setOutput( OutputPage $output ) {
242  $this->output = $output;
243  }
244 
248  public function getOutput() {
249  if ( $this->output === null ) {
250  $this->output = new OutputPage( $this );
251  }
252 
253  return $this->output;
254  }
255 
259  public function setUser( User $user ) {
260  $this->user = $user;
261  // Invalidate cached user interface language
262  $this->lang = null;
263  }
264 
268  public function getUser() {
269  if ( $this->user === null ) {
270  $this->user = User::newFromSession( $this->getRequest() );
271  }
272 
273  return $this->user;
274  }
275 
282  public static function sanitizeLangCode( $code ) {
283  global $wgLanguageCode;
284 
285  // BCP 47 - letter case MUST NOT carry meaning
286  $code = strtolower( $code );
287 
288  # Validate $code
289  if ( !$code || !Language::isValidCode( $code ) || $code === 'qqq' ) {
291  }
292 
293  return $code;
294  }
295 
301  public function setLanguage( $language ) {
302  if ( $language instanceof Language ) {
303  $this->lang = $language;
304  } elseif ( is_string( $language ) ) {
305  $language = self::sanitizeLangCode( $language );
306  $obj = Language::factory( $language );
307  $this->lang = $obj;
308  } else {
309  throw new MWException( __METHOD__ . " was passed an invalid type of data." );
310  }
311  }
312 
320  public function getLanguage() {
321  if ( isset( $this->recursion ) ) {
322  trigger_error( "Recursion detected in " . __METHOD__, E_USER_WARNING );
323  $e = new Exception;
324  wfDebugLog( 'recursion-guard', "Recursion detected:\n" . $e->getTraceAsString() );
325 
326  $code = $this->getConfig()->get( 'LanguageCode' ) ?: 'en';
327  $this->lang = Language::factory( $code );
328  } elseif ( $this->lang === null ) {
329  $this->recursion = true;
330 
331  try {
332  $request = $this->getRequest();
333  $user = $this->getUser();
334 
335  // Optimisation: Avoid slow getVal(), this isn't user-generated content.
336  $code = $request->getRawVal( 'uselang', 'user' );
337  if ( $code === 'user' ) {
338  $code = $user->getOption( 'language' );
339  }
340  $code = self::sanitizeLangCode( $code );
341 
342  Hooks::run( 'UserGetLanguageObject', [ $user, &$code, $this ] );
343 
344  if ( $code === $this->getConfig()->get( 'LanguageCode' ) ) {
345  $this->lang = MediaWikiServices::getInstance()->getContentLanguage();
346  } else {
347  $obj = Language::factory( $code );
348  $this->lang = $obj;
349  }
350  } finally {
351  unset( $this->recursion );
352  }
353  }
354 
355  return $this->lang;
356  }
357 
361  public function setSkin( Skin $skin ) {
362  $this->skin = clone $skin;
363  $this->skin->setContext( $this );
364  }
365 
369  public function getSkin() {
370  if ( $this->skin === null ) {
371  $skin = null;
372  Hooks::run( 'RequestContextCreateSkin', [ $this, &$skin ] );
373  $factory = MediaWikiServices::getInstance()->getSkinFactory();
374 
375  if ( $skin instanceof Skin ) {
376  // The hook provided a skin object
377  $this->skin = $skin;
378  } elseif ( is_string( $skin ) ) {
379  // The hook provided a skin name
380  // Normalize the key, just in case the hook did something weird.
381  $normalized = Skin::normalizeKey( $skin );
382  $this->skin = $factory->makeSkin( $normalized );
383  } else {
384  // No hook override, go through normal processing
385  if ( !in_array( 'skin', $this->getConfig()->get( 'HiddenPrefs' ) ) ) {
386  $userSkin = $this->getUser()->getOption( 'skin' );
387  // Optimisation: Avoid slow getVal(), this isn't user-generated content.
388  $userSkin = $this->getRequest()->getRawVal( 'useskin', $userSkin );
389  } else {
390  $userSkin = $this->getConfig()->get( 'DefaultSkin' );
391  }
392 
393  // Normalize the key in case the user is passing gibberish query params
394  // or has old user preferences (T71566).
395  // Skin::normalizeKey will also validate it, so makeSkin() won't throw.
396  $normalized = Skin::normalizeKey( $userSkin );
397  $this->skin = $factory->makeSkin( $normalized );
398  }
399 
400  // After all that set a context on whatever skin got created
401  $this->skin->setContext( $this );
402  }
403 
404  return $this->skin;
405  }
406 
416  public function msg( $key ) {
417  $args = func_get_args();
418 
419  return wfMessage( ...$args )->setContext( $this );
420  }
421 
427  public static function getMain() {
428  if ( self::$instance === null ) {
429  self::$instance = new self;
430  }
431 
432  return self::$instance;
433  }
434 
443  public static function getMainAndWarn( $func = __METHOD__ ) {
444  wfDebug( $func . ' called without context. ' .
445  "Using RequestContext::getMain() for sanity\n" );
446 
447  return self::getMain();
448  }
449 
453  public static function resetMain() {
454  if ( !( defined( 'MW_PHPUNIT_TEST' ) || defined( 'MW_PARSER_TEST' ) ) ) {
455  throw new MWException( __METHOD__ . '() should be called only from unit tests!' );
456  }
457  self::$instance = null;
458  }
459 
467  public function exportSession() {
469  return [
470  'ip' => $this->getRequest()->getIP(),
471  'headers' => $this->getRequest()->getAllHeaders(),
472  'sessionId' => $session->isPersistent() ? $session->getId() : '',
473  'userId' => $this->getUser()->getId()
474  ];
475  }
476 
499  public static function importScopedSession( array $params ) {
500  if ( strlen( $params['sessionId'] ) &&
501  MediaWiki\Session\SessionManager::getGlobalSession()->isPersistent()
502  ) {
503  // Sanity check to avoid sending random cookies for the wrong users.
504  // This method should only called by CLI scripts or by HTTP job runners.
505  throw new MWException( "Sessions can only be imported when none is active." );
506  } elseif ( !IP::isValid( $params['ip'] ) ) {
507  throw new MWException( "Invalid client IP address '{$params['ip']}'." );
508  }
509 
510  if ( $params['userId'] ) { // logged-in user
511  $user = User::newFromId( $params['userId'] );
512  $user->load();
513  if ( !$user->getId() ) {
514  throw new MWException( "No user with ID '{$params['userId']}'." );
515  }
516  } else { // anon user
517  $user = User::newFromName( $params['ip'], false );
518  }
519 
520  $importSessionFunc = function ( User $user, array $params ) {
521  global $wgRequest, $wgUser;
522 
524 
525  // Commit and close any current session
526  if ( MediaWiki\Session\PHPSessionHandler::isEnabled() ) {
527  session_write_close(); // persist
528  session_id( '' ); // detach
529  $_SESSION = []; // clear in-memory array
530  }
531 
532  // Get new session, if applicable
533  $session = null;
534  if ( strlen( $params['sessionId'] ) ) { // don't make a new random ID
536  $session = $manager->getSessionById( $params['sessionId'], true )
537  ?: $manager->getEmptySession();
538  }
539 
540  // Remove any user IP or agent information, and attach the request
541  // with the new session.
542  $context->setRequest( new FauxRequest( [], false, $session ) );
543  $wgRequest = $context->getRequest(); // b/c
544 
545  // Now that all private information is detached from the user, it should
546  // be safe to load the new user. If errors occur or an exception is thrown
547  // and caught (leaving the main context in a mixed state), there is no risk
548  // of the User object being attached to the wrong IP, headers, or session.
549  $context->setUser( $user );
550  $wgUser = $context->getUser(); // b/c
551  if ( $session && MediaWiki\Session\PHPSessionHandler::isEnabled() ) {
552  session_id( $session->getId() );
553  AtEase::quietCall( 'session_start' );
554  }
555  $request = new FauxRequest( [], false, $session );
556  $request->setIP( $params['ip'] );
557  foreach ( $params['headers'] as $name => $value ) {
558  $request->setHeader( $name, $value );
559  }
560  // Set the current context to use the new WebRequest
561  $context->setRequest( $request );
562  $wgRequest = $context->getRequest(); // b/c
563  };
564 
565  // Stash the old session and load in the new one
566  $oUser = self::getMain()->getUser();
567  $oParams = self::getMain()->exportSession();
568  $oRequest = self::getMain()->getRequest();
569  $importSessionFunc( $user, $params );
570 
571  // Set callback to save and close the new session and reload the old one
572  return new ScopedCallback(
573  function () use ( $importSessionFunc, $oUser, $oParams, $oRequest ) {
574  global $wgRequest;
575  $importSessionFunc( $oUser, $oParams );
576  // Restore the exact previous Request object (instead of leaving FauxRequest)
577  RequestContext::getMain()->setRequest( $oRequest );
578  $wgRequest = RequestContext::getMain()->getRequest(); // b/c
579  }
580  );
581  }
582 
597  public static function newExtraneousContext( Title $title, $request = [] ) {
598  $context = new self;
599  $context->setTitle( $title );
600  if ( $request instanceof WebRequest ) {
601  $context->setRequest( $request );
602  } else {
603  $context->setRequest( new FauxRequest( $request ) );
604  }
605  $context->user = User::newFromName( '127.0.0.1', false );
606 
607  return $context;
608  }
609 }
getRawVal( $name, $default=null)
Fetch a scalar from the input without normalization, or return $default if it&#39;s not set...
Definition: WebRequest.php:424
static factory(Title $title)
Create a WikiPage object of the appropriate class for the given title.
Definition: WikiPage.php:138
setContext(IContextSource $context)
static normalizeKey( $key)
Normalize a skin preference value to a form that can be loaded.
Definition: Skin.php:102
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
div flags Integer display flags(NO_ACTION_LINK, NO_EXTRA_USER_LINKS) 'LogException' returning false will NOT prevent logging $e
Definition: hooks.txt:2147
getOption( $oname, $defaultOverride=null, $ignoreHidden=false)
Get the user&#39;s current setting for a given option.
Definition: User.php:2968
$value
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 MediaWikiServices
Definition: injection.txt:23
A helper class for throttling authentication attempts.
exportSession()
Export the resolved user IP, HTTP headers, user ID, and session ID.
title
static importScopedSession(array $params)
Import an client IP address, HTTP headers, user ID, and session ID.
if( $line===false) $args
Definition: cdb.php:64
The User object encapsulates all of the user-specific settings (user_id, name, rights, email address, options, last login time).
Definition: User.php:51
setSkin(Skin $skin)
wfGetAllCallers( $limit=3)
Return a string consisting of callers in the stack.
$wgLanguageCode
Site language code.
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 use $formDescriptor instead 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 unset offset - wrap String Wrap the message in html(usually something like "&lt
static getMain()
Get the RequestContext object associated with the main request.
Interface for configuration instances.
Definition: Config.php:28
canExist()
Is this in a namespace that allows actual pages?
Definition: Title.php:1167
wfDebug( $text, $dest='all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
canUseWikiPage()
Check whether a WikiPage object can be get with getWikiPage().
static isValid( $ip)
Validate an IP address.
Definition: IP.php:111
load( $flags=self::READ_NORMAL)
Load the user table data for this object from the source given by mFrom.
Definition: User.php:308
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 and we might be restricted by PHP settings such as safe mode or open_basedir We cannot assume that the software even has read access anywhere useful Many shared hosts run all users web applications under the same user
Wikitext formatted, in the key only.
Definition: distributors.txt:9
setWikiPage(WikiPage $wikiPage)
$params
getTitle()
Get the title object of the article.
Definition: WikiPage.php:294
static resetMain()
Resets singleton returned by getMain().
OutputPage $output
static newExtraneousContext(Title $title, $request=[])
Create a new extraneous context.
hasTitle()
Check, if a Title object is set.
setTitle(Title $title=null)
An interface to help developers measure the performance of their applications.
Definition: Timing.php:45
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that When $user is not null
Definition: hooks.txt:767
static factory( $code)
Get a cached or new language object for a given language code.
Definition: Language.php:216
div flags Integer display flags(NO_ACTION_LINK, NO_EXTRA_USER_LINKS) 'LogException' returning false will NOT prevent logging a wrapping ErrorException create2 Corresponds to logging log_action database field and which is displayed in the UI similar to $comment or false if none Defaults to false if not set multiOccurrence Can this option be passed multiple times Defaults to false if not set this hook should only be used to add variables that depend on the current page request
Definition: hooks.txt:2147
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that When $user is not it can be in the form of< username >< more info > e g for bot passwords intended to be added to log contexts Fields it might only if the login was with a bot password 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
Definition: hooks.txt:767
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
Definition: distributors.txt:9
getWikiPage()
Get the WikiPage object.
static singleton()
Get the global SessionManager.
setUser(User $user)
static getGlobalSession()
Get the "global" session.
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
Definition: injection.txt:35
static newFromId( $id)
Static factory method for creation from a given user ID.
Definition: User.php:559
getId()
Get the user&#39;s ID.
Definition: User.php:2224
WikiPage $wikipage
wfDebugLog( $logGroup, $text, $dest='all', array $context=[])
Send a line to a supplementary debug log file, if configured, or main debug log if not...
static sanitizeLangCode( $code)
Accepts a language code and ensures it&#39;s sane.
global $wgCommandLineMode
static newFromSession(WebRequest $request=null)
Create a new user object using data from session.
Definition: User.php:709
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
Definition: hooks.txt:2621
setLanguage( $language)
MediaWiki Logger LoggerFactory implements a PSR [0] compatible message logging system Named Psr Log LoggerInterface instances can be obtained from the MediaWiki Logger LoggerFactory::getInstance() static method. MediaWiki\Logger\LoggerFactory expects a class implementing the MediaWiki\Logger\Spi interface to act as a factory for new Psr\Log\LoggerInterface instances. The "Spi" in MediaWiki\Logger\Spi stands for "service provider interface". An SPI is an API intended to be implemented or extended by a third party. This software design pattern is intended to enable framework extension and replaceable components. It is specifically used in the MediaWiki\Logger\LoggerFactory service to allow alternate PSR-3 logging implementations to be easily integrated with MediaWiki. The service provider interface allows the backend logging library to be implemented in multiple ways. The $wgMWLoggerDefaultSpi global provides the classname of the default MediaWiki\Logger\Spi implementation to be loaded at runtime. This can either be the name of a class implementing the MediaWiki\Logger\Spi with a zero argument const ructor or a callable that will return an MediaWiki\Logger\Spi instance. Alternately the MediaWiki\Logger\LoggerFactory MediaWiki Logger LoggerFactory
Definition: logger.txt:5
static getMainAndWarn( $func=__METHOD__)
Get the RequestContext object associated with the main request and gives a warning to the log...
Allows to change the fields on the form that will be generated $name
Definition: hooks.txt:271
if(! $wgDBerrorLogTZ) $wgRequest
Definition: Setup.php:776
WebRequest $request
setRequest(WebRequest $request)
if(! $wgRequest->checkUrlExtension()) if(isset( $_SERVER['PATH_INFO']) && $_SERVER['PATH_INFO'] !='') $wgTitle
Definition: api.php:57
static newFromName( $name, $validate='valid')
Static factory method for creation from username.
Definition: User.php:535
setOutput(OutputPage $output)
msg( $key)
Get a Message object with context set Parameters are the same as wfMessage()
static isValidCode( $code)
Returns true if a language code string is of a valid form, whether or not it exists.
Definition: Language.php:388
getLanguage()
Get the Language object.
static RequestContext $instance
static run( $event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:200
setConfig(Config $config)