41 private $mQueryModule,
$mDb;
46 private $queryBuilder;
55 parent::__construct( $queryModule->
getMain(), $moduleName, $paramPrefix );
56 $this->mQueryModule = $queryModule;
105 return $this->mQueryModule;
119 $this->mDb ??= $this->
getQuery()->getDB();
138 $this->mDb = $this->
getQuery()->getNamedDB( $name, $db, $groups );
148 return $this->
getQuery()->getPageSet();
161 $this->queryBuilder =
null;
173 $this->queryBuilder ??= $this->
getDB()->newSelectQueryBuilder();
174 return $this->queryBuilder;
184 protected function addTables( $tables, $alias =
null ) {
185 if ( is_array( $tables ) ) {
186 if ( $alias !==
null ) {
204 if ( !is_array( $join_conds ) ) {
248 if ( is_array( $value ) ) {
251 if ( count( $value ) ) {
285 if ( $value !==
null && !( is_array( $value ) && !$value ) ) {
314 if ( count( $ids ) ) {
315 $ids = $this->
filterIDs( [ [ $table, $field ] ], $ids );
324 return count( $ids );
339 protected function addWhereRange( $field, $dir, $start, $end, $sort =
true ) {
340 $isDirNewer = ( $dir ===
'newer' );
341 $after = ( $isDirNewer ?
'>=' :
'<=' );
342 $before = ( $isDirNewer ?
'<=' :
'>=' );
343 $db = $this->
getDB();
345 if ( $start !==
null ) {
346 $this->
addWhere( $field . $after . $db->addQuotes( $start ) );
349 if ( $end !==
null ) {
350 $this->
addWhere( $field . $before . $db->addQuotes( $end ) );
354 $this->
getQueryBuilder()->orderBy( $field, $isDirNewer ?
null :
'DESC' );
369 $db = $this->
getDB();
371 $db->timestampOrNull( $start ), $db->timestampOrNull( $end ), $sort );
401 protected function select( $method, $extraQuery = [], array &$hookData =
null ) {
403 if ( isset( $extraQuery[
'tables'] ) ) {
404 $queryBuilder->
rawTables( (array)$extraQuery[
'tables'] );
406 if ( isset( $extraQuery[
'fields'] ) ) {
407 $queryBuilder->
fields( (array)$extraQuery[
'fields'] );
409 if ( isset( $extraQuery[
'where'] ) ) {
410 $queryBuilder->
where( (array)$extraQuery[
'where'] );
412 if ( isset( $extraQuery[
'options'] ) ) {
413 $queryBuilder->
options( (array)$extraQuery[
'options'] );
415 if ( isset( $extraQuery[
'join_conds'] ) ) {
416 $queryBuilder->
joinConds( (array)$extraQuery[
'join_conds'] );
419 if ( $hookData !==
null && $this->
getHookContainer()->isRegistered(
'ApiQueryBaseBeforeQuery' ) ) {
422 $this, $info[
'tables'], $info[
'fields'], $info[
'conds'],
423 $info[
'options'], $info[
'join_conds'], $hookData
425 $queryBuilder = $this->
getDB()->newSelectQueryBuilder()->queryInfo( $info );
428 $queryBuilder->
caller( $method );
431 if ( $hookData !==
null ) {
451 protected function processRow( $row, array &$data, array &$hookData ) {
452 return $this->
getHookRunner()->onApiQueryBaseProcessRow( $this, $row, $data, $hookData );
469 $arr[$prefix .
'ns'] =
$title->getNamespace();
470 $arr[$prefix .
'title'] =
$title->getPrefixedText();
483 return $result->addValue( [
'query',
'pages', (
int)$pageId ],
498 $fit = $result->addValue( [
'query',
'pages', $pageId,
503 $result->addIndexedTagName(
531 $t = Title::makeTitleSafe( $namespace, $titlePart .
'x' );
532 if ( !
$t ||
$t->hasFragment() ) {
536 if ( $namespace !=
$t->getNamespace() ||
$t->isExternal() ) {
545 return substr(
$t->getDBkey(), 0, -1 );
558 $titleParser = MediaWikiServices::getInstance()->getTitleParser();
559 $t = $titleParser->parseTitle( $titlePart .
'X', $defaultNamespace );
564 if ( !
$t ||
$t->hasFragment() ||
$t->isExternal() ||
$t->getDBkey() ===
'X' ) {
569 return new TitleValue(
$t->getNamespace(), substr(
$t->getDBkey(), 0, -1 ) );
577 return (
bool)preg_match(
'/^[a-f0-9]{40}$/', $hash );
585 return (
bool)preg_match(
'/^[a-z0-9]{31}$/', $hash );
615 if ( !
$res->numRows() ) {
619 $services = MediaWikiServices::getInstance();
620 if ( !$services->getContentLanguage()->needsGenderDistinction() ) {
624 $nsInfo = $services->getNamespaceInfo();
625 $namespaceField = $fieldPrefix .
'_namespace';
626 $titleField = $fieldPrefix .
'_title';
629 foreach (
$res as $row ) {
630 if ( $nsInfo->hasGenderDistinction( $row->$namespaceField ) ) {
631 $usernames[] = $row->$titleField;
635 if ( $usernames === [] ) {
639 $genderCache = $services->getGenderCache();
640 $genderCache->doQuery( $usernames, $fname );
wfEscapeWikiText( $text)
Escapes the given text so that it may be output using addWikiText() without any linking,...
wfDeprecated( $function, $version=false, $component=false, $callerOffset=2)
Logs a warning that a deprecated feature was used.
This abstract class implements many basic API functions, and is the base of all API classes.
dieWithError( $msg, $code=null, $data=null, $httpCode=0)
Abort execution with an error.
getModulePrefix()
Get parameter prefix (usually two letters or an empty string).
filterIDs( $fields, array $ids)
Filter out-of-range values from a list of positive integer IDs.
static dieDebug( $method, $message)
Internal code errors should be reported with this method.
getMain()
Get the main module.
getResult()
Get the result object.
getModuleName()
Get the name of the module being executed by this instance.
getHookRunner()
Get an ApiHookRunner for running core API hooks.
getHookContainer()
Get a HookContainer, for running extension hooks or for hook metadata.
This is a base class for all Query modules.
selectNamedDB( $name, $db, $groups)
Change the database connection for subsequent calls to getDB().
static addTitleInfo(&$arr, $title, $prefix='')
Add information (title and namespace) about a Title object to a result array.
setContinueEnumParameter( $paramName, $paramValue)
Set a query-continue value.
parsePrefixedTitlePart( $titlePart, $defaultNamespace=NS_MAIN)
Convert an input title or title prefix into a TitleValue.
processRow( $row, array &$data, array &$hookData)
Call the ApiQueryBaseProcessRow hook.
validateSha1Base36Hash( $hash)
resetQueryParams()
Blank the internal arrays with query parameters.
getCacheMode( $params)
Get the cache mode for the data generated by this module.
addWhereIf( $value, $condition)
Same as addWhere(), but add the WHERE clauses only if a condition is met.
addWhereRange( $field, $dir, $start, $end, $sort=true)
Add a WHERE clause corresponding to a range, and an ORDER BY clause to sort in the right direction.
getQueryBuilder()
Get the SelectQueryBuilder.
addPageSubItems( $pageId, $data)
Add a sub-element under the page element with the given page ID.
addFields( $value)
Add a set of fields to select to the internal array.
addPageSubItem( $pageId, $item, $elemname=null)
Same as addPageSubItems(), but one element of $data at a time.
getParent()
Get the parent of this module.Stability: stableto override 1.25 ApiBase|null
addOption( $name, $value=null)
Add an option such as LIMIT or USE INDEX.
addTables( $tables, $alias=null)
Add a set of tables to the internal array.
addTimestampWhereRange( $field, $dir, $start, $end, $sort=true)
Add a WHERE clause corresponding to a range, similar to addWhereRange, but converts $start and $end t...
getDB()
Get the Query database connection (read-only)
executeGenderCacheFromResultWrapper(IResultWrapper $res, $fname=__METHOD__, $fieldPrefix='page')
Preprocess the result set to fill the GenderCache with the necessary information before using self::a...
select( $method, $extraQuery=[], array &$hookData=null)
Execute a SELECT query based on the values in the internal arrays.
addFieldsIf( $value, $condition)
Same as addFields(), but add the fields only if a condition is met.
addWhereIDsFld( $table, $field, $ids)
Like addWhereFld for an integer list of IDs.
requestExtraData( $pageSet)
Override this method to request extra fields from the pageSet using $pageSet->requestField('fieldName...
addJoinConds( $join_conds)
Add a set of JOIN conditions to the internal array.
getQuery()
Get the main Query module.
addWhereFld( $field, $value)
Equivalent to addWhere( [ $field => $value ] )
getPageSet()
Get the PageSet object to work on.
titlePartToKey( $titlePart, $namespace=NS_MAIN)
Convert an input title or title prefix into a dbkey.
addWhere( $value)
Add a set of WHERE clauses to the internal array.
__construct(ApiQuery $queryModule, $moduleName, $paramPrefix='')
userCanSeeRevDel()
Check whether the current user has permission to view revision-deleted fields.
This is the main query class.
static setIndexedTagName(array &$arr, $tag)
Set the tag name for numeric-keyed values in XML format.
Represents a page (or page fragment) title within MediaWiki.
trait ApiQueryBlockInfoTrait