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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
<?php
/**
* This class is responsible for creating Node objects
*/
declare(strict_types=1);
namespace PhpMyAdmin\Navigation;
use PhpMyAdmin\Navigation\Nodes\Node;
use function __;
use function class_exists;
use function preg_match;
use function sprintf;
use function trigger_error;
use const E_USER_ERROR;
/**
* Node factory - instantiates Node objects or objects derived from the Node class
*/
class NodeFactory
{
/** @var string */
protected static $namespace = 'PhpMyAdmin\\Navigation\\Nodes\\%s';
/**
* Sanitizes the name of a Node class
*
* @param string $class The class name to be sanitized
*
* @return string
* @psalm-return class-string
*/
private static function sanitizeClass($class)
{
if (! preg_match('@^Node\w*$@', $class)) {
$class = 'Node';
trigger_error(
sprintf(
/* l10n: The word "Node" must not be translated here */
__('Invalid class name "%1$s", using default of "Node"'),
$class
),
E_USER_ERROR
);
}
return self::checkClass($class);
}
/**
* Checks if a class exists and try to load it.
* Will return the default class name back if the
* file for some subclass is not available
*
* @param string $class The class name to check
*
* @return string
* @psalm-return class-string
*/
private static function checkClass($class)
{
/** @var class-string $class */
$class = sprintf(self::$namespace, $class);
if (! class_exists($class)) {
/** @var class-string $class */
$class = sprintf(self::$namespace, 'Node');
trigger_error(
sprintf(
__('Could not load class "%1$s"'),
$class
),
E_USER_ERROR
);
}
return $class;
}
/**
* Instantiates a Node object
*
* @param string $class The name of the class to instantiate
* @param string|array $name An identifier for the new node
* @param int $type Type of node, may be one of CONTAINER or OBJECT
* @param bool $isGroup Whether this object has been created while grouping nodes
*/
public static function getInstance(
$class = 'Node',
$name = 'default',
$type = Node::OBJECT,
$isGroup = false
): Node {
$class = self::sanitizeClass($class);
/** @var Node $node */
$node = new $class($name, $type, $isGroup);
return $node;
}
/**
* Instantiates a Node object that will be used only for "New db/table/etc.." objects
*
* @param string $name An identifier for the new node
* @param string $classes Extra CSS classes for the node
*/
public static function getInstanceForNewNode(
string $name,
string $classes
): Node {
$node = new Node($name, Node::OBJECT, false);
$node->title = $name;
$node->isNew = true;
$node->classes = $classes;
return $node;
}
}
|
