MediaWiki  master
RequestContext.php
Go to the documentation of this file.
1 <?php
28 
36  private $request;
37 
41  private $title;
42 
46  private $wikipage;
47 
51  private $output;
52 
56  private $user;
57 
61  private $lang;
62 
66  private $skin;
67 
71  private $timing;
72 
76  private $config;
77 
81  private static $instance = null;
82 
86  public function setConfig( Config $config ) {
87  $this->config = $config;
88  }
89 
93  public function getConfig() {
94  if ( $this->config === null ) {
95  // @todo In the future, we could move this to WebStart.php so
96  // the Config object is ready for when initialization happens
97  $this->config = MediaWikiServices::getInstance()->getMainConfig();
98  }
99 
100  return $this->config;
101  }
102 
106  public function setRequest( WebRequest $request ) {
107  $this->request = $request;
108  }
109 
113  public function getRequest() {
114  if ( $this->request === null ) {
115  global $wgCommandLineMode;
116  // create the WebRequest object on the fly
117  if ( $wgCommandLineMode ) {
118  $this->request = new FauxRequest( [] );
119  } else {
120  $this->request = new WebRequest();
121  }
122  }
123 
124  return $this->request;
125  }
126 
132  public function getStats() {
133  return MediaWikiServices::getInstance()->getStatsdDataFactory();
134  }
135 
139  public function getTiming() {
140  if ( $this->timing === null ) {
141  $this->timing = new Timing( [
142  'logger' => LoggerFactory::getInstance( 'Timing' )
143  ] );
144  }
145  return $this->timing;
146  }
147 
151  public function setTitle( Title $title = null ) {
152  $this->title = $title;
153  // Erase the WikiPage so a new one with the new title gets created.
154  $this->wikipage = null;
155  }
156 
160  public function getTitle() {
161  if ( $this->title === null ) {
162  global $wgTitle; # fallback to $wg till we can improve this
163  $this->title = $wgTitle;
164  wfDebugLog(
165  'GlobalTitleFail',
166  __METHOD__ . ' called by ' . wfGetAllCallers( 5 ) . ' with no title set.'
167  );
168  }
169 
170  return $this->title;
171  }
172 
179  public function hasTitle() {
180  return $this->title !== null;
181  }
182 
191  public function canUseWikiPage() {
192  if ( $this->wikipage ) {
193  // If there's a WikiPage object set, we can for sure get it
194  return true;
195  }
196  // Only pages with legitimate titles can have WikiPages.
197  // That usually means pages in non-virtual namespaces.
198  $title = $this->getTitle();
199  return $title ? $title->canExist() : false;
200  }
201 
206  public function setWikiPage( WikiPage $wikiPage ) {
207  $pageTitle = $wikiPage->getTitle();
208  if ( !$this->hasTitle() || !$pageTitle->equals( $this->getTitle() ) ) {
209  $this->setTitle( $pageTitle );
210  }
211  // Defer this to the end since setTitle sets it to null.
212  $this->wikipage = $wikiPage;
213  }
214 
225  public function getWikiPage() {
226  if ( $this->wikipage === null ) {
227  $title = $this->getTitle();
228  if ( $title === null ) {
229  throw new MWException( __METHOD__ . ' called without Title object set' );
230  }
231  $this->wikipage = WikiPage::factory( $title );
232  }
233 
234  return $this->wikipage;
235  }
236 
240  public function setOutput( OutputPage $output ) {
241  $this->output = $output;
242  }
243 
247  public function getOutput() {
248  if ( $this->output === null ) {
249  $this->output = new OutputPage( $this );
250  }
251 
252  return $this->output;
253  }
254 
258  public function setUser( User $user ) {
259  $this->user = $user;
260  }
261 
265  public function getUser() {
266  if ( $this->user === null ) {
267  $this->user = User::newFromSession( $this->getRequest() );
268  }
269 
270  return $this->user;
271  }
272 
279  public static function sanitizeLangCode( $code ) {
280  global $wgLanguageCode;
281 
282  // BCP 47 - letter case MUST NOT carry meaning
283  $code = strtolower( $code );
284 
285  # Validate $code
286  if ( !$code || !Language::isValidCode( $code ) || $code === 'qqq' ) {
288  }
289 
290  return $code;
291  }
292 
298  public function setLanguage( $language ) {
299  if ( $language instanceof Language ) {
300  $this->lang = $language;
301  } elseif ( is_string( $language ) ) {
302  $language = self::sanitizeLangCode( $language );
303  $obj = Language::factory( $language );
304  $this->lang = $obj;
305  } else {
306  throw new MWException( __METHOD__ . " was passed an invalid type of data." );
307  }
308  }
309 
317  public function getLanguage() {
318  if ( isset( $this->recursion ) ) {
319  trigger_error( "Recursion detected in " . __METHOD__, E_USER_WARNING );
320  $e = new Exception;
321  wfDebugLog( 'recursion-guard', "Recursion detected:\n" . $e->getTraceAsString() );
322 
323  $code = $this->getConfig()->get( 'LanguageCode' ) ?: 'en';
324  $this->lang = Language::factory( $code );
325  } elseif ( $this->lang === null ) {
326  $this->recursion = true;
327 
328  try {
329  $request = $this->getRequest();
330  $user = $this->getUser();
331 
332  $code = $request->getVal( 'uselang', 'user' );
333  if ( $code === 'user' ) {
334  $code = $user->getOption( 'language' );
335  }
336  $code = self::sanitizeLangCode( $code );
337 
338  Hooks::run( 'UserGetLanguageObject', [ $user, &$code, $this ] );
339 
340  if ( $code === $this->getConfig()->get( 'LanguageCode' ) ) {
341  $this->lang = MediaWikiServices::getInstance()->getContentLanguage();
342  } else {
343  $obj = Language::factory( $code );
344  $this->lang = $obj;
345  }
346 
347  unset( $this->recursion );
348  }
349  catch ( Exception $ex ) {
350  unset( $this->recursion );
351  throw $ex;
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 = SkinFactory::getDefaultInstance();
374 
375  // If the hook worked try to set a skin from it
376  if ( $skin instanceof Skin ) {
377  $this->skin = $skin;
378  } elseif ( is_string( $skin ) ) {
379  // Normalize the key, just in case the hook did something weird.
380  $normalized = Skin::normalizeKey( $skin );
381  $this->skin = $factory->makeSkin( $normalized );
382  }
383 
384  // If this is still null (the hook didn't run or didn't work)
385  // then go through the normal processing to load a skin
386  if ( $this->skin === null ) {
387  if ( !in_array( 'skin', $this->getConfig()->get( 'HiddenPrefs' ) ) ) {
388  # get the user skin
389  $userSkin = $this->getUser()->getOption( 'skin' );
390  $userSkin = $this->getRequest()->getVal( 'useskin', $userSkin );
391  } else {
392  # if we're not allowing users to override, then use the default
393  $userSkin = $this->getConfig()->get( 'DefaultSkin' );
394  }
395 
396  // Normalize the key in case the user is passing gibberish
397  // or has old preferences (T71566).
398  $normalized = Skin::normalizeKey( $userSkin );
399 
400  // Skin::normalizeKey will also validate it, so
401  // this won't throw an exception
402  $this->skin = $factory->makeSkin( $normalized );
403  }
404 
405  // After all that set a context on whatever skin got created
406  $this->skin->setContext( $this );
407  }
408 
409  return $this->skin;
410  }
411 
421  public function msg( $key ) {
422  $args = func_get_args();
423 
424  return wfMessage( ...$args )->setContext( $this );
425  }
426 
432  public static function getMain() {
433  if ( self::$instance === null ) {
434  self::$instance = new self;
435  }
436 
437  return self::$instance;
438  }
439 
448  public static function getMainAndWarn( $func = __METHOD__ ) {
449  wfDebug( $func . ' called without context. ' .
450  "Using RequestContext::getMain() for sanity\n" );
451 
452  return self::getMain();
453  }
454 
458  public static function resetMain() {
459  if ( !( defined( 'MW_PHPUNIT_TEST' ) || defined( 'MW_PARSER_TEST' ) ) ) {
460  throw new MWException( __METHOD__ . '() should be called only from unit tests!' );
461  }
462  self::$instance = null;
463  }
464 
472  public function exportSession() {
474  return [
475  'ip' => $this->getRequest()->getIP(),
476  'headers' => $this->getRequest()->getAllHeaders(),
477  'sessionId' => $session->isPersistent() ? $session->getId() : '',
478  'userId' => $this->getUser()->getId()
479  ];
480  }
481 
504  public static function importScopedSession( array $params ) {
505  if ( strlen( $params['sessionId'] ) &&
506  MediaWiki\Session\SessionManager::getGlobalSession()->isPersistent()
507  ) {
508  // Sanity check to avoid sending random cookies for the wrong users.
509  // This method should only called by CLI scripts or by HTTP job runners.
510  throw new MWException( "Sessions can only be imported when none is active." );
511  } elseif ( !IP::isValid( $params['ip'] ) ) {
512  throw new MWException( "Invalid client IP address '{$params['ip']}'." );
513  }
514 
515  if ( $params['userId'] ) { // logged-in user
516  $user = User::newFromId( $params['userId'] );
517  $user->load();
518  if ( !$user->getId() ) {
519  throw new MWException( "No user with ID '{$params['userId']}'." );
520  }
521  } else { // anon user
522  $user = User::newFromName( $params['ip'], false );
523  }
524 
525  $importSessionFunc = function ( User $user, array $params ) {
526  global $wgRequest, $wgUser;
527 
529 
530  // Commit and close any current session
531  if ( MediaWiki\Session\PHPSessionHandler::isEnabled() ) {
532  session_write_close(); // persist
533  session_id( '' ); // detach
534  $_SESSION = []; // clear in-memory array
535  }
536 
537  // Get new session, if applicable
538  $session = null;
539  if ( strlen( $params['sessionId'] ) ) { // don't make a new random ID
541  $session = $manager->getSessionById( $params['sessionId'], true )
542  ?: $manager->getEmptySession();
543  }
544 
545  // Remove any user IP or agent information, and attach the request
546  // with the new session.
547  $context->setRequest( new FauxRequest( [], false, $session ) );
548  $wgRequest = $context->getRequest(); // b/c
549 
550  // Now that all private information is detached from the user, it should
551  // be safe to load the new user. If errors occur or an exception is thrown
552  // and caught (leaving the main context in a mixed state), there is no risk
553  // of the User object being attached to the wrong IP, headers, or session.
554  $context->setUser( $user );
555  $wgUser = $context->getUser(); // b/c
556  if ( $session && MediaWiki\Session\PHPSessionHandler::isEnabled() ) {
557  session_id( $session->getId() );
558  Wikimedia\quietCall( 'session_start' );
559  }
560  $request = new FauxRequest( [], false, $session );
561  $request->setIP( $params['ip'] );
562  foreach ( $params['headers'] as $name => $value ) {
563  $request->setHeader( $name, $value );
564  }
565  // Set the current context to use the new WebRequest
566  $context->setRequest( $request );
567  $wgRequest = $context->getRequest(); // b/c
568  };
569 
570  // Stash the old session and load in the new one
571  $oUser = self::getMain()->getUser();
572  $oParams = self::getMain()->exportSession();
573  $oRequest = self::getMain()->getRequest();
574  $importSessionFunc( $user, $params );
575 
576  // Set callback to save and close the new session and reload the old one
577  return new ScopedCallback(
578  function () use ( $importSessionFunc, $oUser, $oParams, $oRequest ) {
579  global $wgRequest;
580  $importSessionFunc( $oUser, $oParams );
581  // Restore the exact previous Request object (instead of leaving FauxRequest)
582  RequestContext::getMain()->setRequest( $oRequest );
583  $wgRequest = RequestContext::getMain()->getRequest(); // b/c
584  }
585  );
586  }
587 
602  public static function newExtraneousContext( Title $title, $request = [] ) {
603  $context = new self;
604  $context->setTitle( $title );
605  if ( $request instanceof WebRequest ) {
606  $context->setRequest( $request );
607  } else {
608  $context->setRequest( new FauxRequest( $request ) );
609  }
610  $context->user = User::newFromName( '127.0.0.1', false );
611 
612  return $context;
613  }
614 }
The wiki should then use memcached to cache various data To use multiple just add more items to the array To increase the weight of a make its entry a array("192.168.0.1:11211", 2))
static factory(Title $title)
Create a WikiPage object of the appropriate class for the given title.
Definition: WikiPage.php:127
setContext(IContextSource $context)
static normalizeKey( $key)
Normalize a skin preference value to a form that can be loaded.
Definition: Skin.php:101
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
getVal( $name, $default=null)
Fetch a scalar from the input or return $default if it&#39;s not set.
Definition: WebRequest.php:440
div flags Integer display flags(NO_ACTION_LINK, NO_EXTRA_USER_LINKS) 'LogException' returning false will NOT prevent logging $e
Definition: hooks.txt:2223
getOption( $oname, $defaultOverride=null, $ignoreHidden=false)
Get the user&#39;s current setting for a given option.
Definition: User.php:3166
$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:47
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
div flags Integer display flags(NO_ACTION_LINK, NO_EXTRA_USER_LINKS) 'LogException' returning false will NOT prevent logging a wrapping ErrorException instead of letting the login form give the generic error message that the account does not exist For when the account has been renamed or deleted or an array to pass a message key and parameters create2 Corresponds to logging log_action database field and which is displayed in the UI similar to $comment this hook should only be used to add variables that depend on the current page request
Definition: hooks.txt:2223
canExist()
Is this in a namespace that allows actual pages?
Definition: Title.php:1099
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:364
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:276
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
static factory( $code)
Get a cached or new language object for a given language code.
Definition: Language.php:214
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
Definition: hooks.txt:822
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:615
getId()
Get the user&#39;s ID.
Definition: User.php:2438
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:756
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:2685
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:302
if(! $wgDBerrorLogTZ) $wgRequest
Definition: Setup.php:734
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:592
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:386
getLanguage()
Get the Language object.
static getDefaultInstance()
Definition: SkinFactory.php:50
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)