Mercurial > hg > rc1
annotate vendor/composer/ClassLoader.php @ 43:771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
| author | Charlie Root |
|---|---|
| date | Sun, 26 Jan 2025 13:13:49 -0500 |
| parents | 1e000243b222 |
| children |
| rev | line source |
|---|---|
| 0 | 1 <?php |
| 2 | |
| 3 /* | |
| 4 * This file is part of Composer. | |
| 5 * | |
| 6 * (c) Nils Adermann <naderman@naderman.de> | |
| 7 * Jordi Boggiano <j.boggiano@seld.be> | |
| 8 * | |
| 9 * For the full copyright and license information, please view the LICENSE | |
| 10 * file that was distributed with this source code. | |
| 11 */ | |
| 12 | |
| 13 namespace Composer\Autoload; | |
| 14 | |
| 15 /** | |
| 16 * ClassLoader implements a PSR-0, PSR-4 and classmap class loader. | |
| 17 * | |
| 18 * $loader = new \Composer\Autoload\ClassLoader(); | |
| 19 * | |
| 20 * // register classes with namespaces | |
| 21 * $loader->add('Symfony\Component', __DIR__.'/component'); | |
| 22 * $loader->add('Symfony', __DIR__.'/framework'); | |
| 23 * | |
| 24 * // activate the autoloader | |
| 25 * $loader->register(); | |
| 26 * | |
| 27 * // to enable searching the include path (eg. for PEAR packages) | |
| 28 * $loader->setUseIncludePath(true); | |
| 29 * | |
| 30 * In this example, if you try to use a class in the Symfony\Component | |
| 31 * namespace or one of its children (Symfony\Component\Console for instance), | |
| 32 * the autoloader will first look for the class under the component/ | |
| 33 * directory, and it will then fallback to the framework/ directory if not | |
| 34 * found before giving up. | |
| 35 * | |
| 36 * This class is loosely based on the Symfony UniversalClassLoader. | |
| 37 * | |
| 38 * @author Fabien Potencier <fabien@symfony.com> | |
| 39 * @author Jordi Boggiano <j.boggiano@seld.be> | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
40 * @see https://www.php-fig.org/psr/psr-0/ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
41 * @see https://www.php-fig.org/psr/psr-4/ |
| 0 | 42 */ |
| 43 class ClassLoader | |
| 44 { | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
45 /** @var \Closure(string):void */ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
46 private static $includeFile; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
47 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
48 /** @var string|null */ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
49 private $vendorDir; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
50 |
| 0 | 51 // PSR-4 |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
52 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
53 * @var array<string, array<string, int>> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
54 */ |
| 0 | 55 private $prefixLengthsPsr4 = array(); |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
56 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
57 * @var array<string, list<string>> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
58 */ |
| 0 | 59 private $prefixDirsPsr4 = array(); |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
60 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
61 * @var list<string> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
62 */ |
| 0 | 63 private $fallbackDirsPsr4 = array(); |
| 64 | |
| 65 // PSR-0 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
66 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
67 * List of PSR-0 prefixes |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
68 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
69 * Structured as array('F (first letter)' => array('Foo\Bar (full prefix)' => array('path', 'path2'))) |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
70 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
71 * @var array<string, array<string, list<string>>> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
72 */ |
| 0 | 73 private $prefixesPsr0 = array(); |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
74 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
75 * @var list<string> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
76 */ |
| 0 | 77 private $fallbackDirsPsr0 = array(); |
| 78 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
79 /** @var bool */ |
| 0 | 80 private $useIncludePath = false; |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
81 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
82 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
83 * @var array<string, string> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
84 */ |
| 0 | 85 private $classMap = array(); |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
86 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
87 /** @var bool */ |
| 0 | 88 private $classMapAuthoritative = false; |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
89 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
90 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
91 * @var array<string, bool> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
92 */ |
| 0 | 93 private $missingClasses = array(); |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
94 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
95 /** @var string|null */ |
| 0 | 96 private $apcuPrefix; |
| 97 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
98 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
99 * @var array<string, self> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
100 */ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
101 private static $registeredLoaders = array(); |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
102 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
103 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
104 * @param string|null $vendorDir |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
105 */ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
106 public function __construct($vendorDir = null) |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
107 { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
108 $this->vendorDir = $vendorDir; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
109 self::initializeIncludeClosure(); |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
110 } |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
111 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
112 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
113 * @return array<string, list<string>> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
114 */ |
| 0 | 115 public function getPrefixes() |
| 116 { | |
| 117 if (!empty($this->prefixesPsr0)) { | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
118 return call_user_func_array('array_merge', array_values($this->prefixesPsr0)); |
| 0 | 119 } |
| 120 | |
| 121 return array(); | |
| 122 } | |
| 123 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
124 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
125 * @return array<string, list<string>> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
126 */ |
| 0 | 127 public function getPrefixesPsr4() |
| 128 { | |
| 129 return $this->prefixDirsPsr4; | |
| 130 } | |
| 131 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
132 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
133 * @return list<string> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
134 */ |
| 0 | 135 public function getFallbackDirs() |
| 136 { | |
| 137 return $this->fallbackDirsPsr0; | |
| 138 } | |
| 139 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
140 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
141 * @return list<string> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
142 */ |
| 0 | 143 public function getFallbackDirsPsr4() |
| 144 { | |
| 145 return $this->fallbackDirsPsr4; | |
| 146 } | |
| 147 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
148 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
149 * @return array<string, string> Array of classname => path |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
150 */ |
| 0 | 151 public function getClassMap() |
| 152 { | |
| 153 return $this->classMap; | |
| 154 } | |
| 155 | |
| 156 /** | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
157 * @param array<string, string> $classMap Class to filename map |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
158 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
159 * @return void |
| 0 | 160 */ |
| 161 public function addClassMap(array $classMap) | |
| 162 { | |
| 163 if ($this->classMap) { | |
| 164 $this->classMap = array_merge($this->classMap, $classMap); | |
| 165 } else { | |
| 166 $this->classMap = $classMap; | |
| 167 } | |
| 168 } | |
| 169 | |
| 170 /** | |
| 171 * Registers a set of PSR-0 directories for a given prefix, either | |
| 172 * appending or prepending to the ones previously set for this prefix. | |
| 173 * | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
174 * @param string $prefix The prefix |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
175 * @param list<string>|string $paths The PSR-0 root directories |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
176 * @param bool $prepend Whether to prepend the directories |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
177 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
178 * @return void |
| 0 | 179 */ |
| 180 public function add($prefix, $paths, $prepend = false) | |
| 181 { | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
182 $paths = (array) $paths; |
| 0 | 183 if (!$prefix) { |
| 184 if ($prepend) { | |
| 185 $this->fallbackDirsPsr0 = array_merge( | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
186 $paths, |
| 0 | 187 $this->fallbackDirsPsr0 |
| 188 ); | |
| 189 } else { | |
| 190 $this->fallbackDirsPsr0 = array_merge( | |
| 191 $this->fallbackDirsPsr0, | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
192 $paths |
| 0 | 193 ); |
| 194 } | |
| 195 | |
| 196 return; | |
| 197 } | |
| 198 | |
| 199 $first = $prefix[0]; | |
| 200 if (!isset($this->prefixesPsr0[$first][$prefix])) { | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
201 $this->prefixesPsr0[$first][$prefix] = $paths; |
| 0 | 202 |
| 203 return; | |
| 204 } | |
| 205 if ($prepend) { | |
| 206 $this->prefixesPsr0[$first][$prefix] = array_merge( | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
207 $paths, |
| 0 | 208 $this->prefixesPsr0[$first][$prefix] |
| 209 ); | |
| 210 } else { | |
| 211 $this->prefixesPsr0[$first][$prefix] = array_merge( | |
| 212 $this->prefixesPsr0[$first][$prefix], | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
213 $paths |
| 0 | 214 ); |
| 215 } | |
| 216 } | |
| 217 | |
| 218 /** | |
| 219 * Registers a set of PSR-4 directories for a given namespace, either | |
| 220 * appending or prepending to the ones previously set for this namespace. | |
| 221 * | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
222 * @param string $prefix The prefix/namespace, with trailing '\\' |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
223 * @param list<string>|string $paths The PSR-4 base directories |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
224 * @param bool $prepend Whether to prepend the directories |
| 0 | 225 * |
| 226 * @throws \InvalidArgumentException | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
227 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
228 * @return void |
| 0 | 229 */ |
| 230 public function addPsr4($prefix, $paths, $prepend = false) | |
| 231 { | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
232 $paths = (array) $paths; |
| 0 | 233 if (!$prefix) { |
| 234 // Register directories for the root namespace. | |
| 235 if ($prepend) { | |
| 236 $this->fallbackDirsPsr4 = array_merge( | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
237 $paths, |
| 0 | 238 $this->fallbackDirsPsr4 |
| 239 ); | |
| 240 } else { | |
| 241 $this->fallbackDirsPsr4 = array_merge( | |
| 242 $this->fallbackDirsPsr4, | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
243 $paths |
| 0 | 244 ); |
| 245 } | |
| 246 } elseif (!isset($this->prefixDirsPsr4[$prefix])) { | |
| 247 // Register directories for a new namespace. | |
| 248 $length = strlen($prefix); | |
| 249 if ('\\' !== $prefix[$length - 1]) { | |
| 250 throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); | |
| 251 } | |
| 252 $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
253 $this->prefixDirsPsr4[$prefix] = $paths; |
| 0 | 254 } elseif ($prepend) { |
| 255 // Prepend directories for an already registered namespace. | |
| 256 $this->prefixDirsPsr4[$prefix] = array_merge( | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
257 $paths, |
| 0 | 258 $this->prefixDirsPsr4[$prefix] |
| 259 ); | |
| 260 } else { | |
| 261 // Append directories for an already registered namespace. | |
| 262 $this->prefixDirsPsr4[$prefix] = array_merge( | |
| 263 $this->prefixDirsPsr4[$prefix], | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
264 $paths |
| 0 | 265 ); |
| 266 } | |
| 267 } | |
| 268 | |
| 269 /** | |
| 270 * Registers a set of PSR-0 directories for a given prefix, | |
| 271 * replacing any others previously set for this prefix. | |
| 272 * | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
273 * @param string $prefix The prefix |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
274 * @param list<string>|string $paths The PSR-0 base directories |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
275 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
276 * @return void |
| 0 | 277 */ |
| 278 public function set($prefix, $paths) | |
| 279 { | |
| 280 if (!$prefix) { | |
| 281 $this->fallbackDirsPsr0 = (array) $paths; | |
| 282 } else { | |
| 283 $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths; | |
| 284 } | |
| 285 } | |
| 286 | |
| 287 /** | |
| 288 * Registers a set of PSR-4 directories for a given namespace, | |
| 289 * replacing any others previously set for this namespace. | |
| 290 * | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
291 * @param string $prefix The prefix/namespace, with trailing '\\' |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
292 * @param list<string>|string $paths The PSR-4 base directories |
| 0 | 293 * |
| 294 * @throws \InvalidArgumentException | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
295 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
296 * @return void |
| 0 | 297 */ |
| 298 public function setPsr4($prefix, $paths) | |
| 299 { | |
| 300 if (!$prefix) { | |
| 301 $this->fallbackDirsPsr4 = (array) $paths; | |
| 302 } else { | |
| 303 $length = strlen($prefix); | |
| 304 if ('\\' !== $prefix[$length - 1]) { | |
| 305 throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator."); | |
| 306 } | |
| 307 $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length; | |
| 308 $this->prefixDirsPsr4[$prefix] = (array) $paths; | |
| 309 } | |
| 310 } | |
| 311 | |
| 312 /** | |
| 313 * Turns on searching the include path for class files. | |
| 314 * | |
| 315 * @param bool $useIncludePath | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
316 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
317 * @return void |
| 0 | 318 */ |
| 319 public function setUseIncludePath($useIncludePath) | |
| 320 { | |
| 321 $this->useIncludePath = $useIncludePath; | |
| 322 } | |
| 323 | |
| 324 /** | |
| 325 * Can be used to check if the autoloader uses the include path to check | |
| 326 * for classes. | |
| 327 * | |
| 328 * @return bool | |
| 329 */ | |
| 330 public function getUseIncludePath() | |
| 331 { | |
| 332 return $this->useIncludePath; | |
| 333 } | |
| 334 | |
| 335 /** | |
| 336 * Turns off searching the prefix and fallback directories for classes | |
| 337 * that have not been registered with the class map. | |
| 338 * | |
| 339 * @param bool $classMapAuthoritative | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
340 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
341 * @return void |
| 0 | 342 */ |
| 343 public function setClassMapAuthoritative($classMapAuthoritative) | |
| 344 { | |
| 345 $this->classMapAuthoritative = $classMapAuthoritative; | |
| 346 } | |
| 347 | |
| 348 /** | |
| 349 * Should class lookup fail if not found in the current class map? | |
| 350 * | |
| 351 * @return bool | |
| 352 */ | |
| 353 public function isClassMapAuthoritative() | |
| 354 { | |
| 355 return $this->classMapAuthoritative; | |
| 356 } | |
| 357 | |
| 358 /** | |
| 359 * APCu prefix to use to cache found/not-found classes, if the extension is enabled. | |
| 360 * | |
| 361 * @param string|null $apcuPrefix | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
362 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
363 * @return void |
| 0 | 364 */ |
| 365 public function setApcuPrefix($apcuPrefix) | |
| 366 { | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
367 $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null; |
| 0 | 368 } |
| 369 | |
| 370 /** | |
| 371 * The APCu prefix in use, or null if APCu caching is not enabled. | |
| 372 * | |
| 373 * @return string|null | |
| 374 */ | |
| 375 public function getApcuPrefix() | |
| 376 { | |
| 377 return $this->apcuPrefix; | |
| 378 } | |
| 379 | |
| 380 /** | |
| 381 * Registers this instance as an autoloader. | |
| 382 * | |
| 383 * @param bool $prepend Whether to prepend the autoloader or not | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
384 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
385 * @return void |
| 0 | 386 */ |
| 387 public function register($prepend = false) | |
| 388 { | |
| 389 spl_autoload_register(array($this, 'loadClass'), true, $prepend); | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
390 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
391 if (null === $this->vendorDir) { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
392 return; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
393 } |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
394 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
395 if ($prepend) { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
396 self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
397 } else { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
398 unset(self::$registeredLoaders[$this->vendorDir]); |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
399 self::$registeredLoaders[$this->vendorDir] = $this; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
400 } |
| 0 | 401 } |
| 402 | |
| 403 /** | |
| 404 * Unregisters this instance as an autoloader. | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
405 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
406 * @return void |
| 0 | 407 */ |
| 408 public function unregister() | |
| 409 { | |
| 410 spl_autoload_unregister(array($this, 'loadClass')); | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
411 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
412 if (null !== $this->vendorDir) { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
413 unset(self::$registeredLoaders[$this->vendorDir]); |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
414 } |
| 0 | 415 } |
| 416 | |
| 417 /** | |
| 418 * Loads the given class or interface. | |
| 419 * | |
| 420 * @param string $class The name of the class | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
421 * @return true|null True if loaded, null otherwise |
| 0 | 422 */ |
| 423 public function loadClass($class) | |
| 424 { | |
| 425 if ($file = $this->findFile($class)) { | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
426 $includeFile = self::$includeFile; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
427 $includeFile($file); |
| 0 | 428 |
| 429 return true; | |
| 430 } | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
431 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
432 return null; |
| 0 | 433 } |
| 434 | |
| 435 /** | |
| 436 * Finds the path to the file where the class is defined. | |
| 437 * | |
| 438 * @param string $class The name of the class | |
| 439 * | |
| 440 * @return string|false The path if found, false otherwise | |
| 441 */ | |
| 442 public function findFile($class) | |
| 443 { | |
| 444 // class map lookup | |
| 445 if (isset($this->classMap[$class])) { | |
| 446 return $this->classMap[$class]; | |
| 447 } | |
| 448 if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) { | |
| 449 return false; | |
| 450 } | |
| 451 if (null !== $this->apcuPrefix) { | |
| 452 $file = apcu_fetch($this->apcuPrefix.$class, $hit); | |
| 453 if ($hit) { | |
| 454 return $file; | |
| 455 } | |
| 456 } | |
| 457 | |
| 458 $file = $this->findFileWithExtension($class, '.php'); | |
| 459 | |
| 460 // Search for Hack files if we are running on HHVM | |
| 461 if (false === $file && defined('HHVM_VERSION')) { | |
| 462 $file = $this->findFileWithExtension($class, '.hh'); | |
| 463 } | |
| 464 | |
| 465 if (null !== $this->apcuPrefix) { | |
| 466 apcu_add($this->apcuPrefix.$class, $file); | |
| 467 } | |
| 468 | |
| 469 if (false === $file) { | |
| 470 // Remember that this class does not exist. | |
| 471 $this->missingClasses[$class] = true; | |
| 472 } | |
| 473 | |
| 474 return $file; | |
| 475 } | |
| 476 | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
477 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
478 * Returns the currently registered loaders keyed by their corresponding vendor directories. |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
479 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
480 * @return array<string, self> |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
481 */ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
482 public static function getRegisteredLoaders() |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
483 { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
484 return self::$registeredLoaders; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
485 } |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
486 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
487 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
488 * @param string $class |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
489 * @param string $ext |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
490 * @return string|false |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
491 */ |
| 0 | 492 private function findFileWithExtension($class, $ext) |
| 493 { | |
| 494 // PSR-4 lookup | |
| 495 $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext; | |
| 496 | |
| 497 $first = $class[0]; | |
| 498 if (isset($this->prefixLengthsPsr4[$first])) { | |
| 499 $subPath = $class; | |
| 500 while (false !== $lastPos = strrpos($subPath, '\\')) { | |
| 501 $subPath = substr($subPath, 0, $lastPos); | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
502 $search = $subPath . '\\'; |
| 0 | 503 if (isset($this->prefixDirsPsr4[$search])) { |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
504 $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1); |
| 0 | 505 foreach ($this->prefixDirsPsr4[$search] as $dir) { |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
506 if (file_exists($file = $dir . $pathEnd)) { |
| 0 | 507 return $file; |
| 508 } | |
| 509 } | |
| 510 } | |
| 511 } | |
| 512 } | |
| 513 | |
| 514 // PSR-4 fallback dirs | |
| 515 foreach ($this->fallbackDirsPsr4 as $dir) { | |
| 516 if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) { | |
| 517 return $file; | |
| 518 } | |
| 519 } | |
| 520 | |
| 521 // PSR-0 lookup | |
| 522 if (false !== $pos = strrpos($class, '\\')) { | |
| 523 // namespaced class name | |
| 524 $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1) | |
| 525 . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR); | |
| 526 } else { | |
| 527 // PEAR-like class name | |
| 528 $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext; | |
| 529 } | |
| 530 | |
| 531 if (isset($this->prefixesPsr0[$first])) { | |
| 532 foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) { | |
| 533 if (0 === strpos($class, $prefix)) { | |
| 534 foreach ($dirs as $dir) { | |
| 535 if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { | |
| 536 return $file; | |
| 537 } | |
| 538 } | |
| 539 } | |
| 540 } | |
| 541 } | |
| 542 | |
| 543 // PSR-0 fallback dirs | |
| 544 foreach ($this->fallbackDirsPsr0 as $dir) { | |
| 545 if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) { | |
| 546 return $file; | |
| 547 } | |
| 548 } | |
| 549 | |
| 550 // PSR-0 include paths. | |
| 551 if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) { | |
| 552 return $file; | |
| 553 } | |
| 554 | |
| 555 return false; | |
| 556 } | |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
557 |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
558 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
559 * @return void |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
560 */ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
561 private static function initializeIncludeClosure() |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
562 { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
563 if (self::$includeFile !== null) { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
564 return; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
565 } |
| 0 | 566 |
|
43
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
567 /** |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
568 * Scope isolated include. |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
569 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
570 * Prevents access to $this/self from included files. |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
571 * |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
572 * @param string $file |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
573 * @return void |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
574 */ |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
575 self::$includeFile = \Closure::bind(static function($file) { |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
576 include $file; |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
577 }, null, null); |
|
771f6803cc4b
somehow lost the correctly updated metadata so e.g. 'mail' package wasn't being imported
Charlie Root
parents:
0
diff
changeset
|
578 } |
| 0 | 579 } |
