FilesExpand file tree

 develop

/

class_loader.php

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

170 lines (148 loc) · 4.11 KB

 develop

/

class_loader.php

Copy path

Top

File metadata and controls

• Code
• Blame

170 lines (148 loc) · 4.11 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

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

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

<?php

/**

*

* @package phpBB3

* @copyright (c) 2005 phpBB Group

* @license http://opensource.org/licenses/gpl-2.0.php GNU General Public License v2

*

*/

/**

* @ignore

*/

if (!defined('IN_PHPBB'))

{

exit;

}

/**

* The class loader resolves class names to file system paths and loads them if

* necessary.

*

* Classes have to be of the form phpbb_(dir_)*(classpart_)*, so directory names

* must never contain underscores. Example: phpbb_dir_subdir_class_name is a

* valid class name, while phpbb_dir_sub_dir_class_name is not.

*

* If every part of the class name is a directory, the last directory name is

* also used as the filename, e.g. phpbb_dir would resolve to dir/dir.php.

*

* @package phpBB3

*/

class phpbb_class_loader

{

private $prefix;

private $path;

private $php_ext;

private $cache;

/**

* A map of looked up class names to paths relative to $this->path.

* This map is stored in cache and looked up if the cache is available.

*

* @var array

*/

private $cached_paths = array();

/**

* Creates a new phpbb_class_loader, which loads files with the given

* file extension from the given path.

*

* @param string $prefix Required class name prefix for files to be loaded

* @param string $path Directory to load files from

* @param string $php_ext The file extension for PHP files

* @param phpbb_cache_driver_interface $cache An implementation of the phpBB cache interface.

*/

public function __construct($prefix, $path, $php_ext = 'php', phpbb_cache_driver_interface $cache = null)

{

$this->prefix = $prefix;

$this->path = $path;

$this->php_ext = $php_ext;

$this->set_cache($cache);

}

/**

* Provide the class loader with a cache to store paths. If set to null, the

* the class loader will resolve paths by checking for the existance of every

* directory in the class name every time.

*

* @param phpbb_cache_driver_interface $cache An implementation of the phpBB cache interface.

*/

public function set_cache(phpbb_cache_driver_interface $cache = null)

{

if ($cache)

{

$this->cached_paths = $cache->get('class_loader_' . $this->prefix);

if ($this->cached_paths === false)

{

$this->cached_paths = array();

}

}

$this->cache = $cache;

}

/**

* Registers the class loader as an autoloader using SPL.

*/

public function register()

{

spl_autoload_register(array($this, 'load_class'));

}

/**

* Removes the class loader from the SPL autoloader stack.

*/

public function unregister()

{

spl_autoload_unregister(array($this, 'load_class'));

}

/**

* Resolves a phpBB class name to a relative path which can be included.

*

* @param string $class The class name to resolve, must have a phpbb_

* prefix

* @return string|bool A relative path to the file containing the

* class or false if looking it up failed.

*/

public function resolve_path($class)

{

if (isset($this->cached_paths[$class]))

{

return $this->path . $this->cached_paths[$class] . '.' . $this->php_ext;

}

if (!preg_match('/^' . $this->prefix . '[a-zA-Z0-9_]+$/', $class))

{

return false;

}

$parts = explode('_', substr($class, strlen($this->prefix)));

$dirs = '';

for ($i = 0, $n = sizeof($parts); $i < $n && is_dir($this->path . $dirs . $parts[$i]); $i++)

{

$dirs .= $parts[$i] . '/';

}

// no file name left => use last dir name as file name

if ($i == sizeof($parts))

{

$parts[] = $parts[$i - 1];

}

$relative_path = $dirs . implode(array_slice($parts, $i, sizeof($parts) - $i), '_');

if (!file_exists($this->path . $relative_path . '.' . $this->php_ext))

{

return false;

}

if ($this->cache)

{

$this->cached_paths[$class] = $relative_path;

$this->cache->put('class_loader_' . $this->prefix, $this->cached_paths);

}

return $this->path . $relative_path . '.' . $this->php_ext;

}

/**

* Resolves a class name to a path and then includes it.

*

* @param string $class The class name which is being loaded.

*/

public function load_class($class)

{

if (substr($class, 0, strlen($this->prefix)) === $this->prefix)

{

$path = $this->resolve_path($class);

if ($path)

{

require $path;

}

}

}

}