MediaWiki  master
Category Class Reference

Category objects are immutable, strictly speaking. More...

Public Member Functions

 getFileCount ()
 
 getID ()
 
 getMemberCount ()
 
 getMembers ( $limit=false, $offset='')
 Fetch a TitleArray of up to $limit category members, beginning after the category sort key $offset. More...
 
 getName ()
 
 getPage ()
 
 getPageCount ( $type=self::COUNT_ALL_MEMBERS)
 
 getSubcatCount ()
 
 getTitle ()
 
 refreshCounts ()
 Refresh the counts for this category. More...
 
 refreshCountsIfEmpty ()
 Call refreshCounts() if there are no entries in the categorylinks table or if the category table has a row that states that there are no entries. More...
 
 refreshCountsIfSmall ( $maxSize=self::ROW_COUNT_SMALL)
 Call refreshCounts() if there are few entries in the categorylinks table. More...
 

Static Public Member Functions

static newFromID ( $id)
 Factory function. More...
 
static newFromName ( $name)
 Factory function. More...
 
static newFromRow (stdClass $row, ?PageIdentity $page=null)
 Factory function, for constructing a Category object from a result set. More...
 
static newFromTitle (PageIdentity $page)
 Factory function. More...
 

Public Attributes

const COUNT_ALL_MEMBERS = 0
 
const COUNT_CONTENT_PAGES = 1
 
const ROW_COUNT_SMALL = 100
 

Protected Member Functions

 initialize ( $mode=self::LOAD_ONLY)
 Set up all member variables using a database query. More...
 

Protected Attributes

const LAZY_INIT_ROW = 1
 
const LOAD_ONLY = 0
 

Detailed Description

Category objects are immutable, strictly speaking.

If you call methods that change the database, like to refresh link counts, the objects will be appropriately reinitialized. Member variables are lazy-initialized.

Definition at line 34 of file Category.php.

Member Function Documentation

◆ getFileCount()

Category::getFileCount ( )
Returns
int Number of member files

Definition at line 281 of file Category.php.

◆ getID()

Category::getID ( )
Returns
string|false Category ID, or false on failure

Definition at line 244 of file Category.php.

◆ getMemberCount()

Category::getMemberCount ( )
Returns
int Total number of members count (sum of subcats, files and pages)

Definition at line 251 of file Category.php.

◆ getMembers()

Category::getMembers (   $limit = false,
  $offset = '' 
)

Fetch a TitleArray of up to $limit category members, beginning after the category sort key $offset.

Parameters
int | false$limit
string$offset
Returns
TitleArray TitleArray object for category members.

Definition at line 318 of file Category.php.

References $dbr, and DB_REPLICA.

◆ getName()

Category::getName ( )
Returns
string|false DB key name, or false on failure

Definition at line 237 of file Category.php.

◆ getPage()

Category::getPage ( )
Since
1.37
Returns
?PageIdentity the page associated with this category, or null on failure. NOTE: This returns null on failure, unlike getTitle() which returns false.

Definition at line 290 of file Category.php.

Referenced by CategoryViewer\addSubcategoryObject().

◆ getPageCount()

Category::getPageCount (   $type = self::COUNT_ALL_MEMBERS)
Parameters
int$typeOne of self::COUNT_ALL_MEMBERS and self::COUNT_CONTENT_PAGES
Returns
int Total number of member count or content page count

Definition at line 261 of file Category.php.

◆ getSubcatCount()

Category::getSubcatCount ( )
Returns
int Number of subcategories

Definition at line 274 of file Category.php.

◆ getTitle()

Category::getTitle ( )
Deprecated:
since 1.37, use getPage() instead.
Returns
Title|bool Title for this category, or false on failure.

Definition at line 307 of file Category.php.

References Title\castFromPageIdentity().

◆ initialize()

Category::initialize (   $mode = self::LOAD_ONLY)
protected

Set up all member variables using a database query.

Parameters
int$modeOne of (Category::LOAD_ONLY, Category::LAZY_INIT_ROW)
Exceptions
MWException
Returns
bool True on success, false on failure.

Definition at line 80 of file Category.php.

References DeferredUpdates\addCallableUpdate(), DB_REPLICA, and refreshCounts().

◆ newFromID()

static Category::newFromID (   $id)
static

Factory function.

Parameters
int$idA category id. Warning, no validation is performed!
Returns
Category

Definition at line 184 of file Category.php.

◆ newFromName()

static Category::newFromName (   $name)
static

Factory function.

Parameters
string$nameA category name (no "Category:" prefix). It need not be normalized, with spaces replaced by underscores.
Returns
Category|bool Category, or false on a totally invalid name

Definition at line 149 of file Category.php.

Referenced by MediaWiki\Deferred\LinksUpdate\LinksDeletionUpdate\doIncrementalUpdate(), MediaWiki\Search\ParserOutputSearchDataExtractor\getCategories(), and WikiPage\updateCategoryCounts().

◆ newFromRow()

static Category::newFromRow ( stdClass  $row,
?PageIdentity  $page = null 
)
static

Factory function, for constructing a Category object from a result set.

Parameters
stdClass$rowResult set row, must contain the cat_xxx fields. If the fields are null, the resulting Category object will represent an empty category if a page object was given. If the fields are null and no PageIdentity was given, this method fails and returns false.
PageIdentity | null$pageThis must be provided if there is no cat_title field in $row.
Returns
Category|false

Definition at line 200 of file Category.php.

Referenced by CategoryViewer\doCategoryQuery().

◆ newFromTitle()

static Category::newFromTitle ( PageIdentity  $page)
static

◆ refreshCounts()

Category::refreshCounts ( )

Refresh the counts for this category.

Returns
bool True on success, false on failure

Definition at line 357 of file Category.php.

References DB_PRIMARY, NS_CATEGORY, and NS_FILE.

Referenced by initialize().

◆ refreshCountsIfEmpty()

Category::refreshCountsIfEmpty ( )

Call refreshCounts() if there are no entries in the categorylinks table or if the category table has a row that states that there are no entries.

Due to lock errors or other failures, the precomputed counts can get out of sync, making it hard to know when to delete the category row without checking the categorylinks table.

Returns
bool Whether links were refreshed
Since
1.32

Definition at line 477 of file Category.php.

◆ refreshCountsIfSmall()

Category::refreshCountsIfSmall (   $maxSize = self::ROW_COUNT_SMALL)

Call refreshCounts() if there are few entries in the categorylinks table.

Due to lock errors or other failures, the precomputed counts can get out of sync, making it hard to know when to delete the category row without checking the categorylinks table.

This method will do a non-locking select first to reduce contention.

Parameters
int$maxSizeOnly refresh if there are this or less many backlinks
Returns
bool Whether links were refreshed
Since
1.34

Definition at line 494 of file Category.php.

References DB_PRIMARY.

Member Data Documentation

◆ COUNT_ALL_MEMBERS

const Category::COUNT_ALL_MEMBERS = 0

Definition at line 59 of file Category.php.

◆ COUNT_CONTENT_PAGES

const Category::COUNT_CONTENT_PAGES = 1

◆ LAZY_INIT_ROW

const Category::LAZY_INIT_ROW = 1
protected

Definition at line 55 of file Category.php.

◆ LOAD_ONLY

const Category::LOAD_ONLY = 0
protected

Definition at line 54 of file Category.php.

◆ ROW_COUNT_SMALL

const Category::ROW_COUNT_SMALL = 100

Definition at line 57 of file Category.php.


The documentation for this class was generated from the following file: