Factory.php
2.12 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
<?php
/**
* Part of the Joomla Framework Registry Package
*
* @copyright Copyright (C) 2005 - 2018 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE
*/
namespace Joomla\Registry;
/**
* Factory class to fetch Registry objects
*
* @since 1.5.0
*/
class Factory
{
/**
* Format instances container - for backward compatibility with AbstractRegistryFormat::getInstance().
*
* @var FormatInterface[]
* @since 1.5.0
* @deprecated 2.0 Object caching will no longer be supported
*/
protected static $formatInstances = array();
/**
* Returns an AbstractRegistryFormat object, only creating it if it doesn't already exist.
*
* @param string $type The format to load
* @param array $options Additional options to configure the object
*
* @return FormatInterface Registry format handler
*
* @since 1.5.0
* @throws \InvalidArgumentException
*/
public static function getFormat($type, array $options = array())
{
// Sanitize format type.
$type = strtolower(preg_replace('/[^A-Z0-9_]/i', '', $type));
/*
* Only instantiate the object if it doesn't already exist.
* @deprecated 2.0 Object caching will no longer be supported, a new instance will be returned every time
*/
if (!isset(self::$formatInstances[$type]))
{
$localNamespace = __NAMESPACE__ . '\\Format';
$namespace = isset($options['format_namespace']) ? $options['format_namespace'] : $localNamespace;
$class = $namespace . '\\' . ucfirst($type);
if (!class_exists($class))
{
// Were we given a custom namespace? If not, there's nothing else we can do
if ($namespace === $localNamespace)
{
throw new \InvalidArgumentException(sprintf('Unable to load format class for type "%s".', $type), 500);
}
$class = $localNamespace . '\\' . ucfirst($type);
if (!class_exists($class))
{
throw new \InvalidArgumentException(sprintf('Unable to load format class for type "%s".', $type), 500);
}
}
self::$formatInstances[$type] = new $class;
}
return self::$formatInstances[$type];
}
}