*/
use Wikimedia\Rdbms\IDatabase;
+use MediaWiki\MediaWikiServices;
/**
* This abstract class implements many basic API functions, and is the base of
/** @var array Maps extension paths to info arrays */
private static $extensionInfo = null;
+ /** @var int[][][] Cache for self::filterIDs() */
+ private static $filterIDsCache = [];
+
/** @var ApiMain */
private $mMainModule;
/** @var string */
private $mModuleName, $mModulePrefix;
- private $mSlaveDB = null;
+ private $mReplicaDB = null;
private $mParamCache = [];
/** @var array|null|bool */
private $mModuleSource = false;
* @return array
*/
protected function getExamplesMessages() {
- // Fall back to old non-localised method
- $ret = [];
-
- $examples = $this->getExamples();
- if ( $examples ) {
- if ( !is_array( $examples ) ) {
- $examples = [ $examples ];
- } elseif ( $examples && ( count( $examples ) & 1 ) == 0 &&
- array_keys( $examples ) === range( 0, count( $examples ) - 1 ) &&
- !preg_match( '/^\s*api\.php\?/', $examples[0] )
- ) {
- // Fix up the ugly "even numbered elements are description, odd
- // numbered elemts are the link" format (see doc for self::getExamples)
- $tmp = [];
- $examplesCount = count( $examples );
- for ( $i = 0; $i < $examplesCount; $i += 2 ) {
- $tmp[$examples[$i + 1]] = $examples[$i];
- }
- $examples = $tmp;
- }
-
- foreach ( $examples as $k => $v ) {
- if ( is_numeric( $k ) ) {
- $qs = $v;
- $msg = '';
- } else {
- $qs = $k;
- $msg = self::escapeWikiText( $v );
- if ( is_array( $msg ) ) {
- $msg = implode( ' ', $msg );
- }
- }
-
- $qs = preg_replace( '/^\s*api\.php\?/', '', $qs );
- $ret[$qs] = $this->msg( 'api-help-fallback-example', [ $msg ] );
- }
- }
-
- return $ret;
+ return [];
}
/**
* @return IDatabase
*/
protected function getDB() {
- if ( !isset( $this->mSlaveDB ) ) {
- $this->mSlaveDB = wfGetDB( DB_REPLICA, 'api' );
+ if ( !isset( $this->mReplicaDB ) ) {
+ $this->mReplicaDB = wfGetDB( DB_REPLICA, 'api' );
}
- return $this->mSlaveDB;
+ return $this->mReplicaDB;
}
/**
return $user;
}
- /**
- * A subset of wfEscapeWikiText for BC texts
- *
- * @since 1.25
- * @param string|array $v
- * @return string|array
- */
- private static function escapeWikiText( $v ) {
- if ( is_array( $v ) ) {
- return array_map( 'self::escapeWikiText', $v );
- } else {
- return strtr( $v, [
- '__' => '__', '{' => '{', '}' => '}',
- '[[Category:' => '[[:Category:',
- '[[File:' => '[[:File:', '[[Image:' => '[[:Image:',
- ] );
- }
- }
-
/**
* Create a Message from a string or array
*
'blocked',
[ 'blockinfo' => ApiQueryUserInfo::getBlockInfo( $user->getBlock() ) ]
) );
+ } elseif ( is_array( $error ) && $error[0] === 'blockedtext-partial' && $user->getBlock() ) {
+ $status->fatal( ApiMessage::create(
+ 'apierror-blocked-partial',
+ 'blocked',
+ [ 'blockinfo' => ApiQueryUserInfo::getBlockInfo( $user->getBlock() ) ]
+ ) );
} elseif ( is_array( $error ) && $error[0] === 'autoblockedtext' && $user->getBlock() ) {
$status->fatal( ApiMessage::create(
'apierror-autoblocked',
}
}
+ /**
+ * Filter out-of-range values from a list of positive integer IDs
+ * @since 1.33
+ * @param array $fields Array of pairs of table and field to check
+ * @param (string|int)[] $ids IDs to filter. Strings in the array are
+ * expected to be stringified ints.
+ * @return (string|int)[] Filtered IDs.
+ */
+ protected function filterIDs( $fields, array $ids ) {
+ $min = INF;
+ $max = 0;
+ foreach ( $fields as list( $table, $field ) ) {
+ if ( isset( self::$filterIDsCache[$table][$field] ) ) {
+ $row = self::$filterIDsCache[$table][$field];
+ } else {
+ $row = $this->getDB()->selectRow(
+ $table,
+ [
+ 'min_id' => "MIN($field)",
+ 'max_id' => "MAX($field)",
+ ],
+ null,
+ __METHOD__
+ );
+ self::$filterIDsCache[$table][$field] = $row;
+ }
+ $min = min( $min, $row->min_id );
+ $max = max( $max, $row->max_id );
+ }
+ return array_filter( $ids, function ( $id ) use ( $min, $max ) {
+ return ( is_int( $id ) && $id >= 0 || ctype_digit( $id ) )
+ && $id >= $min && $id <= $max;
+ } );
+ }
+
/**@}*/
/************************************************************************//**
'autoblocked',
[ 'blockinfo' => ApiQueryUserInfo::getBlockInfo( $block ) ]
);
+ } elseif ( !$block->isSitewide() ) {
+ $this->dieWithError(
+ 'apierror-blocked-partial',
+ 'blocked',
+ [ 'blockinfo' => ApiQueryUserInfo::getBlockInfo( $block ) ]
+ );
} else {
$this->dieWithError(
'apierror-blocked',
foreach ( (array)$actions as $action ) {
$errors = array_merge( $errors, $title->getUserPermissionsErrors( $action, $user ) );
}
+
if ( $errors ) {
+ // track block notices
+ if ( $this->getConfig()->get( 'EnableBlockNoticeStats' ) ) {
+ $this->trackBlockNotices( $errors );
+ }
+
$this->dieStatus( $this->errorArrayToStatus( $errors, $user ) );
}
}
+ /**
+ * Keep track of errors messages resulting from a block
+ *
+ * @param array $errors
+ */
+ private function trackBlockNotices( array $errors ) {
+ $errorMessageKeys = [
+ 'blockedtext',
+ 'blockedtext-partial',
+ 'autoblockedtext',
+ 'systemblockedtext',
+ ];
+
+ $statsd = MediaWikiServices::getInstance()->getStatsdDataFactory();
+
+ foreach ( $errors as $error ) {
+ if ( in_array( $error[0], $errorMessageKeys ) ) {
+ $wiki = $this->getConfig()->get( 'DBname' );
+ $statsd->increment( 'BlockNotices.' . $wiki . '.MediaWikiApi.returned' );
+ break;
+ }
+ }
+ }
+
/**
* Will only set a warning instead of failing if the global $wgDebugAPI
* is set to true. Otherwise behaves exactly as self::dieWithError().
/**
* Get final module summary
*
- * Ideally this will just be the getSummaryMessage(). However, for
- * backwards compatibility, if that message does not exist then the first
- * line of wikitext from the description message will be used instead.
- *
* @since 1.30
* @return Message
*/
$this->getModuleName(),
$this->getModulePath(),
] );
- if ( !$msg->exists() ) {
- wfDeprecated( 'API help "description" messages', '1.30' );
- $msg = self::makeMessage( $this->getDescriptionMessage(), $this->getContext(), [
- $this->getModulePrefix(),
- $this->getModuleName(),
- $this->getModulePath(),
- ] );
- $msg = self::makeMessage( 'rawmessage', $this->getContext(), [
- preg_replace( '/\n.*/s', '', $msg->text() )
- ] );
- }
return $msg;
}
* @return Message[]
*/
public function getFinalDescription() {
- $desc = $this->getDescription();
-
- // Avoid PHP 7.1 warning of passing $this by reference
- $apiModule = $this;
- Hooks::run( 'APIGetDescription', [ &$apiModule, &$desc ], '1.25' );
- $desc = self::escapeWikiText( $desc );
- if ( is_array( $desc ) ) {
- $desc = implode( "\n", $desc );
- } else {
- $desc = (string)$desc;
- }
-
$summary = self::makeMessage( $this->getSummaryMessage(), $this->getContext(), [
$this->getModulePrefix(),
$this->getModuleName(),
]
);
- if ( $summary->exists() ) {
- $msgs = [ $summary, $extendedDescription ];
- } else {
- wfDeprecated( 'API help "description" messages', '1.30' );
- $description = self::makeMessage( $this->getDescriptionMessage(), $this->getContext(), [
- $this->getModulePrefix(),
- $this->getModuleName(),
- $this->getModulePath(),
- ] );
- if ( !$description->exists() ) {
- $description = $this->msg( 'api-help-fallback-description', $desc );
- }
- $msgs = [ $description ];
- }
+ $msgs = [ $summary, $extendedDescription ];
Hooks::run( 'APIGetDescriptionMessages', [ $this, &$msgs ] );
$name = $this->getModuleName();
$path = $this->getModulePath();
- $desc = $this->getParamDescription();
-
- // Avoid PHP 7.1 warning of passing $this by reference
- $apiModule = $this;
- Hooks::run( 'APIGetParamDescription', [ &$apiModule, &$desc ], '1.25' );
-
- if ( !$desc ) {
- $desc = [];
- }
- $desc = self::escapeWikiText( $desc );
-
$params = $this->getFinalParams( self::GET_VALUES_FOR_HELP );
$msgs = [];
foreach ( $params as $param => $settings ) {
$settings = [];
}
- $d = $desc[$param] ?? '';
- if ( is_array( $d ) ) {
- // Special handling for prop parameters
- $d = array_map( function ( $line ) {
- if ( preg_match( '/^\s+(\S+)\s+-\s+(.+)$/', $line, $m ) ) {
- $line = "\n;{$m[1]}:{$m[2]}";
- }
- return $line;
- }, $d );
- $d = implode( ' ', $d );
- }
-
if ( isset( $settings[self::PARAM_HELP_MSG] ) ) {
$msg = $settings[self::PARAM_HELP_MSG];
} else {
$msg = $this->msg( "apihelp-{$path}-param-{$param}" );
- if ( !$msg->exists() ) {
- $msg = $this->msg( 'api-help-fallback-parameter', $d );
- }
}
$msg = self::makeMessage( $msg, $this->getContext(),
[ $prefix, $param, $name, $path ] );
* @return Message|string|array|false
*/
protected function getDescription() {
+ wfDeprecated( __METHOD__, '1.25' );
return false;
}
* @return array|bool False on no parameter descriptions
*/
protected function getParamDescription() {
+ wfDeprecated( __METHOD__, '1.25' );
return [];
}
* @return bool|string|array
*/
protected function getExamples() {
+ wfDeprecated( __METHOD__, '1.25' );
return false;
}
* @return string|array|Message
*/
protected function getDescriptionMessage() {
+ wfDeprecated( __METHOD__, '1.30' );
return [ [
"apihelp-{$this->getModulePath()}-description",
"apihelp-{$this->getModulePath()}-summary",
dépôts / lhc / web / wiklou.git / blobdiff