<?php

[0] Fix | Delete

[1] Fix | Delete

// SPDX-FileCopyrightText: 2004-2023 Ryan Parman, Sam Sneddon, Ryan McCue

[2] Fix | Delete

// SPDX-License-Identifier: BSD-3-Clause

[3] Fix | Delete

[4] Fix | Delete

declare(strict_types=1);

[5] Fix | Delete

[6] Fix | Delete

namespace SimplePie;

[7] Fix | Delete

[8] Fix | Delete

use SimplePie\Cache\Base;

[9] Fix | Delete

[10] Fix | Delete

/**

[11] Fix | Delete

* Used to create cache objects

[12] Fix | Delete

*

[13] Fix | Delete

* This class can be overloaded with {@see SimplePie::set_cache_class()},

[14] Fix | Delete

* although the preferred way is to create your own handler

[15] Fix | Delete

* via {@see register()}

[16] Fix | Delete

*

[17] Fix | Delete

* @deprecated since SimplePie 1.8.0, use "SimplePie\SimplePie::set_cache()" instead

[18] Fix | Delete

*/

[19] Fix | Delete

class Cache

[20] Fix | Delete

{

[21] Fix | Delete

/**

[22] Fix | Delete

* Cache handler classes

[23] Fix | Delete

*

[24] Fix | Delete

* These receive 3 parameters to their constructor, as documented in

[25] Fix | Delete

* {@see register()}

[26] Fix | Delete

* @var array<string, class-string<Base>>

[27] Fix | Delete

*/

[28] Fix | Delete

protected static $handlers = [

[29] Fix | Delete

'mysql' => Cache\MySQL::class,

[30] Fix | Delete

'memcache' => Cache\Memcache::class,

[31] Fix | Delete

'memcached' => Cache\Memcached::class,

[32] Fix | Delete

'redis' => Cache\Redis::class,

[33] Fix | Delete

];

[34] Fix | Delete

[35] Fix | Delete

/**

[36] Fix | Delete

* Don't call the constructor. Please.

[37] Fix | Delete

*/

[38] Fix | Delete

private function __construct()

[39] Fix | Delete

{

[40] Fix | Delete

}

[41] Fix | Delete

[42] Fix | Delete

/**

[43] Fix | Delete

* Create a new SimplePie\Cache object

[44] Fix | Delete

*

[45] Fix | Delete

* @param string $location URL location (scheme is used to determine handler)

[46] Fix | Delete

* @param string $filename Unique identifier for cache object

[47] Fix | Delete

* @param Base::TYPE_FEED|Base::TYPE_IMAGE $extension 'spi' or 'spc'

[48] Fix | Delete

* @return Base Type of object depends on scheme of `$location`

[49] Fix | Delete

*/

[50] Fix | Delete

public static function get_handler(string $location, string $filename, $extension)

[51] Fix | Delete

{

[52] Fix | Delete

$type = explode(':', $location, 2);

[53] Fix | Delete

$type = $type[0];

[54] Fix | Delete

if (!empty(self::$handlers[$type])) {

[55] Fix | Delete

$class = self::$handlers[$type];

[56] Fix | Delete

return new $class($location, $filename, $extension);

[57] Fix | Delete

}

[58] Fix | Delete

[59] Fix | Delete

return new \SimplePie\Cache\File($location, $filename, $extension);

[60] Fix | Delete

}

[61] Fix | Delete

[62] Fix | Delete

/**

[63] Fix | Delete

* Create a new SimplePie\Cache object

[64] Fix | Delete

*

[65] Fix | Delete

* @deprecated since SimplePie 1.3.1, use {@see get_handler()} instead

[66] Fix | Delete

* @param string $location

[67] Fix | Delete

* @param string $filename

[68] Fix | Delete

* @param Base::TYPE_FEED|Base::TYPE_IMAGE $extension

[69] Fix | Delete

* @return Base

[70] Fix | Delete

*/

[71] Fix | Delete

public function create(string $location, string $filename, $extension)

[72] Fix | Delete

{

[73] Fix | Delete

trigger_error('Cache::create() has been replaced with Cache::get_handler() since SimplePie 1.3.1, use the registry system instead.', \E_USER_DEPRECATED);

[74] Fix | Delete

[75] Fix | Delete

return self::get_handler($location, $filename, $extension);

[76] Fix | Delete

}

[77] Fix | Delete

[78] Fix | Delete

/**

[79] Fix | Delete

* Register a handler

[80] Fix | Delete

*

[81] Fix | Delete

* @param string $type DSN type to register for

[82] Fix | Delete

* @param class-string<Base> $class Name of handler class. Must implement Base

[83] Fix | Delete

* @return void

[84] Fix | Delete

*/

[85] Fix | Delete

public static function register(string $type, $class)

[86] Fix | Delete

{

[87] Fix | Delete

self::$handlers[$type] = $class;

[88] Fix | Delete

}

[89] Fix | Delete

[90] Fix | Delete

/**

[91] Fix | Delete

* Parse a URL into an array

[92] Fix | Delete

*

[93] Fix | Delete

* @param string $url

[94] Fix | Delete

* @return array<string, mixed>

[95] Fix | Delete

*/

[96] Fix | Delete

public static function parse_URL(string $url)

[97] Fix | Delete

{

[98] Fix | Delete

$parsedUrl = parse_url($url);

[99] Fix | Delete

[100] Fix | Delete

if ($parsedUrl === false) {

[101] Fix | Delete

return [];

[102] Fix | Delete

}

[103] Fix | Delete

[104] Fix | Delete

$params = array_merge($parsedUrl, ['extras' => []]);

[105] Fix | Delete

if (isset($params['query'])) {

[106] Fix | Delete

parse_str($params['query'], $params['extras']);

[107] Fix | Delete

}

[108] Fix | Delete

return $params;

[109] Fix | Delete

}

[110] Fix | Delete

}

[111] Fix | Delete

[112] Fix | Delete

class_alias('SimplePie\Cache', 'SimplePie_Cache');

[113] Fix | Delete

[114] Fix | Delete