(bug 37183) Removed hard coded parentheses in SpecialListfiles.php
[lhc/web/wiklou.git] / includes / AjaxDispatcher.php
index 0034ecf..e3df520 100644 (file)
 <?php
-
-if( !defined( 'MEDIAWIKI' ) )
-        die( 1 );
-
-if ( ! $wgUseAjax ) {
-       die( 1 );
-}
-
-require_once( 'AjaxFunctions.php' );
-
+/**
+ * Handle ajax requests and send them to the proper handler.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ * @ingroup Ajax
+ */
+
+/**
+ * @defgroup Ajax Ajax
+ */
+
+/**
+ * Object-Oriented Ajax functions.
+ * @ingroup Ajax
+ */
 class AjaxDispatcher {
-       var $mode;
-       var $func_name;
-       var $args;
-
+       /**
+        * The way the request was made, either a 'get' or a 'post'
+        * @var string $mode
+        */
+       private $mode;
+
+       /**
+        * Name of the requested handler
+        * @var string $func_name
+        */
+       private $func_name;
+
+       /** Arguments passed
+        * @var array $args
+        */
+       private $args;
+
+       /**
+        * Load up our object with user supplied data
+        */
        function __construct() {
                wfProfileIn( __METHOD__ );
 
                $this->mode = "";
 
-               if (! empty($_GET["rs"])) {
+               if ( ! empty( $_GET["rs"] ) ) {
                        $this->mode = "get";
                }
 
-               if (!empty($_POST["rs"])) {
+               if ( !empty( $_POST["rs"] ) ) {
                        $this->mode = "post";
                }
 
-               if ($this->mode == "get") {
-                       $this->func_name = isset( $_GET["rs"] ) ? $_GET["rs"] : '';
-                       if (! empty($_GET["rsargs"])) {
-                               $this->args = $_GET["rsargs"];
-                       } else {
-                               $this->args = array();
-                       }
-               } else {
-                       $this->func_name = isset( $_POST["rs"] ) ? $_POST["rs"] : '';
-                       if (! empty($_POST["rsargs"])) {
-                               $this->args = $_POST["rsargs"];
-                       } else {
-                               $this->args = array();
-                       }
+               switch( $this->mode ) {
+                       case 'get':
+                               $this->func_name = isset( $_GET["rs"] ) ? $_GET["rs"] : '';
+                               if ( ! empty( $_GET["rsargs"] ) ) {
+                                       $this->args = $_GET["rsargs"];
+                               } else {
+                                       $this->args = array();
+                               }
+                               break;
+                       case 'post':
+                               $this->func_name = isset( $_POST["rs"] ) ? $_POST["rs"] : '';
+                               if ( ! empty( $_POST["rsargs"] ) ) {
+                                       $this->args = $_POST["rsargs"];
+                               } else {
+                                       $this->args = array();
+                               }
+                               break;
+                       default:
+                               wfProfileOut( __METHOD__ );
+                               return;
+                               # Or we could throw an exception:
+                               # throw new MWException( __METHOD__ . ' called without any data (mode empty).' );
                }
+
                wfProfileOut( __METHOD__ );
        }
 
+       /**
+        * Pass the request to our internal function.
+        * BEWARE! Data are passed as they have been supplied by the user,
+        * they should be carefully handled in the function processing the
+        * request.
+        */
        function performAction() {
-               global $wgAjaxExportList, $wgOut;
+               global $wgAjaxExportList, $wgOut, $wgUser;
 
                if ( empty( $this->mode ) ) {
                        return;
                }
+
                wfProfileIn( __METHOD__ );
 
-               if (! in_array( $this->func_name, $wgAjaxExportList ) ) {
-                       header( 'Status: 400 Bad Request', true, 400 );
-                       print "unknown function " . htmlspecialchars( (string) $this->func_name );
+               if ( ! in_array( $this->func_name, $wgAjaxExportList ) ) {
+                       wfDebug( __METHOD__ . ' Bad Request for unknown function ' . $this->func_name . "\n" );
+
+                       wfHttpError(
+                               400,
+                               'Bad Request',
+                               "unknown function " . (string) $this->func_name
+                       );
+               } elseif ( !in_array( 'read', User::getGroupPermissions( array( '*' ) ), true ) 
+                       && !$wgUser->isAllowed( 'read' ) )
+               {
+                       wfHttpError(
+                               403,
+                               'Forbidden',
+                               'You must log in to view pages.' );
                } else {
+                       wfDebug( __METHOD__ . ' dispatching ' . $this->func_name . "\n" );
+
+                       if ( strpos( $this->func_name, '::' ) !== false ) {
+                               $func = explode( '::', $this->func_name, 2 );
+                       } else {
+                               $func = $this->func_name;
+                       }
+
                        try {
-                               $result = call_user_func_array($this->func_name, $this->args);
+                               $result = call_user_func_array( $func, $this->args );
 
-                               if ( $result === false || $result === NULL ) {
-                                       header( 'Status: 500 Internal Error', true, 500 );
-                                       echo "{$this->func_name} returned no data";
-                               }
-                               else {
+                               if ( $result === false || $result === null ) {
+                                       wfDebug( __METHOD__ . ' ERROR while dispatching '
+                                                       . $this->func_name . "(" . var_export( $this->args, true ) . "): "
+                                                       . "no data returned\n" );
+
+                                       wfHttpError( 500, 'Internal Error',
+                                               "{$this->func_name} returned no data" );
+                               } else {
                                        if ( is_string( $result ) ) {
-                                               $result= new AjaxResponse( $result );
+                                               $result = new AjaxResponse( $result );
                                        }
 
                                        $result->sendHeaders();
                                        $result->printText();
-                               }
 
-                       } catch (Exception $e) {
-                               if (!headers_sent()) {
-                                       header( 'Status: 500 Internal Error', true, 500 );
-                                       print $e->getMessage();
+                                       wfDebug( __METHOD__ . ' dispatch complete for ' . $this->func_name . "\n" );
+                               }
+                       } catch ( Exception $e ) {
+                               wfDebug( __METHOD__ . ' ERROR while dispatching '
+                                               . $this->func_name . "(" . var_export( $this->args, true ) . "): "
+                                               . get_class( $e ) . ": " . $e->getMessage() . "\n" );
+
+                               if ( !headers_sent() ) {
+                                       wfHttpError( 500, 'Internal Error',
+                                               $e->getMessage() );
                                } else {
                                        print $e->getMessage();
                                }
                        }
                }
 
-               wfProfileOut( __METHOD__ );
                $wgOut = null;
+               wfProfileOut( __METHOD__ );
        }
 }
-
-?>