X-Git-Url: http://git.heureux-cyclage.org/?a=blobdiff_plain;f=api.php;h=370884dffc8bd22109c4d34472c9c520ab01c817;hb=eb811913b82e5fbb0fff18644adb3e8507ff0eab;hp=c96c6470c2d82fe793042cb302b8afd4a8c3ad41;hpb=f97b323e003ff8007bff05f30156f38bc1a93b5a;p=lhc%2Fweb%2Fwiklou.git diff --git a/api.php b/api.php index c96c6470c2..370884dffc 100644 --- a/api.php +++ b/api.php @@ -1,117 +1,146 @@ - -* -* 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., -* 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. -* http://www.gnu.org/copyleft/gpl.html -*/ - -$wgApiStartTime = microtime(true); - -/** - * When no format parameter is given, this format will be used - */ -define('API_DEFAULT_FORMAT', 'xmlfm'); - -/** - * List of classes and containing files. - */ -$wgApiAutoloadClasses = array ( - - 'ApiMain' => 'ApiMain.php', - - // Utility classes - 'ApiBase' => 'ApiBase.php', - 'ApiQueryBase' => 'ApiQueryBase.php', - 'ApiResult' => 'ApiResult.php', - 'ApiPageSet' => 'ApiPageSet.php', - - // Formats - 'ApiFormatBase' => 'ApiFormatBase.php', - 'ApiFormatYaml' => 'ApiFormatYaml.php', - 'ApiFormatXml' => 'ApiFormatXml.php', - 'ApiFormatJson' => 'ApiFormatJson.php', - - // Modules (action=...) - should match the $apiModules list - 'ApiHelp' => 'ApiHelp.php', - 'ApiLogin' => 'ApiLogin.php', - 'ApiQuery' => 'ApiQuery.php', - - // Query items (meta/prop/list=...) - 'ApiQuerySiteinfo' => 'ApiQuerySiteinfo.php', - 'ApiQueryInfo' => 'ApiQueryInfo.php', - 'ApiQueryRevisions' => 'ApiQueryRevisions.php', - 'ApiQueryAllpages' => 'ApiQueryAllpages.php' -); - -/** - * List of available modules: action name => module class - * The class must also be listed in the $wgApiAutoloadClasses array. - */ -$wgApiModules = array ( - 'help' => 'ApiHelp', - 'login' => 'ApiLogin', - 'query' => 'ApiQuery' -); - -/** - * List of available formats: format name => format class - * The class must also be listed in the $wgApiAutoloadClasses array. - */ -$wgApiFormats = array ( - 'json' => 'ApiFormatJson', - 'jsonfm' => 'ApiFormatJson', - 'xml' => 'ApiFormatXml', - 'xmlfm' => 'ApiFormatXml', - 'yaml' => 'ApiFormatYaml', - 'yamlfm' => 'ApiFormatYaml' -); - -// Initialise common code -require (dirname(__FILE__) . '/includes/WebStart.php'); -wfProfileIn('api.php'); - -// Verify that the API has not been disabled -// The next line should be -// if (isset ($wgEnableAPI) && !$wgEnableAPI) { -// but will be in a safe mode until api is stabler -if (!isset ($wgEnableAPI) || !$wgEnableAPI) { - echo 'MediaWiki API is not enabled for this site. Add the following line to your LocalSettings.php'; - echo '
$wgEnableAPI=true;
'; - die(-1); -} - -apiInitAutoloadClasses($wgApiAutoloadClasses, "$IP/includes/api/"); -$processor = new ApiMain($wgApiStartTime, $wgApiModules, $wgApiFormats); -$processor->execute(); - -wfProfileOut('api.php'); -wfLogProfilingData(); -exit; // Done! - -function apiInitAutoloadClasses($apiAutoloadClasses, $apiDirectory) { - - // Prefix each api class with the proper prefix, - // and append them to $wgAutoloadClasses - global $wgAutoloadClasses; - - foreach ($apiAutoloadClasses as $className => $classFile) - $wgAutoloadClasses[$className] = $apiDirectory . $classFile; -} -?> +@gmail.com + * + * 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 + */ + +/** + * This file is the entry point for all API queries. It begins by checking + * whether the API is enabled on this wiki; if not, it informs the user that + * s/he should set $wgEnableAPI to true and exits. Otherwise, it constructs + * a new ApiMain using the parameter passed to it as an argument in the URL + * ('?action=') and with write-enabled set to the value of $wgEnableWriteAPI + * as specified in LocalSettings.php. It then invokes "execute()" on the + * ApiMain object instance, which produces output in the format sepecified + * in the URL. + */ + +// So extensions (and other code) can check whether they're running in API mode +define( 'MW_API', true ); + +// Initialise common code +require ( dirname( __FILE__ ) . '/includes/WebStart.php' ); + +wfProfileIn( 'api.php' ); +$starttime = microtime( true ); + +// URL safety checks +// +// See RawPage.php for details; summary is that MSIE can override the +// Content-Type if it sees a recognized extension on the URL, such as +// might be appended via PATH_INFO after 'api.php'. +// +// Some data formats can end up containing unfiltered user-provided data +// which will end up triggering HTML detection and execution, hence +// XSS injection and all that entails. +// +if ( $wgRequest->isPathInfoBad() ) { + wfHttpError( 403, 'Forbidden', + 'Invalid file extension found in PATH_INFO. ' . + 'The API must be accessed through the primary script entry point.' ); + return; +} + +// Verify that the API has not been disabled +if ( !$wgEnableAPI ) { + echo 'MediaWiki API is not enabled for this site. Add the following line to your LocalSettings.php'; + echo '
$wgEnableAPI=true;
'; + die( 1 ); +} + +// Selectively allow cross-site AJAX + +/* + * Helper function to convert wildcard string into a regex + * '*' => '.*?' + * '?' => '.' + * @ return string + */ +function convertWildcard( $search ) { + $search = preg_quote( $search, '/' ); + $search = str_replace( + array( '\*', '\?' ), + array( '.*?', '.' ), + $search + ); + return "/$search/"; +} + +if ( $wgCrossSiteAJAXdomains && isset( $_SERVER['HTTP_ORIGIN'] ) ) { + $exceptions = array_map( 'convertWildcard', $wgCrossSiteAJAXdomainExceptions ); + $regexes = array_map( 'convertWildcard', $wgCrossSiteAJAXdomains ); + foreach ( $regexes as $regex ) { + if ( preg_match( $regex, $_SERVER['HTTP_ORIGIN'] ) ) { + foreach ( $exceptions as $exc ) { // Check against exceptions + if ( preg_match( $exc, $_SERVER['HTTP_ORIGIN'] ) ) { + break 2; + } + } + header( "Access-Control-Allow-Origin: {$_SERVER['HTTP_ORIGIN']}" ); + header( 'Access-Control-Allow-Credentials: true' ); + break; + } + } +} + +// Set a dummy $wgTitle, because $wgTitle == null breaks various things +// In a perfect world this wouldn't be necessary +$wgTitle = Title::makeTitle( NS_MAIN, 'API' ); + +/* Construct an ApiMain with the arguments passed via the URL. What we get back + * is some form of an ApiMain, possibly even one that produces an error message, + * but we don't care here, as that is handled by the ctor. + */ +$processor = new ApiMain( $wgRequest, $wgEnableWriteAPI ); + +// Process data & print results +$processor->execute(); + +// Execute any deferred updates +wfDoUpdates(); + +// Log what the user did, for book-keeping purposes. +$endtime = microtime( true ); +wfProfileOut( 'api.php' ); +wfLogProfilingData(); + +// Log the request +if ( $wgAPIRequestLog ) { + $items = array( + wfTimestamp( TS_MW ), + $endtime - $starttime, + wfGetIP(), + $_SERVER['HTTP_USER_AGENT'] + ); + $items[] = $wgRequest->wasPosted() ? 'POST' : 'GET'; + if ( $processor->getModule()->mustBePosted() ) { + $items[] = "action=" . $wgRequest->getVal( 'action' ); + } else { + $items[] = wfArrayToCGI( $wgRequest->getValues() ); + } + wfErrorLog( implode( ',', $items ) . "\n", $wgAPIRequestLog ); + wfDebug( "Logged API request to $wgAPIRequestLog\n" ); +} + +// Shut down the database +wfGetLBFactory()->shutdown(); +