Revert r19877; no reason is given for it but it breaks things such as parameter subst...
[lhc/web/wiklou.git] / includes / WebRequest.php
index e603d45..b08fd4e 100644 (file)
@@ -1,7 +1,6 @@
 <?php
 /**
  * Deal with importing all those nasssty globals and things
- * @package MediaWiki
  */
 
 # Copyright (C) 2003 Brion Vibber <brion@pobox.com>
  * you want to pass arbitrary data to some function in place of the web
  * input.
  *
- * @package MediaWiki
  */
+
+/**
+ * Some entry points may use this file without first enabling the 
+ * autoloader.
+ */
+if ( !function_exists( '__autoload' ) ) {
+       require_once( dirname(__FILE__) . '/normal/UtfNormal.php' );
+}
+
 class WebRequest {
-       function WebRequest() {
+       function __construct() {
                $this->checkMagicQuotes();
                global $wgUsePathInfo;
-               if( isset( $_SERVER['PATH_INFO'] ) && ($_SERVER['PATH_INFO'] != '') && $wgUsePathInfo ) {
-                       # Stuff it!
-                       $_GET['title'] = $_REQUEST['title'] =
-                               substr( $_SERVER['PATH_INFO'], 1 );
+               if ( $wgUsePathInfo ) {
+                       if ( isset( $_SERVER['ORIG_PATH_INFO'] ) && $_SERVER['ORIG_PATH_INFO'] != '' ) {
+                               # Mangled PATH_INFO
+                               # http://bugs.php.net/bug.php?id=31892
+                               # Also reported when ini_get('cgi.fix_pathinfo')==false
+                               $_GET['title'] = $_REQUEST['title'] = substr( $_SERVER['ORIG_PATH_INFO'], 1 );
+                       } elseif ( isset( $_SERVER['PATH_INFO'] ) && ($_SERVER['PATH_INFO'] != '') && $wgUsePathInfo ) {
+                               $_GET['title'] = $_REQUEST['title'] = substr( $_SERVER['PATH_INFO'], 1 );
+                       }
                }
        }
+       
+       private $_response;
 
        /**
         * Recursively strips slashes from the given array;
         * used for undoing the evil that is magic_quotes_gpc.
         * @param array &$arr will be modified
         * @return array the original array
-        * @access private
+        * @private
         */
        function &fix_magic_quotes( &$arr ) {
                foreach( $arr as $key => $val ) {
@@ -68,7 +82,7 @@ class WebRequest {
         * through fix_magic_quotes to strip out the stupid slashes.
         * WARNING: This should only be done once! Running a second
         * time could damage the values.
-        * @access private
+        * @private
         */
        function checkMagicQuotes() {
                if ( get_magic_quotes_gpc() ) {
@@ -85,7 +99,7 @@ class WebRequest {
         * Recursively normalizes UTF-8 strings in the given array.
         * @param array $data string or array
         * @return cleaned-up version of the given
-        * @access private
+        * @private
         */
        function normalizeUnicode( $data ) {
                if( is_array( $data ) ) {
@@ -105,7 +119,7 @@ class WebRequest {
         * @param string $name
         * @param mixed $default
         * @return mixed
-        * @access private
+        * @private
         */
        function getGPCVal( $arr, $name, $default ) {
                if( isset( $arr[$name] ) ) {
@@ -117,7 +131,6 @@ class WebRequest {
                                        $data = $wgContLang->checkTitleEncoding( $data );
                                }
                        }
-                       require_once( 'normal/UtfNormal.php' );
                        $data = $this->normalizeUnicode( $data );
                        return $data;
                } else {
@@ -288,10 +301,15 @@ class WebRequest {
         * Returns true if there is a session cookie set.
         * This does not necessarily mean that the user is logged in!
         *
+        * If you want to check for an open session, use session_id()
+        * instead; that will also tell you if the session was opened
+        * during the current request (in which case the cookie will
+        * be sent back to the client at the end of the script run).
+        *
         * @return bool
         */
        function checkSessionCookie() {
-               return isset( $_COOKIE[ini_get('session.name')] );
+               return isset( $_COOKIE[session_name()] );
        }
 
        /**
@@ -299,7 +317,20 @@ class WebRequest {
         * @return string
         */
        function getRequestURL() {
-               $base = $_SERVER['REQUEST_URI'];
+               if( isset( $_SERVER['REQUEST_URI'] ) ) {
+                       $base = $_SERVER['REQUEST_URI'];
+               } elseif( isset( $_SERVER['SCRIPT_NAME'] ) ) {
+                       // Probably IIS; doesn't set REQUEST_URI
+                       $base = $_SERVER['SCRIPT_NAME'];
+                       if( isset( $_SERVER['QUERY_STRING'] ) && $_SERVER['QUERY_STRING'] != '' ) {
+                               $base .= '?' . $_SERVER['QUERY_STRING'];
+                       }
+               } else {
+                       // This shouldn't happen!
+                       throw new MWException( "Web server doesn't provide either " .
+                               "REQUEST_URI or SCRIPT_NAME. Report details of your " .
+                               "web server configuration to http://bugzilla.wikimedia.org/" );
+               }
                if( $base{0} == '/' ) {
                        return $base;
                } else {
@@ -319,14 +350,20 @@ class WebRequest {
 
        /**
         * Take an arbitrary query and rewrite the present URL to include it
-        * @param string $query Query string fragment; do not include initial '?'
+        * @param $query String: query string fragment; do not include initial '?'
         * @return string
         */
        function appendQuery( $query ) {
                global $wgTitle;
                $basequery = '';
                foreach( $_GET as $var => $val ) {
-                       if( $var == 'title' ) continue;
+                       if ( $var == 'title' )
+                               continue;
+                       if ( is_array( $val ) )
+                               /* This will happen given a request like
+                                * http://en.wikipedia.org/w/index.php?title[]=Special:Userlogin&returnto[]=Main_Page
+                                */
+                               continue;
                        $basequery .= '&' . urlencode( $var ) . '=' . urlencode( $val );
                }
                $basequery .= '&' . $query;
@@ -338,7 +375,7 @@ class WebRequest {
 
        /**
         * HTML-safe version of appendQuery().
-        * @param string $query Query string fragment; do not include initial '?'
+        * @param $query String: query string fragment; do not include initial '?'
         * @return string
         */
        function escapeAppendQuery( $query ) {
@@ -350,8 +387,8 @@ class WebRequest {
         * defaults if not given. The limit must be positive and is capped at 5000.
         * Offset must be positive but is not capped.
         *
-        * @param int $deflimit Limit to use if no input and the user hasn't set the option.
-        * @param string $optionname To specify an option other than rclimit to pull from.
+        * @param $deflimit Integer: limit to use if no input and the user hasn't set the option.
+        * @param $optionname String: to specify an option other than rclimit to pull from.
         * @return array first element is limit, second is offset
         */
        function getLimitOffset( $deflimit = 50, $optionname = 'rclimit' ) {
@@ -373,7 +410,7 @@ class WebRequest {
 
        /**
         * Return the path to the temporary file where PHP has stored the upload.
-        * @param string $key
+        * @param $key String:
         * @return string or NULL if no such file.
         */
        function getFileTempname( $key ) {
@@ -385,7 +422,7 @@ class WebRequest {
 
        /**
         * Return the size of the upload, or 0.
-        * @param string $key
+        * @param $key String:
         * @return integer
         */
        function getFileSize( $key ) {
@@ -397,7 +434,7 @@ class WebRequest {
 
        /**
         * Return the upload error or 0
-        * @param string $key
+        * @param $key String:
         * @return integer
         */
        function getUploadError( $key ) {
@@ -415,7 +452,7 @@ class WebRequest {
         *
         * Other than this the name is not verified for being a safe filename.
         *
-        * @param string $key
+        * @param $key String: 
         * @return string or NULL if no such file.
         */
        function getFileName( $key ) {
@@ -431,12 +468,24 @@ class WebRequest {
                wfDebug( "WebRequest::getFileName() '" . $_FILES[$key]['name'] . "' normalized to '$name'\n" );
                return $name;
        }
+       
+       /**
+        * Return a handle to WebResponse style object, for setting cookies, 
+        * headers and other stuff, for Request being worked on.
+        */
+       function response() {
+               /* Lazy initialization of response object for this request */
+               if (!is_object($this->_response)) {
+                       $this->_response = new WebResponse;
+               } 
+               return $this->_response;
+       }
+       
 }
 
 /**
  * WebRequest clone which takes values from a provided array.
  *
- * @package MediaWiki
  */
 class FauxRequest extends WebRequest {
        var $data = null;
@@ -446,7 +495,7 @@ class FauxRequest extends WebRequest {
                if( is_array( $data ) ) {
                        $this->data = $data;
                } else {
-                       wfDebugDieBacktrace( "FauxRequest() got bogus data" );
+                       throw new MWException( "FauxRequest() got bogus data" );
                }
                $this->wasPosted = $wasPosted;
        }
@@ -473,11 +522,11 @@ class FauxRequest extends WebRequest {
        }
 
        function getRequestURL() {
-               wfDebugDieBacktrace( 'FauxRequest::getRequestURL() not implemented' );
+               throw new MWException( 'FauxRequest::getRequestURL() not implemented' );
        }
 
        function appendQuery( $query ) {
-               wfDebugDieBacktrace( 'FauxRequest::appendQuery() not implemented' );
+               throw new MWException( 'FauxRequest::appendQuery() not implemented' );
        }
 
 }