Addwiki\Mediawiki\Api\Service\PageListGetter

Complexity

Total Complexity

13

Size/Duplication

Total Lines	144
Duplicated Lines	0 %

Coupling/Cohesion

Components	1
Dependencies	0

Importance

Changes

0

7 Methods

Rating	Name	Duplication	Size	Complexity
A	getPageListFromCategoryName()	0	7	1
A	getPageListFromPageTransclusions()	0	7	1
A	getFromWhatLinksHere()	0	8	1
A	getLinksFromHere()	0	8	1
A	getFromPrefix()	0	7	1
A	getRandom()	0	4	1
B	runQuery()	0	34	7

<?php

namespace Addwiki\Mediawiki\Api\Service;

use Addwiki\Mediawiki\Api\Client\SimpleRequest;
use Addwiki\Mediawiki\DataModel\Page;
use Addwiki\Mediawiki\DataModel\PageIdentifier;
use Addwiki\Mediawiki\DataModel\Pages;
use Addwiki\Mediawiki\DataModel\Title;

/**
 * @access private
 *
 * @author Addshore
 */
class PageListGetter extends Service {

	/**
	 * Get the set of pages in a given category. Extra parameters can include:
	 *     cmtype: default 'page|subcat|file'
	 *     cmlimit: default 10, maximum 500 (5000 for bots)
	 *
	 * @link https://www.mediawiki.org/wiki/API:Categorymembers
	 * @since 0.3
	 *
	 *
	 */
	public function getPageListFromCategoryName( string $name, array $extraParams = [] ): Pages {
		$params = array_merge( $extraParams, [
			'list' => 'categorymembers',
			'cmtitle' => $name,
		] );
		return $this->runQuery( $params, 'cmcontinue', 'categorymembers' );
	}

	/**
	 * List pages that transclude a certain page.
	 *
	 * @link https://www.mediawiki.org/wiki/API:Embeddedin
	 * @since 0.5
	 *
	 *
	 */
	public function getPageListFromPageTransclusions( string $pageName, array $extraParams = [] ): Pages {
		$params = array_merge( $extraParams, [
			'list' => 'embeddedin',
			'eititle' => $pageName,
		] );
		return $this->runQuery( $params, 'eicontinue', 'embeddedin' );
	}

	/**
	 * Get all pages that link to the given page.
	 *
	 * @link https://www.mediawiki.org/wiki/API:Linkshere
	 * @since 0.5
	 *
	 * @param string $pageName The page name
	 * @param string[] $extraParams Any extra parameters to use
	 *                 glhprop, glhnamespace, glhshow, glhlimit
	 */
	public function getFromWhatLinksHere( string $pageName, array $extraParams = [] ): Pages {
		$params = array_merge( $extraParams, [
			'prop' => 'info',
			'generator' => 'linkshere',
			'titles' => $pageName,
		] );
		return $this->runQuery( $params, 'glhcontinue', 'pages' );
	}

	/**
	 * Get all pages that are linked to from the given page.
	 *
	 * @link https://www.mediawiki.org/wiki/API:Links
	 *
	 * @param string $pageName The page name
	 * @param string[] $extraParams Any extra parameters to use
	 *                 gpltitles, gplnamespace, gpldir, gpllimit
	 */
	public function getLinksFromHere( string $pageName, array $extraParams = [] ): Pages {
		$params = array_merge( $extraParams, [
			'prop' => 'info',
			'generator' => 'links',
			'titles' => $pageName,
		] );
		return $this->runQuery( $params, 'gplcontinue', 'pages' );
	}

	/**
	 * Get all pages that have the given prefix.
	 *
	 * @link https://www.mediawiki.org/wiki/API:Allpages
	 *
	 * @param string $prefix The page title prefix.
	 */
	public function getFromPrefix( string $prefix ): Pages {
		$params = [
			'list' => 'allpages',
			'apprefix' => $prefix,
		];
		return $this->runQuery( $params, 'apcontinue', 'allpages' );
	}

	/**
	 * Get up to 10 random pages.
	 *
	 * @link https://www.mediawiki.org/wiki/API:Random
	 *
	 * @param array $extraParams
	 */
	public function getRandom( array $extraParams = [] ): Pages {
		$params = array_merge( $extraParams, [ 'list' => 'random' ] );
		return $this->runQuery( $params, null, 'random', 'id', false );
	}

	/**
	 * Run a query to completion.
	 *
	 * @param string[] $params Query parameters
	 * @param string|null $contName Result subelement name for continue details
	 * @param string $resName Result element name for main results array
	 * @param string $pageIdName Result element name for page ID
	 * @param bool $cont Whether to continue the query, using multiple requests
	 */
	protected function runQuery( array $params, ?string $contName, string $resName, string $pageIdName = 'pageid', bool $cont = true ): Pages {
		$pages = new Pages();
		$negativeId = -1;

		$result = [];
		do {
			// Set up continue parameter if it's been set already.
			if ( isset( $result['continue'][$contName] ) ) {
				$params[$contName] = $result['continue'][$contName];
			}

			// Run the actual query.
			$result = $this->api->getRequest( new SimpleRequest( 'query', $params ) );
			if ( !array_key_exists( 'query', $result ) ) {
				return $pages;
			}

			// Add the results to the output page list.
			foreach ( $result['query'][$resName] as $member ) {
				// Assign negative pageid if page is non-existent.
				if ( !array_key_exists( $pageIdName, $member ) ) {
					$member[$pageIdName] = $negativeId;
					--$negativeId;
				}

				$pageTitle = new Title( $member['title'], $member['ns'] );
				$page = new Page( new PageIdentifier( $pageTitle, $member[$pageIdName] ) );
				$pages->addPage( $page );
			}

		} while ( $cont && isset( $result['continue'] ) );

		return $pages;
	}
}