<?php
/**
 * @license GPL-2.0-or-later
 * @file
 */

namespace MediaWiki\Site;

use Wikimedia\ObjectCache\BagOStuff;

/**
 * Wrap SiteList with an in-process cache and (optionally) a local-server cache.
 *
 * @internal For use by core ServiceWiring only. The public interface is SiteStore
 * @ingroup Site
 * @author Jeroen De Dauw < jeroendedauw@gmail.com >
 * @author Katie Filbert < aude.wiki@gmail.com >
 */
class CachingSiteStore implements SiteStore {
	/** @var SiteStore */
	private $siteStore;
	/** @var BagOStuff */
	private $cache;
	/** @var string|null */
	private $cacheKey = null;
	/** @var SiteList|null */
	private $sites = null;

	public function __construct(
		SiteStore $siteStore,
		BagOStuff $cache
	) {
		$this->siteStore = $siteStore;
		$this->cache = $cache;
	}

	/**
	 * Constructs a cache key to use for caching the list of sites.
	 *
	 * This includes the concrete class name of the site list as well as a version identifier
	 * for the list's serialization, to avoid problems when unserializing site lists serialized
	 * by an older version, e.g. when reading from a cache.
	 *
	 * The cache key also includes information about where the sites were loaded from, e.g.
	 * the name of a database table.
	 *
	 * @see SiteList::getSerialVersionId
	 *
	 * @return string The cache key.
	 */
	private function getCacheKey() {
		if ( $this->cacheKey === null ) {
			$version = SiteList::getSerialVersionId();
			$this->cacheKey = $this->cache->makeKey( 'site-SiteList', $version );
		}

		return $this->cacheKey;
	}

	/**
	 * @see SiteStore::getSites
	 *
	 * @since 1.25
	 * @return SiteList
	 */
	public function getSites() {
		if ( $this->sites === null ) {
			$this->sites = $this->cache->getWithSetCallback(
				$this->getCacheKey(),
				BagOStuff::TTL_HOUR,
				function () {
					return $this->siteStore->getSites();
				}
			);
		}

		return $this->sites;
	}

	/**
	 * @see SiteStore::getSite
	 *
	 * @since 1.25
	 * @param string $globalId
	 * @return Site|null
	 */
	public function getSite( $globalId ) {
		$sites = $this->getSites();

		return $sites->hasSite( $globalId ) ? $sites->getSite( $globalId ) : null;
	}

	/**
	 * @see SiteStore::saveSite
	 *
	 * @since 1.25
	 * @param Site $site
	 * @return bool Success indicator
	 */
	public function saveSite( Site $site ) {
		return $this->saveSites( [ $site ] );
	}

	/**
	 * @see SiteStore::saveSites
	 *
	 * @since 1.25
	 * @param Site[] $sites
	 * @return bool Success indicator
	 */
	public function saveSites( array $sites ) {
		if ( !$sites ) {
			return true;
		}

		$success = $this->siteStore->saveSites( $sites );

		// purge cache
		$this->reset();

		return $success;
	}

	/**
	 * Purge the internal and external cache of the site list, forcing the list.
	 * of sites to be reloaded.
	 *
	 * @since 1.25
	 */
	public function reset() {
		$this->cache->delete( $this->getCacheKey() );
		$this->sites = null;
	}

	/**
	 * Clears the list of sites stored.
	 *
	 * NOTE: The fact that this also clears the in-process cache is an internal
	 * detail for PHPUnit testing only. The injected cache is generally APCU,
	 * which is per-server, so the cache reset would not apply to any other web servers.
	 *
	 * @see SiteStore::clear()
	 * @return bool Success
	 */
	public function clear() {
		$this->reset();

		return $this->siteStore->clear();
	}

}

/** @deprecated class alias since 1.42 */
class_alias( CachingSiteStore::class, 'CachingSiteStore' );
