From 368dbc5f5b870a6f4e60865b7f5fe72a73d98527 Mon Sep 17 00:00:00 2001
From: Daniel Friesen <dantman@users.mediawiki.org>
Date: Mon, 5 Sep 2011 15:25:20 +0000
Subject: [PATCH] Add a new RequestContext::newExtraneousContext() to create a
 context filled with data not derived from the current session. Also modify
 setLang to accept a language code.

---
 includes/RequestContext.php | 71 ++++++++++++++++++++++++++++++-------
 1 file changed, 59 insertions(+), 12 deletions(-)

diff --git a/includes/RequestContext.php b/includes/RequestContext.php
index c0b49a1e8a..e3a19a3251 100644
--- a/includes/RequestContext.php
+++ b/includes/RequestContext.php
@@ -191,13 +191,40 @@ class RequestContext implements IContextSource {
 		return $this->user;
 	}
 
+	/**
+	 * Accepts a language code and ensures it's sane. Outputs a cleaned up language
+	 * code and replaces with $wgLanguageCode if not sane.
+	 */
+	private static function sanitizeLangCode( $code ) {
+		global $wgLanguageCode;
+
+		// BCP 47 - letter case MUST NOT carry meaning
+		$code = strtolower( $code );
+
+		# Validate $code
+		if( empty( $code ) || !Language::isValidCode( $code ) || ( $code === 'qqq' ) ) {
+			wfDebug( "Invalid user language code\n" );
+			$code = $wgLanguageCode;
+		}
+
+		return $code;
+	}
+
 	/**
 	 * Set the Language object
 	 *
-	 * @param $l Language
-	 */
-	public function setLang( Language $l ) {
-		$this->lang = $l;
+	 * @param $l Mixed Language instance or language code
+	 */
+	public function setLang( $l ) {
+		if ( $l instanceof Language ) {
+			$this->lang = $l;
+		} elseif ( is_string( $l ) ) {
+			$l = self::sanitizeLangCode( $l );
+			$obj = Language::factory( $l );
+			$this->lang = $obj;
+		} else {
+			throw new MWException( __METHOD__ . " was passed an invalid type of data." );
+		}
 	}
 
 	/**
@@ -212,14 +239,7 @@ class RequestContext implements IContextSource {
 				'uselang',
 				$this->getUser()->getOption( 'language' )
 			);
-			// BCP 47 - letter case MUST NOT carry meaning
-			$code = strtolower( $code );
-
-			# Validate $code
-			if( empty( $code ) || !Language::isValidCode( $code ) || ( $code === 'qqq' ) ) {
-				wfDebug( "Invalid user language code\n" );
-				$code = $wgLanguageCode;
-			}
+			$code = self::sanitizeLangCode( $code );
 
 			wfRunHooks( 'UserGetLanguageObject', array( $this->getUser(), &$code ) );
 
@@ -297,6 +317,33 @@ class RequestContext implements IContextSource {
 		}
 		return $instance;
 	}
+
+	/**
+	 * Create a new extraneous context. The context is filled with information
+	 * external to the current session.
+	 * - Title is specified by argument
+	 * - Request is a FauxRequest, or a FauxRequest can be specified by argument
+	 * - User is an anonymous user, for separation IPv4 localhost is used
+	 * - Language will be based on the anonymous user and request, may be content
+	 *   language or a uselang param in the fauxrequest data may change the lang
+	 * - Skin will be based on the anonymous user, should be the wiki's default skin
+	 *
+	 * @param $title Title Title to use for the extraneous request
+	 * @param $request Mixed A WebRequest or data to use for a FauxRequest
+	 * @return RequestContext
+	 */
+	public static function newExtraneousContext( Title $title, $request=array() ) {
+		$context = new self;
+		$context->setTitle( $title );
+		if ( $request instanceof WebRequest ) {
+			$context->setRequest( $request );
+		} else {
+			$context->setRequest( new FauxRequest( $request ) );
+		}
+		$context->user = User::newFromName( '127.0.0.1', false );
+		return $context;
+	}
+
 }
 
 /**
-- 
2.20.1