-
Notifications
You must be signed in to change notification settings - Fork 2
/
autoload.php
154 lines (131 loc) · 4.34 KB
/
autoload.php
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
<?php
/**
* Autoloader for the Block Catalog plugin.
*
* @package BlockCatalog
*/
namespace BlockCatalog;
/**
* PSR-4 Autoloader:
* https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-4-autoloader-examples.md#class-example
*/
class Psr4AutoloaderClass {
/**
* An associative array where the key is a namespace prefix and the value
* is an array of base directories for classes in that namespace.
*
* @var array
*/
protected $prefixes = array();
/**
* Register loader with SPL autoloader stack.
*
* @return void
*/
public function register() {
spl_autoload_register( array( $this, 'load_class' ) );
}
/**
* Adds a base directory for a namespace prefix.
*
* @param string $prefix The namespace prefix.
* @param string $base_dir A base directory for class files in the
* namespace.
* @param bool $prepend If true, prepend the base directory to the stack
* instead of appending it; this causes it to be searched first rather
* than last.
* @return void
*/
public function add_namespace( $prefix, $base_dir, $prepend = false ) {
// normalize namespace prefix
$prefix = trim( $prefix, '\\' ) . '\\';
// normalize the base directory with a trailing separator
$base_dir = rtrim( $base_dir, DIRECTORY_SEPARATOR ) . '/';
// initialize the namespace prefix array
if ( isset( $this->prefixes[ $prefix ] ) === false ) {
$this->prefixes[ $prefix ] = array();
}
// retain the base directory for the namespace prefix
if ( $prepend ) {
array_unshift( $this->prefixes[ $prefix ], $base_dir );
} else {
array_push( $this->prefixes[ $prefix ], $base_dir );
}
}
/**
* Loads the class file for a given class name.
*
* @param string $class The fully-qualified class name.
* @return mixed The mapped file name on success, or boolean false on
* failure.
*/
public function load_class( $class ) {
// the current namespace prefix
$prefix = $class;
// work backwards through the namespace names of the fully-qualified
// class name to find a mapped file name
while ( false !== $pos = strrpos( $prefix, '\\' ) ) { // phpcs:ignore WordPress.CodeAnalysis.AssignmentInCondition.FoundInWhileCondition
// retain the trailing namespace separator in the prefix
$prefix = substr( $class, 0, $pos + 1 );
// the rest is the relative class name
$relative_class = substr( $class, $pos + 1 );
// try to load a mapped file for the prefix and relative class
$mapped_file = $this->load_mapped_file( $prefix, $relative_class );
if ( $mapped_file ) {
return $mapped_file;
}
// remove the trailing namespace separator for the next iteration
// of strrpos()
$prefix = rtrim( $prefix, '\\' );
}
// never found a mapped file
return false;
}
/**
* Load the mapped file for a namespace prefix and relative class.
*
* @param string $prefix The namespace prefix.
* @param string $relative_class The relative class name.
* @return mixed Boolean false if no mapped file can be loaded, or the
* name of the mapped file that was loaded.
*/
protected function load_mapped_file( $prefix, $relative_class ) {
// are there any base directories for this namespace prefix?
if ( isset( $this->prefixes[ $prefix ] ) === false ) {
return false;
}
// look through base directories for this namespace prefix
foreach ( $this->prefixes[ $prefix ] as $base_dir ) {
// replace the namespace prefix with the base directory,
// replace namespace separators with directory separators
// in the relative class name, append with .php
$file = $base_dir . str_replace( '\\', '/', $relative_class ) . '.php';
// if the mapped file exists, require it
if ( $this->require_file( $file ) ) {
// yes, we're done
return $file;
}
}
// never found it
return false;
}
/**
* If a file exists, require it from the file system.
*
* @param string $file The file to require.
* @return bool True if the file exists, false if not.
*/
protected function require_file( $file ) {
if ( file_exists( $file ) ) {
require $file;
return true;
}
return false;
}
}
// instantiate the loader
$block_catalog_loader = new \BlockCatalog\Psr4AutoloaderClass();
// register the autoloader
$block_catalog_loader->register();
// register the base directories for the namespace prefix
$block_catalog_loader->add_namespace( 'BlockCatalog', __DIR__ . '/includes/classes' );