bibliotheca-php/webclient/lib/imdbwebparser.class.php

<?php
/**
 * PHP IMDb.com Grabber
 *
 * This PHP library enables you to scrape data from IMDB.com.
 *
 *
 * If you want to thank me for this library, please buy me something at Amazon
 * (https://www.amazon.de/hz/wishlist/ls/8840JITISN9L/) or use
 * https://www.paypal.me/FabianBeiner. Thank you!
 *
 * @author  Fabian Beiner <fb@fabianbeiner.de>
 * @license https://opensource.org/licenses/MIT The MIT License
 * @link    https://github.com/FabianBeiner/PHP-IMDB-Grabber/ GitHub Repository
 * @version 6.2.0
 *
 *
 * Functionality is the same but modified heavily to remove the does-not-make-sense static helper
 * which was not static since it depended on the IMDB class. Also some could not be extended or overwritten
 *
 */
class IMDB
{
	/**
	 * Set this to true if you run into problems.
	 */
	private bool $IMDB_DEBUG = false;

	/**
	 * @var string Set the preferred language for the User Agent.
	 */
	private string $IMDB_BROWSER_LANG;

    /**
     * Set this to true if you want to start with normal search and
     * if you get no result, it will use the advanced method
     */
    const IMDB_SEARCH_ORIGINAL = true;

    /**
     * Set this to true if you want to search for exact titles
     * it falls back to false if theres no result
     */
    const IMDB_EXACT_SEARCH = true;

    /**
     * Set the sensitivity for search results in percentage.
     */
    const IMDB_SENSITIVITY = 85;

	/**
	 * @var string The accept string for curl call
	 */
	private string $IMDB_BROWSER_ACCEPT;

	/**
	 * @var string The user-agent string fpr curl call
	 */
	private string $IMDB_BROWSER_AGENT;

	/**
	 * Define the timeout for cURL requests.
	 */
	private int $IMDB_TIMEOUT = 15;

	/**
	 * These are the regular expressions used to extract the data.
	 * If you don’t know what you’re doing, you shouldn’t touch them.
	 */
	const IMDB_AKA           = '~<td[^>]*>\s*Also\s*Known\s*As\s*</td>\s*<td>(.+)</td>~Uis';
	const IMDB_ASPECT_RATIO  = '~<td[^>]*>Aspect\s*Ratio</td>\s*<td>(.+)</td>~Uis';
	const IMDB_AWARDS        = '~<div\s*class="titlereference-overview-section">\s*Awards:(.+)</div>~Uis';
    const IMDB_BUDGET        = '~<td[^>]*>Budget<\/td>\s*<td>\s*(.*)(?:\(estimated\))\s*<\/td>~Ui';
	const IMDB_CAST          = '~<td[^>]*itemprop="actor"[^>]*>\s*<a\s*href="/name/([^/]*)/\?[^"]*"[^>]*>\s*<span.+>(.+)</span~Ui';
    const IMDB_CAST_IMAGE    = '~(loadlate="(.*)"[^>]*><\/a>\s+<\/td>\s+)?<td[^>]*itemprop="actor"[^>]*>\s*<a\s*href="\/name\/([^/]*)\/\?[^"]*"[^>]*>\s*<span.+>(.+)<\/span+~Uis';
	const IMDB_CERTIFICATION = '~<td[^>]*>\s*Certification\s*</td>\s*<td>(.+)</td>~Ui';
    const IMDB_CHAR          = '~<td class="character">(?:\s+)<div>(.*)(?:\s+)(?: /| \(.*\)|<\/div>)~Ui';
    const IMDB_COLOR         = '~<a href="\/search\/title\?colors=(?:.*)">(.*)<\/a>~Ui';
    const IMDB_COMPANIES     = '~production_companies&ref_=(?:.*)">Edit</a>\s+</header>\s+<ul class="simpleList">(.*)Distributors</h4>~Uis';
    const IMDB_COMPANY       = '~<li>\s+<a href="\/company\/(co[0-9]+)\/">(.*?)</a>~';
	const IMDB_COUNTRY       = '~<a href="/country/(\w+)">(.*)</a>~Ui';
	const IMDB_CREATOR       = '~<div[^>]*>\s*(?:Creator|Creators)\s*:\s*<ul[^>]*>(.+)</ul>~Uxsi';
    const IMDB_DISTRIBUTOR   = '@href="[^"]*update=[t0-9]+:distributors[^"]*">Edit</a>\s*</header>\s*<ul\s*class="simpleList">(.*):special_effects_companies@Uis';
    const IMDB_DISTRIBUTORS  = '@\/company\/(co[0-9]+)\/">(.*?)<\/a>\s+(?:\(([0-9]+)\))?\s+(?:\((.*?)\))?\s+(?:\((.*?)\))?\s+(?:\((?:.*?)\))?\s+</li>@';
	const IMDB_DIRECTOR      = '~<div[^>]*>\s*(?:Director|Directors)\s*:\s*<ul[^>]*>(.+)</ul>~Uxsi';
	const IMDB_GENRE         = '~href="/genre/([a-zA-Z_-]*)/?">([a-zA-Z_ -]*)</a>~Ui';
    const IMDB_GROSS         = '~pl-zebra-list__label">Cumulative Worldwide Gross<\/td>\s+<td>\s+(.*)\s+<~Uxsi';
	const IMDB_ID            = '~((?:tt\d{6,})|(?:itle\?\d{6,}))~';
    const IMDB_LANGUAGE      = '~<a href="\/language\/(\w+)">(.*)<\/a>~Ui';
    const IMDB_LOCATION      = '~href="\/search\/title\?locations=(.*)">(.*)<\/a>~Ui';
    const IMDB_LOCATIONS     = '~href="\/search\/title\?locations=[^>]*>\s?(.*)\s?<\/a>[^"]*<dd>\s?(.*)\s<\/dd>~Ui';
    const IMDB_MPAA          = '~<li class="ipl-inline-list__item">(?:\s+)(TV-Y|TV-Y7|TV-G|TV-PG|TV-14|TV-MA|G|PG|PG-13|R|NC-17|NR|UR)(?:\s+)<\/li>~Ui';
    const IMDB_MUSIC         = '~Music by\s*<\/h4>.*<table class=.*>(.*)</table>~Us';
	const IMDB_NAME          = '~href="/name/(.+)/?(?:\?[^"]*)?"[^>]*>(.+)</a>~Ui';
    const IMDB_MOVIE_DESC    = '~<section class="titlereference-section-overview">\s+<div>\s+(.*)\s*?</div>\s+<hr>\s+<div class="titlereference-overview-section">~Ui';
    const IMDB_SERIES_DESC   = '~<div>\s+(?:.*?</a>\s+</span>\s+</div>\s+<hr>\s+<div>\s+)(.*)\s+</div>\s+<hr>\s+<div class="titlereference-overview-section">~Ui';
    const IMDB_SERIESEP_DESC = '~All Episodes(?:.*?)</li>\s+(?:.*?)?</ul>\s+</span>\s+<hr>\s+</div>\s+<div>\s+(.*?)\s+</div>\s+<hr>~';
    const IMDB_NOT_FOUND_ADV = '~<span>No results.</span>~Ui';
    const IMDB_NOT_FOUND_DES = 'Know what this is about';
    const IMDB_NOT_FOUND_ORG = '~<h1 class="findHeader">No results found for ~Ui';
    const IMDB_PLOT          = '~<td[^>]*>\s*Plot\s*Summary\s*</td>\s*<td>\s*<p>\s*(.*)\s*</p>~Ui';
	const IMDB_PLOT_KEYWORDS = '~<td[^>]*>Plot\s*Keywords</td>\s*<td>(.+)(?:<a\s*href="/title/[^>]*>[^<]*</a>\s*</li>\s*</ul>\s*)?</td>~Ui';
	const IMDB_POSTER        = '~<link\s*rel=\'image_src\'\s*href="(.*)">~Ui';
	const IMDB_RATING        = '~class="ipl-rating-star__rating">(.*)<~Ui';
	const IMDB_RATING_COUNT  = '~class="ipl-rating-star__total-votes">\((.*)\)<~Ui';
	const IMDB_RELEASE_DATE  = '~href="/title/[t0-9]*/releaseinfo">(.*)<~Ui';
	const IMDB_RUNTIME       = '~<td[^>]*>\s*Runtime\s*</td>\s*<td>(.+)</td>~Ui';
    const IMDB_SEARCH_ADV    = '~text-primary">1[.]</span>\s*<a.href="\/title\/(tt\d{6,})\/(?:.*?)"(?:\s*)>(?:.*?)<\/a>~Ui';
    const IMDB_SEARCH_ORG    = '~find-title-result">(?:.*?)alt="(.*?)"(?:.*?)href="\/title\/(tt\d{6,})\/(?:.*?)">(.*?)<\/a>~';
	const IMDB_SEASONS       = '~episodes\?season=(?:\d+)">(\d+)<~Ui';
	const IMDB_SOUND_MIX     = '~<td[^>]*>\s*Sound\s*Mix\s*</td>\s*<td>(.+)</td>~Ui';
	const IMDB_TAGLINE       = '~<td[^>]*>\s*Taglines\s*</td>\s*<td>(.+)</td>~Ui';
	const IMDB_TITLE         = '~itemprop="name">(.*)(<\/h3>|<span)~Ui';
    const IMDB_TITLE_EP      = '~titlereference-watch-ribbon"(?:.*)itemprop="name">(.*?)\s+<span\sclass="titlereference-title-year">~Ui';
	const IMDB_TITLE_ORIG    = '~</h3>(?:\s+)(.*)(?:\s+)<span class=\"titlereference-original-title-label~Ui';
    const IMDB_TOP250        = '~href="/chart/top(?:tv)?".class(?:.*?)#([0-9]{1,})</a>~Ui';
    const IMDB_TRAILER       = '~href="/title/(?:tt\d+)/videoplayer/(vi[0-9]*)"~Ui';
    const IMDB_TYPE          = '~href="/genre/(?:[a-zA-Z_-]*)/?">(?:[a-zA-Z_ -]*)</a>\s+</li>\s+(?:.*item">)\s+(?:<a href="(?:.*)</a>\s+</li>\s+(?:.*item">)\s+)?([a-zA-Z_ -]*)\s+</li>~Ui';
    const IMDB_URL           = '~https?://(?:.*\.|.*)imdb.com/(?:t|T)itle(?:\?|/)(..\d+)~i';
	const IMDB_USER_REVIEW   = '~href="/title/[t0-9]*/reviews"[^>]*>([^<]*)\s*User~Ui';
	const IMDB_VOTES         = '~"ipl-rating-star__total-votes">\s*\((.*)\)\s*<~Ui';
	const IMDB_WRITER        = '~<div[^>]*>\s*(?:Writer|Writers)\s*:\s*<ul[^>]*>(.+)</ul>~Ui';
	const IMDB_YEAR          = '~og:title\' content="(?:.*)\((?:.*)(\d{4})(?:.*)\)~Ui';

	/**
	 * @var string The string returned, if nothing is found.
	 */
	public string $sNotFound = 'n/A';

	/**
	 * @var string The ID of the movie.
	 */
	public string $iId = '';

	/**
	 * @var bool Is the content ready?
	 */
	public bool $isReady = false;

	/**
	 * @var string Char that separates multiple entries.
	 */
	public string $sSeparator = ' / ';

	/**
	 * @var string The URL to the movie.
	 */
	public string $sUrl = '';

	/**
	 * @var bool Return responses enclosed in array
	 */
	public bool $bArrayOutput = false;

	/**
	 * @var int Maximum cache time.
	 */
	private int $iCache = 1440;

	/**
	 * @var string The root of the script.
	 */
	private string $sRoot = '';

	/**
	 * @var string Holds the source.
	 */
	private string $sSource = '';

	/**
	 * @var string What to search for?
	 */
	private mixed $sSearchFor = 'all';

	/**
	 * @var array The fields to return at getAll
	 */
	private array $_showFields;

	/**
	 * IMDB constructor. Can now set some options
	 *
	 * @param $options array with the following options
	 *      int iCache Custom cache time in minutes.
	 *      string sSearchFor What type to search for?
	 *      string storage Where to store data. Absolute path
	 *      boolean debug Show debug messages or not
	 */
	public function __construct(array $options) {

		if(isset($options['debug']) && !empty($options['debug'])) {
			$this->IMDB_DEBUG = true;
		}

		if(isset($options['iCache']) && !empty($options['iCache'])) $this->iCache = (int) $options['iCache'];

		$this->sRoot = dirname(__FILE__);
		if(isset($options['storage']) && !empty($options['storage'])) {
			$this->sRoot = $options['storage'];
		}

		if(isset($options['sSearchFor']) && !empty($options['sSearchFor'])) {
			if (in_array(
				$options['sSearchFor'],
				[
					'movie',
					'tv',
					'episode',
					'game',
                    'documentary',
					'all',
				]
			)) {
				$this->sSearchFor = $options['sSearchFor'];
			}
		}

		$this->IMDB_BROWSER_AGENT = $options['browserAgent'];
		$this->IMDB_BROWSER_LANG = $options['browserLang'];
		$this->IMDB_BROWSER_ACCEPT = $options['browserAccept'];

		$this->_showFields = array();
		if(isset($options['showFields']) && !empty($options['showFields'])) {
			$this->_showFields = $options['showFields'];
		}
	}


	/**
	 * @param string $sSearch
	 * @throws Exception
	 */
	public function search(string $sSearch): void {

		$sSearch = trim($sSearch);
		if(empty($sSearch)) {
			throw new Exception('Missing search term');
		}

		if ( ! is_writable($this->sRoot . '/posters') && ! mkdir($this->sRoot . '/posters')) {
			throw new Exception('The directory “' . $this->sRoot . '/posters” isn’t writable.');
		}
		if ( ! is_writable($this->sRoot . '/cache') && ! mkdir($this->sRoot . '/cache')) {
			throw new Exception('The directory “' . $this->sRoot . '/cache” isn’t writable.');
		}
		if ( ! is_writable($this->sRoot . '/cast') && ! mkdir($this->sRoot . '/cast')) {
			throw new Exception('The directory “' . $this->sRoot . '/cast” isn’t writable.');
		}

		if ( ! function_exists('curl_init')) {
			throw new Exception('You need to enable the PHP cURL extension.');
		}

		$this->fetchUrl($sSearch);
	}

	/**
	 * @param string $sSearch IMDb URL or movie title to search for.
	 *
	 * @return bool True on success, false on failure.
	 */
	private function fetchUrl(string $sSearch): bool {

		if ($this->IMDB_DEBUG) {
			echo '<pre><b>Running:</b> fetchUrl("' . $sSearch . '")</pre>';
		}

		// Try to find a valid URL.
		$sId = $this->matchRegex($sSearch, self::IMDB_ID, "1");
		if (false !== $sId) {
			$this->iId  = preg_replace('~[\D]~', '', $sId);
			$this->sUrl = 'https://www.imdb.com/title/tt' . $this->iId . '/reference';
			$bSearch    = false;
		} else {
			switch (strtolower($this->sSearchFor)) {
				case 'movie':
					$sParameters = '&s=tt&ttype=ft';
					break;
				case 'tv':
					$sParameters = '&s=tt&ttype=tv';
					break;
				case 'episode':
					$sParameters = '&s=tt&ttype=ep';
					break;
				case 'game':
					$sParameters = '&s=tt&ttype=vg';
					break;
				default:
					$sParameters = '&s=tt';
			}

			$this->sUrl = 'https://www.imdb.com/find/?q=' . rawurlencode(str_replace(' ', '+', $sSearch)) . $sParameters;
			$bSearch    = true;

			// Was this search already performed and cached?
			$sRedirectFile = $this->sRoot . '/cache/' . sha1($this->sUrl) . '.redir';
			if (is_readable($sRedirectFile)) {
				if ($this->IMDB_DEBUG) {
					echo '<pre><b>Using redirect:</b> ' . basename($sRedirectFile) . '</pre>';
				}
				$sRedirect  = file_get_contents($sRedirectFile);
				$this->sUrl = trim($sRedirect);
				$this->iId  = preg_replace('~[\D]~', '', $this->matchRegex($sRedirect, self::IMDB_ID, "1"));
				$bSearch    = false;
			}
		}

		// Does a cache of this movie exist?
		if(!empty($this->iId)) {
			$sCacheFile = $this->sRoot . '/cache/' . sha1($this->iId) . '.cache';
			if (is_readable($sCacheFile)) {
				$iDiff = round(abs(time() - filemtime($sCacheFile)) / 60);
				if ($iDiff < $this->iCache) {
					if ($this->IMDB_DEBUG) {
						echo '<pre><b>Using cache:</b> ' . basename($sCacheFile) . '</pre>';
					}
					$this->sSource = file_get_contents($sCacheFile);
					$this->isReady = true;

					return true;
				}
			}
		}

		// Run cURL on the URL.
		if ($this->IMDB_DEBUG) {
			echo '<pre><b>Running cURL:</b> ' . $this->sUrl . '</pre>';
		}

		$aCurlInfo = $this->runCurl($this->sUrl);
		$sSource = is_bool($aCurlInfo) ?  $aCurlInfo : $aCurlInfo['contents'] ;

		if (false === $sSource) {
			if ($this->IMDB_DEBUG) {
				echo '<pre><b>cURL error:</b> ' . var_dump($aCurlInfo) . '</pre>';
			}

			return false;
		}

		// Was the movie found?
		$sMatch = $this->matchRegex($sSource, self::IMDB_SEARCH_ADV, "1");
		if (false !== $sMatch) {
			$sUrl = 'https://www.imdb.com/title/' . $sMatch . '/reference';
			if ($this->IMDB_DEBUG) {
				echo '<pre><b>New redirect saved:</b> ' . basename($sRedirectFile) . ' => ' . $sUrl . '</pre>';
			}
			file_put_contents($sRedirectFile, $sUrl);
			$this->sSource = '';
			$this->fetchUrl($sUrl);

			return true;
		}
		$sMatch = $this->matchRegex($sSource, self::IMDB_NOT_FOUND_ADV, "0");
		if (false !== $sMatch) {
			if ($this->IMDB_DEBUG) {
				echo '<pre><b>Movie not found:</b> ' . $sSearch . '</pre>';
			}

			return false;
		}

		$this->sSource = str_replace(
			[
				"\n",
				"\r\n",
				"\r",
			],
			'',
			$sSource
		);
		$this->isReady = true;

		// Save cache.
		if (false === $bSearch) {
			if ($this->IMDB_DEBUG) {
				echo '<pre><b>Cache created:</b> ' . basename($sCacheFile) . '</pre>';
			}
			file_put_contents($sCacheFile, $this->sSource);
		}

		return true;
	}

	/**
	 * @return array All data.
	 */
	public function getAll(): array {
		$aData = [];
		foreach (get_class_methods(__CLASS__) as $method) {
			if (substr($method, 0, 3) === 'get' && $method !== 'getAll' && $method !== 'getCastImages') {
				if(!empty($this->_showFields) && !in_array($method,$this->_showFields)) continue;
				$aData[$method] = [
					'name'  => ltrim($method, 'get'),
					'value' => $this->{$method}(),
				];
			}
		}
		array_multisort($aData);

		return $aData;
	}

	/**
	 * @return string “Also Known As” or $sNotFound.
	 */
	public function getAka(): string {
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_AKA, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * Returns all local names
	 *
	 * @return string All local names.
	 */
	public function getAkas()
	{
		if (true === $this->isReady) {
			// Does a cache of this movie exist?
			$sCacheFile = $this->sRoot . '/cache/' . sha1($this->iId) . '_akas.cache';
			$bUseCache  = false;

			if (is_readable($sCacheFile)) {
				$iDiff = round(abs(time() - filemtime($sCacheFile)) / 60);
				if ($iDiff < $this->iCache || false) {
					$bUseCache = true;
				}
			}

			if ($bUseCache) {
				$aRawReturn = file_get_contents($sCacheFile);
				$aReturn    = unserialize($aRawReturn);

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			} else {
				$fullAkas  = sprintf('https://www.imdb.com/title/tt%s/releaseinfo', $this->iId);
				$aCurlInfo = $this->runCurl($fullAkas);
				$sSource   = $aCurlInfo['contents'];

				if (false === $sSource) {
					if ($this->IMDB_DEBUG) {
						echo '<pre><b>cURL error:</b> ' . var_dump($aCurlInfo) . '</pre>';
					}

					return false;
				}

				$aReturned = $this->matchRegex($sSource, "~<td>(.*?)<\/td>\s+<td>(.*?)<\/td>~");

				if ($aReturned) {
					$aReturn = [];
					foreach ($aReturned[1] as $i => $strName) {
						if (strpos($strName, '(') === false) {
							$aReturn[] = [
								'title'   => $this->cleanString($aReturned[2][$i]),
								'country' => $this->cleanString($strName),
							];
						}
					}

					file_put_contents($sCacheFile, serialize($aReturn));

					return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
				}
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string “Aspect Ratio” or $sNotFound.
	 */
	public function getAspectRatio()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_ASPECT_RATIO, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The awards of the movie or $sNotFound
	 */
	public function getAwards()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_AWARDS, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param int    $iLimit  How many cast members should be returned?
	 * @param bool   $bMore   Add … if there are more cast members than printed.
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with linked cast members or $sNotFound.
	 */
	public function getCastAsUrl($iLimit = 0, $bMore = true, $sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_CAST);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					if (0 !== $iLimit && $i >= $iLimit) {
						break;
					}
					$aReturn[] = '<a href="https://www.imdb.com/name/' . $this->cleanString(
							$aMatch[1][$i]
						) . '/"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				$bHaveMore = ($bMore && (count($aMatch[2]) > $iLimit));

				return $this->arrayOutput(
					$this->bArrayOutput,
					$this->sSeparator,
					$this->sNotFound,
					$aReturn,
					$bHaveMore
				);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param int  $iLimit How many cast members should be returned?
	 * @param bool $bMore  Add … if there are more cast members than printed.
	 *
	 * @return string A list with cast members or $sNotFound.
	 */
	public function getCast($iLimit = 0, $bMore = true)
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_CAST);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					if (0 !== $iLimit && $i >= $iLimit) {
						break;
					}
					$aReturn[] = $this->cleanString($sName);
				}

				$bMore = (0 !== $iLimit && $bMore && (count($aMatch[2]) > $iLimit) ? '…' : '');

				$bHaveMore = ($bMore && (count($aMatch[2]) > $iLimit));

				return $this->arrayOutput(
					$this->bArrayOutput,
					$this->sSeparator,
					$this->sNotFound,
					$aReturn,
					$bHaveMore
				);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @param int    $iLimit    How many cast images should be returned?
	 * @param bool   $bMore     Add … if there are more cast members than printed.
	 * @param string $sSize     small, mid or big cast images
	 * @param bool   $bDownload Return URL or Download
	 *
	 * @return array Array with cast name as key, and image as value.
	 */
	public function getCastImages($iLimit = 0, $bMore = true, $sSize = 'small', $bDownload = false)
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_CAST_IMAGE);
			$aReturn = [];
			if (count($aMatch[4])) {
				foreach ($aMatch[4] as $i => $sName) {
					if (0 !== $iLimit && $i >= $iLimit) {
						break;
					}
					$sMatch = $aMatch[2][$i];

					if ('big' === strtolower($sSize) && false !== strstr($aMatch[2][$i], '@._')) {
						$sMatch = substr($aMatch[2][$i], 0, strpos($aMatch[2][$i], '@._')) . '@.jpg';
					} elseif ('mid' === strtolower($sSize) && false !== strstr($aMatch[2][$i], '@._')) {
						$sMatch = substr($aMatch[2][$i], 0, strpos($aMatch[2][$i], '@._')) . '@._V1_UX214_AL_.jpg';
					}

					if (false === $bDownload) {
						$sMatch = $this->cleanString($sMatch);
					} else {
						$sLocal = $this->saveImageCast($sMatch, $aMatch[3][$i]);
						if (file_exists(dirname(__FILE__) . '/' . $sLocal)) {
							$sMatch = $sLocal;
						} else {
							//the 'big' image isn't available, try the 'mid' one (vice versa)
							if ('big' === strtolower($sSize) && false !== strstr($aMatch[2][$i], '@._')) {
								//trying the 'mid' one
								$sMatch = substr(
										$aMatch[2][$i],
										0,
										strpos($aMatch[2][$i], '@._')
									) . '@._V1_UX214_AL_.jpg';
							} else {
								//trying the 'big' one
								$sMatch = substr($aMatch[2][$i], 0, strpos($aMatch[2][$i], '@._')) . '@.jpg';
							}

							$sLocal = $this->saveImageCast($sMatch, $aMatch[3][$i]);
							if (file_exists(dirname(__FILE__) . '/' . $sLocal)) {
								$sMatch = $sLocal;
							} else {
								$sMatch = $this->cleanString($aMatch[2][$i]);
							}
						}
					}

					$aReturn[$this->cleanString($aMatch[4][$i])] = $sMatch;
				}

				$bMore = (0 !== $iLimit && $bMore && (count($aMatch[4]) > $iLimit) ? '…' : '');

				$bHaveMore = ($bMore && (count($aMatch[4]) > $iLimit));

				$aReturn = array_replace(
					$aReturn,
					array_fill_keys(
						array_keys($aReturn, $this->sNotFound),
						'cast/not-found.jpg'
					)
				);

				return $aReturn;
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @param int    $iLimit  How many cast members should be returned?
	 * @param bool   $bMore   Add … if there are more cast members than
	 *                        printed.
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with linked cast members and their character or
	 *                $sNotFound.
	 */
	public function getCastAndCharacterAsUrl($iLimit = 0, $bMore = true, $sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch     = $this->matchRegex($this->sSource, self::IMDB_CAST);
			$aMatchChar = $this->matchRegex($this->sSource, self::IMDB_CHAR);
			$aReturn    = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					if (0 !== $iLimit && $i >= $iLimit) {
						break;
					}
					$aReturn[] = '<a href="https://www.imdb.com/name/' . $this->cleanString(
							$aMatch[1][$i]
						) . '/"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a> as ' . $this->cleanString($aMatchChar[1][$i]);
				}

				$bHaveMore = ($bMore && (count($aMatch[2]) > $iLimit));

				return $this->arrayOutput(
					$this->bArrayOutput,
					$this->sSeparator,
					$this->sNotFound,
					$aReturn,
					$bHaveMore
				);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @param int  $iLimit How many cast members should be returned?
	 * @param bool $bMore  Add … if there are more cast members than printed.
	 *
	 * @return string  A list with cast members and their character or
	 *                 $sNotFound.
	 */
	public function getCastAndCharacter($iLimit = 0, $bMore = true)
	{
		if (true === $this->isReady) {
			$aMatch     = $this->matchRegex($this->sSource, self::IMDB_CAST);
			$aMatchChar = $this->matchRegex($this->sSource, self::IMDB_CHAR);
			$aReturn    = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					if (0 !== $iLimit && $i >= $iLimit) {
						break;
					}
					$aReturn[] = $this->cleanString($sName) . ' as ' . $this->cleanString($aMatchChar[1][$i]);
				}

				$bHaveMore = ($bMore && (count($aMatch[2]) > $iLimit));

				return $this->arrayOutput(
					$this->bArrayOutput,
					$this->sSeparator,
					$this->sNotFound,
					$aReturn,
					$bHaveMore
				);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string The certification of the movie or $sNotFound.
	 */
	public function getCertification()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_CERTIFICATION, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string Color or $sNotFound.
	 */
	public function getColor()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_COLOR, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The company producing the movie or $sNotFound.
	 */
	public function getCompany()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getCompanyAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string The linked company producing the movie or $sNotFound.
	 */
	public function getCompanyAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch = $this->matchRegex($this->sSource, self::IMDB_COMPANY);
			if (isset($aMatch[2][0])) {
				return '<a href="https://www.imdb.com/company/' . $this->cleanString(
						$aMatch[1][0]
					) . '/"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
						$aMatch[2][0]
					) . '</a>';
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string A list with countries or $sNotFound.
	 */
	public function getCountry()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getCountryAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with linked countries or $sNotFound.
	 */
	public function getCountryAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_COUNTRY);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/country/' . trim(
							$aMatch[1][$i]
						) . '/"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string A list with the creators or $sNotFound.
	 */
	public function getCreator()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getCreatorAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with the linked creators or $sNotFound.
	 */
	public function getCreatorAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$sMatch  = $this->matchRegex($this->sSource, self::IMDB_CREATOR, "1");
			$aMatch  = $this->matchRegex($sMatch, self::IMDB_NAME);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/name/' . $this->cleanString(
							$aMatch[1][$i]
						) . '/"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string The description of the movie or $sNotFound.
	 */
	public function getDescription()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_MOVIE_DESC, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string A list with the directors or $sNotFound.
	 */
	public function getDirector()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getDirectorAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with the linked directors or $sNotFound.
	 */
	public function getDirectorAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$sMatch  = $this->matchRegex($this->sSource, self::IMDB_DIRECTOR, "1");
			$aMatch  = $this->matchRegex($sMatch, self::IMDB_NAME);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/name/' . $this->cleanString(
							$aMatch[1][$i]
						) . '/"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string A list with the genres or $sNotFound.
	 */
	public function getGenre()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getGenreAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with the linked genres or $sNotFound.
	 */
	public function getGenreAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_GENRE);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach (array_unique($aMatch[2]) as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/search/title?genres=' . $this->cleanString(
							$aMatch[1][$i]
						) . '"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string cumulative worldwide gross or $sNotFound.
	 */
	public function getGross()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_GROSS, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string A list with the languages or $sNotFound.
	 */
	public function getLanguage()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getLanguageAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with the linked languages or $sNotFound.
	 */
	public function getLanguageAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_LANGUAGE);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/language/' . $this->cleanString(
							$aMatch[1][$i]
						) . '"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string A list with the location or $sNotFound.
	 */
	public function getLocation()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getLocationAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with the linked location or $sNotFound.
	 */
	public function getLocationAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_LOCATION);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/search/title?locations=' . $this->cleanString(
							$aMatch[1][$i]
						) . '"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * Returns all locations
	 *
	 * @return string location
	 * @return string specification
	 */
	public function getLocations()
	{
		if (true === $this->isReady) {
			// Does a cache of this movie exist?
			$sCacheFile = $this->sRoot . '/cache/' . sha1($this->iId) . '_locations.cache';
			$bUseCache  = false;

			if (is_readable($sCacheFile)) {
				$iDiff = round(abs(time() - filemtime($sCacheFile)) / 60);
				if ($iDiff < $this->iCache || false) {
					$bUseCache = true;
				}
			}

			if ($bUseCache) {
				$aRawReturn = file_get_contents($sCacheFile);
				$aReturn    = unserialize($aRawReturn);

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			} else {
				$fullLocations = sprintf('https://www.imdb.com/title/tt%s/locations', $this->iId);
				$aCurlInfo     = $this->runCurl($fullLocations);
				$sSource       = $aCurlInfo['contents'];

				if (false === $sSource) {
					if ($this->IMDB_DEBUG) {
						echo '<pre><b>cURL error:</b> ' . var_dump($aCurlInfo) . '</pre>';
					}

					return false;
				}

				$aReturned = $this->matchRegex($sSource, self::IMDB_LOCATIONS);

				if ($aReturned) {
					$aReturn = [];
					foreach ($aReturned[1] as $i => $strName) {
						if (strpos($strName, '(') === false) {
							$aReturn[] = [
								'location' => $this->cleanString($strName),
							];
						}
						if (strpos($aReturned[2][$i], '(') !== false) {
							$aReturn[] = [
								'specification' => $this->cleanString($aReturned[2][$i]),
							];
						}
					}

					file_put_contents($sCacheFile, serialize($aReturn));

					return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
				}
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string The MPAA of the movie or $sNotFound.
	 */
	public function getMpaa()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_MPAA, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string A list with the plot keywords or $sNotFound.
	 */
	public function getPlotKeywords()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_PLOT_KEYWORDS, "1");
			if (false !== $sMatch) {
				$aReturn = explode('|', $this->cleanString($sMatch));

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @param int $iLimit The limit.
	 *
	 * @return string The plot of the movie or $sNotFound.
	 */
	public function getPlot($iLimit = 0)
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_PLOT, "1");
			if (false !== $sMatch) {
				if ($iLimit !== 0) {
					return $this->shortText($this->cleanString($sMatch), $iLimit);
				}

				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sSize     Small, big, xxs, xs, s poster?
	 * @param bool   $bDownload Return URL to the poster or download it?
	 *
	 * @return bool|string Path to the poster.
	 */
	public function getPoster($sSize = 'small', $bDownload = false)
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_POSTER, "1");
			if (false !== $sMatch) {
				if ('big' === strtolower($sSize) && false !== strstr($sMatch, '@._')) {
					$sMatch = substr($sMatch, 0, strpos($sMatch, '@._')) . '@.jpg';
				}
				if ('xxs' === strtolower($sSize) && false !== strstr($sMatch, '@._')) {
					$sMatch = substr($sMatch, 0, strpos($sMatch, '@._')) . '@._V1_UY67_CR0,0,45,67_AL_.jpg';
				}
				if ('xs' === strtolower($sSize) && false !== strstr($sMatch, '@._')) {
					$sMatch = substr($sMatch, 0, strpos($sMatch, '@._')) . '@._V1_UY113_CR0,0,76,113_AL_.jpg';
				}
				if ('s' === strtolower($sSize) && false !== strstr($sMatch, '@._')) {
					$sMatch = substr($sMatch, 0, strpos($sMatch, '@._')) . '@._V1_UX182_CR0,0,182,268_AL_.jpg';
				}
				if (false === $bDownload) {
					return $this->cleanString($sMatch);
				} else {
					$sLocal = $this->saveImage($sMatch, $this->iId);
					if (file_exists(dirname(__FILE__) . '/' . $sLocal)) {
						return $sLocal;
					} else {
						return $sMatch;
					}
				}
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The rating of the movie or $sNotFound.
	 */
	public function getRating()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_RATING, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The rating count of the movie or $sNotFound.
	 */
	public function getRatingCount()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_RATING_COUNT, "1");
			if (false !== $sMatch) {
				return str_replace(',', '', $this->cleanString($sMatch));
			}
		}

		return $this->sNotFound;
	}

	/**
	 * Release date doesn't contain all the information we need to create a media and
	 * we need this function that checks if users can vote target media (if can, it's released).
	 *
	 * @return  true If the media is released
	 */
	public function isReleased()
	{
		$strReturn = $this->getReleaseDate();
		if ($strReturn == $this->sNotFound || $strReturn == 'Not yet released') {
			return false;
		}

		return true;
	}

	/**
	 * @return string The release date of the movie or $sNotFound.
	 */
	public function getReleaseDate()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_RELEASE_DATE, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * Returns all local names
	 *
	 * @return string country
	 * @return string release date
	 */
	public function getReleaseDates()
	{
		if (true === $this->isReady) {
			// Does a cache of this movie exist?
			$sCacheFile = $this->sRoot . '/cache/' . sha1($this->iId) . '_akas.cache';
			$bUseCache  = false;

			if (is_readable($sCacheFile)) {
				$iDiff = round(abs(time() - filemtime($sCacheFile)) / 60);
				if ($iDiff < $this->iCache || false) {
					$bUseCache = true;
				}
			}

			if ($bUseCache) {
				$aRawReturn = file_get_contents($sCacheFile);
				$aReturn    = unserialize($aRawReturn);

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			} else {
				$fullAkas  = sprintf('https://www.imdb.com/title/tt%s/releaseinfo', $this->iId);
				$aCurlInfo = $this->runCurl($fullAkas);
				$sSource   = $aCurlInfo['contents'];

				if (false === $sSource) {
					if ($this->IMDB_DEBUG) {
						echo '<pre><b>cURL error:</b> ' . var_dump($aCurlInfo) . '</pre>';
					}

					return false;
				}

				$aReturned = $this->matchRegex(
					$sSource,
					'~>(.*)<\/a><\/td>\s+<td class="release_date">(.*)<\/td>~'
				);

				if ($aReturned) {
					$aReturn = [];
					foreach ($aReturned[1] as $i => $strName) {
						if (strpos($strName, '(') === false) {
							$aReturn[] = [
								'country'     => $this->cleanString($strName),
								'releasedate' => $this->cleanString($aReturned[2][$i]),
							];
						}
					}

					file_put_contents($sCacheFile, serialize($aReturn));

					return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
				}
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string The runtime of the movie or $sNotFound.
	 */
	public function getRuntime()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_RUNTIME, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string A list with the seasons or $sNotFound.
	 */
	public function getSeasons()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getSeasonsAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with the linked seasons or $sNotFound.
	 */
	public function getSeasonsAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$aMatch  = $this->matchRegex($this->sSource, self::IMDB_SEASONS);
			$aReturn = [];
			if (count($aMatch[1])) {
				foreach (range(1, max($aMatch[1])) as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/title/tt' . $this->iId . '/episodes?season=' . $sName . '"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $sName . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound);
	}

	/**
	 * @return string The sound mix of the movie or $sNotFound.
	 */
	public function getSoundMix()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_SOUND_MIX, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The tagline of the movie or $sNotFound.
	 */
	public function getTagline()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_TAGLINE, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param bool $bForceLocal Try to return the original name of the movie.
	 *
	 * @return string The title of the movie or $sNotFound.
	 */
	public function getTitle($bForceLocal = false)
	{
		if (true === $this->isReady) {
			if (true === $bForceLocal) {
				$sMatch = $this->matchRegex($this->sSource, self::IMDB_TITLE_ORIG, "1");
				if (false !== $sMatch && "" !== $sMatch) {
					return $this->cleanString($sMatch);
				}
			}

			$sMatch = $this->matchRegex($this->sSource, self::IMDB_TITLE, "1");
			$sMatch = preg_replace('~\(\d{4}\)$~Ui', '', $sMatch);
			if (false !== $sMatch && "" !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param bool $bEmbed Link to player directly?
	 *
	 * @return string The URL to the trailer of the movie or $sNotFound.
	 */
	public function getTrailerAsUrl($bEmbed = false)
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_TRAILER, "1");
			if (false !== $sMatch) {
				$sUrl = 'https://www.imdb.com/video/imdb/' . $sMatch . '/' . ($bEmbed ? 'player' : '');

				return $this->cleanString($sUrl);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The IMDb URL.
	 */
	public function getUrl()
	{
		if (true === $this->isReady) {
			return $this->cleanString(str_replace('reference', '', $this->sUrl));
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The user review of the movie or $sNotFound.
	 */
	public function getUserReview()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_USER_REVIEW, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The votes of the movie or $sNotFound.
	 */
	public function getVotes()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_VOTES, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string A list with the writers or $sNotFound.
	 */
	public function getWriter()
	{
		if (true === $this->isReady) {
			$sMatch = $this->getWriterAsUrl();
			if ($this->sNotFound !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @param string $sTarget Add a target to the links?
	 *
	 * @return string A list with the linked writers or $sNotFound.
	 */
	public function getWriterAsUrl($sTarget = '')
	{
		if (true === $this->isReady) {
			$sMatch  = $this->matchRegex($this->sSource, self::IMDB_WRITER, "1");
			$aMatch  = $this->matchRegex($sMatch, self::IMDB_NAME);
			$aReturn = [];
			if (count($aMatch[2])) {
				foreach ($aMatch[2] as $i => $sName) {
					$aReturn[] = '<a href="https://www.imdb.com/name/' . $this->cleanString(
							$aMatch[1][$i]
						) . '/"' . ($sTarget ? ' target="' . $sTarget . '"' : '') . '>' . $this->cleanString(
							$sName
						) . '</a>';
				}

				return $this->arrayOutput($this->bArrayOutput, $this->sSeparator, $this->sNotFound, $aReturn);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The year of the movie or $sNotFound.
	 */
	public function getYear()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_YEAR, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}

	/**
	 * @return string The budget of the movie or $sNotFound.
	 */
	public function getBudget()
	{
		if (true === $this->isReady) {
			$sMatch = $this->matchRegex($this->sSource, self::IMDB_BUDGET, "1");
			if (false !== $sMatch) {
				return $this->cleanString($sMatch);
			}
		}

		return $this->sNotFound;
	}


	/**
	 * Regular expression helper.
	 *
	 * @param string $sContent The content to search in.
	 * @param string $sPattern The regular expression.
	 * @param string $iIndex   The index to return.
	 *
	 * @return bool   If no match was found.
	 * @return string If one match was found.
	 * @return array  If more than one match was found.
	 */
	private function matchRegex(string $sContent, string $sPattern, string $iIndex = '')
	{
		preg_match_all($sPattern, $sContent, $aMatches);
		if ($aMatches === false) {
			return false;
		}
		if (is_numeric($iIndex)) {
			if (isset($aMatches[$iIndex][0])) {
				return $aMatches[$iIndex][0];
			}
			return false;
		}

		return $aMatches;
	}

	/**
	 * Preferred output in responses with multiple elements
	 *
	 * @param bool   $bArrayOutput Native array or string with separators.
	 * @param string $sSeparator   String separator.
	 * @param string $sNotFound    Not found text.
	 * @param array  $aReturn      Original input.
	 * @param bool   $bHaveMore    Have more elements indicator.
	 *
	 * @return string|array Multiple results separated by selected separator string, or enclosed into native array.
	 */
	private function arrayOutput($bArrayOutput, $sSeparator, $sNotFound, $aReturn = '', $bHaveMore = false)
	{
		if ($bArrayOutput) {
			if (empty($aReturn) || ! is_array($aReturn)) {
				return [];
			}

			if ($bHaveMore) {
				$aReturn[] = '…';
			}

			return $aReturn;
		} else {
			if (empty($aReturn) || ! is_array($aReturn)) {
				return $sNotFound;
			}

			foreach ($aReturn as $i => $value) {
				if (is_array($value)) {
					$aReturn[$i] = implode($sSeparator, $value);
				}
			}

			return implode($sSeparator, $aReturn) . (($bHaveMore) ? '…' : '');
		}
	}

	/**
	 * @param string $sInput Input (eg. HTML).
	 *
	 * @return string Cleaned string.
	 */
	private function cleanString($sInput)
	{
		$aSearch  = [
			'Full summary &raquo;',
			'Full synopsis &raquo;',
			'Add summary &raquo;',
			'Add synopsis &raquo;',
			'See more &raquo;',
			'See why on IMDbPro.',
			"\n",
			"\r",
		];
		$aReplace = [
			'',
			'',
			'',
			'',
			'',
			'',
			'',
			'',
		];
		$sInput   = str_replace('</li>', ' | ', $sInput);
		$sInput   = strip_tags($sInput);
		$sInput   = str_replace('&nbsp;', ' ', $sInput);
		$sInput   = str_replace($aSearch, $aReplace, $sInput);
		$sInput   = html_entity_decode($sInput, ENT_QUOTES | ENT_HTML5);
		$sInput   = preg_replace('/\s+/', ' ', $sInput);
		$sInput   = trim($sInput);
		$sInput   = rtrim($sInput, ' |');

		return ($sInput ? trim($sInput) : $this->sNotFound);
	}

	/**
	 * @param string $sText   The long text.
	 * @param int    $iLength The maximum length of the text.
	 *
	 * @return string The shortened text.
	 */
	private function shortText($sText, $iLength = 100)
	{
		if (mb_strlen($sText) <= $iLength) {
			return $sText;
		}

		list($sShort) = explode("\n", wordwrap($sText, $iLength - 1));

		if (substr($sShort, -1) !== '.') {
			return $sShort . '…';
		}

		return $sShort;
	}

	/**
	 * @param string $sUrl The URL to the image to download.
	 * @param int    $iId  The ID of the movie.
	 *
	 * @return string Local path.
	 */
	private function saveImage($sUrl, $iId)
	{
		if (preg_match('~title_addposter.jpg|imdb-share-logo.png~', $sUrl)) {
			return 'posters/not-found.jpg';
		}

		$sFilename = $this->sRoot . '/posters/' . $iId . '.jpg';
		if (file_exists($sFilename)) {
			return 'posters/' . $iId . '.jpg';
		}

		$aCurlInfo = $this->runCurl($sUrl, true);
		$sData     = $aCurlInfo['contents'];
		if (false === $sData) {
			return 'posters/not-found.jpg';
		}

		$oFile = fopen($sFilename, 'x');
		fwrite($oFile, $sData);
		fclose($oFile);

		return 'posters/' . $iId . '.jpg';
	}

	/**
	 * @param string $sUrl      The URL to fetch.
	 * @param bool   $bDownload Download?
	 *
	 * @return bool|mixed Array on success, false on failure.
	 */
	private function runCurl($sUrl, $bDownload = false)
	{
		$oCurl = curl_init($sUrl);
		curl_setopt_array(
			$oCurl,
			[
				CURLOPT_CONNECTTIMEOUT => $this->IMDB_TIMEOUT,
				CURLOPT_ENCODING       => '',
				CURLOPT_FOLLOWLOCATION => true,
				CURLOPT_FRESH_CONNECT  => 0,
				CURLOPT_HEADER         => ($bDownload ? false : true),
				CURLOPT_HTTPHEADER     => [
					'Accept: '.$this->IMDB_BROWSER_ACCEPT,
					'Accept-Language: ' . $this->IMDB_BROWSER_LANG,
				],
				CURLOPT_REFERER        => 'https://www.imdb.com',
				CURLOPT_RETURNTRANSFER => 1,
				CURLOPT_SSL_VERIFYHOST => 0,
				CURLOPT_SSL_VERIFYPEER => 0,
				CURLOPT_TIMEOUT        => $this->IMDB_TIMEOUT,
				CURLOPT_USERAGENT      => $this->IMDB_BROWSER_AGENT,
				CURLOPT_VERBOSE        => 0
			]
		);
		$sOutput   = curl_exec($oCurl);
		$aCurlInfo = curl_getinfo($oCurl);
		curl_close($oCurl);
		$aCurlInfo['contents'] = $sOutput;

		if (200 !== $aCurlInfo['http_code']) {
			if ($this->IMDB_DEBUG) {
				echo '<pre><b>cURL returned wrong HTTP code “' . $aCurlInfo['http_code'] . '”, aborting.</b></pre>';
			}

			return false;
		}

		return $aCurlInfo;
	}

	/**
	 * @param string $sUrl The URL to the image to download.
	 * @param int    $cId  The cast ID of the actor.
	 *
	 * @return string Local path.
	 */
	private function saveImageCast($sUrl, $cId)
	{
		if ( ! preg_match('~http~', $sUrl)) {
			return 'cast/not-found.jpg';
		}

		$sFilename = $this->sRoot . '/cast/' . $cId . '.jpg';
		if (file_exists($sFilename)) {
			return 'cast/' . $cId . '.jpg';
		}

		$aCurlInfo = $this->runCurl($sUrl, true);
		$sData     = $aCurlInfo['contents'];
		if (false === $sData) {
			return 'cast/not-found.jpg';
		}

		$oFile = fopen($sFilename, 'x');
		fwrite($oFile, $sData);
		fclose($oFile);

		return 'cast/' . $cId . '.jpg';
	}

	/**
	 * Makes strings with $this->sSeparator as separator result in an array
	 *
	 * @param $string
	 * @return array|string
	 */
	public function slashStringAsArray($string) {
		$ret = $string;

		if(strstr($string, $this->sSeparator)) {
			$ret = array();
			$_t = explode($this->sSeparator, $string);
			foreach ($_t as $v) {
				$v = trim($v);
				if(!empty($v)) {
					$ret[] = $v;
				}
			}
		}

		return $ret;
	}
}