rc1: vendor/composer/ClassLoader.php comparison

comparison vendor/composer/ClassLoader.php @ 43:771f6803cc4b default tip

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

comparison

equal deleted inserted replaced

-:db1e51c59ddc
+:771f6803cc4b
 *
 * This class is loosely based on the Symfony UniversalClassLoader.
 *
 * @author Fabien Potencier <fabien@symfony.com>
 * @author Jordi Boggiano <j.boggiano@seld.be>
-* @see    http://www.php-fig.org/psr/psr-0/
+* @see    https://www.php-fig.org/psr/psr-0/
-* @see    http://www.php-fig.org/psr/psr-4/
+* @see    https://www.php-fig.org/psr/psr-4/
 */
 class ClassLoader
 {
+/** @var \Closure(string):void */
+private static $includeFile;
+/** @var string|null */
+private $vendorDir;
 // PSR-4
+/**
+* @var array<string, array<string, int>>
+*/
 private $prefixLengthsPsr4 = array();
+/**
+* @var array<string, list<string>>
+*/
 private $prefixDirsPsr4 = array();
+/**
+* @var list<string>
+*/
 private $fallbackDirsPsr4 = array();
 // PSR-0
+/**
+* List of PSR-0 prefixes
+*
+* Structured as array('F (first letter)' => array('Foo\Bar (full prefix)' => array('path', 'path2')))
+*
+* @var array<string, array<string, list<string>>>
+*/
 private $prefixesPsr0 = array();
+/**
+* @var list<string>
+*/
 private $fallbackDirsPsr0 = array();
+/** @var bool */
 private $useIncludePath = false;
+/**
+* @var array<string, string>
+*/
 private $classMap = array();
+/** @var bool */
 private $classMapAuthoritative = false;
+/**
+* @var array<string, bool>
+*/
 private $missingClasses = array();
+/** @var string|null */
 private $apcuPrefix;
+/**
+* @var array<string, self>
+*/
+private static $registeredLoaders = array();
+/**
+* @param string|null $vendorDir
+*/
+public function __construct($vendorDir = null)
+{
+$this->vendorDir = $vendorDir;
+self::initializeIncludeClosure();
+}
+/**
+* @return array<string, list<string>>
+*/
 public function getPrefixes()
 {
 if (!empty($this->prefixesPsr0)) {
-return call_user_func_array('array_merge', $this->prefixesPsr0);
+return call_user_func_array('array_merge', array_values($this->prefixesPsr0));
 }
 return array();
 }
+/**
+* @return array<string, list<string>>
+*/
 public function getPrefixesPsr4()
 {
 return $this->prefixDirsPsr4;
 }
+/**
+* @return list<string>
+*/
 public function getFallbackDirs()
 {
 return $this->fallbackDirsPsr0;
 }
+/**
+* @return list<string>
+*/
 public function getFallbackDirsPsr4()
 {
 return $this->fallbackDirsPsr4;
 }
+/**
+* @return array<string, string> Array of classname => path
+*/
 public function getClassMap()
 {
 return $this->classMap;
 }
 /**
-* @param array $classMap Class to filename map
+* @param array<string, string> $classMap Class to filename map
+*
+* @return void
 */
 public function addClassMap(array $classMap)
 {
 if ($this->classMap) {
 $this->classMap = array_merge($this->classMap, $classMap);
 /**
 * Registers a set of PSR-0 directories for a given prefix, either
 * appending or prepending to the ones previously set for this prefix.
 *
-* @param string       $prefix  The prefix
+* @param string              $prefix  The prefix
-* @param array|string $paths   The PSR-0 root directories
+* @param list<string>|string $paths   The PSR-0 root directories
-* @param bool         $prepend Whether to prepend the directories
+* @param bool                $prepend Whether to prepend the directories
+*
+* @return void
 */
 public function add($prefix, $paths, $prepend = false)
 {
+$paths = (array) $paths;
 if (!$prefix) {
 if ($prepend) {
 $this->fallbackDirsPsr0 = array_merge(
-(array) $paths,
+$paths,
 $this->fallbackDirsPsr0
 );
 } else {
 $this->fallbackDirsPsr0 = array_merge(
 $this->fallbackDirsPsr0,
-(array) $paths
+$paths
 );
 }
 return;
 }
 $first = $prefix[0];
 if (!isset($this->prefixesPsr0[$first][$prefix])) {
-$this->prefixesPsr0[$first][$prefix] = (array) $paths;
+$this->prefixesPsr0[$first][$prefix] = $paths;
 return;
 }
 if ($prepend) {
 $this->prefixesPsr0[$first][$prefix] = array_merge(
-(array) $paths,
+$paths,
 $this->prefixesPsr0[$first][$prefix]
 );
 } else {
 $this->prefixesPsr0[$first][$prefix] = array_merge(
 $this->prefixesPsr0[$first][$prefix],
-(array) $paths
+$paths
 );
 }
 }
 /**
 * Registers a set of PSR-4 directories for a given namespace, either
 * appending or prepending to the ones previously set for this namespace.
 *
-* @param string       $prefix  The prefix/namespace, with trailing '\\'
+* @param string              $prefix  The prefix/namespace, with trailing '\\'
-* @param array|string $paths   The PSR-4 base directories
+* @param list<string>|string $paths   The PSR-4 base directories
-* @param bool         $prepend Whether to prepend the directories
+* @param bool                $prepend Whether to prepend the directories
 *
 * @throws \InvalidArgumentException
+*
+* @return void
 */
 public function addPsr4($prefix, $paths, $prepend = false)
 {
+$paths = (array) $paths;
 if (!$prefix) {
 // Register directories for the root namespace.
 if ($prepend) {
 $this->fallbackDirsPsr4 = array_merge(
-(array) $paths,
+$paths,
 $this->fallbackDirsPsr4
 );
 } else {
 $this->fallbackDirsPsr4 = array_merge(
 $this->fallbackDirsPsr4,
-(array) $paths
+$paths
 );
 }
 } elseif (!isset($this->prefixDirsPsr4[$prefix])) {
 // Register directories for a new namespace.
 $length = strlen($prefix);
 if ('\\' !== $prefix[$length - 1]) {
 throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
 }
 $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
-$this->prefixDirsPsr4[$prefix] = (array) $paths;
+$this->prefixDirsPsr4[$prefix] = $paths;
 } elseif ($prepend) {
 // Prepend directories for an already registered namespace.
 $this->prefixDirsPsr4[$prefix] = array_merge(
-(array) $paths,
+$paths,
 $this->prefixDirsPsr4[$prefix]
 );
 } else {
 // Append directories for an already registered namespace.
 $this->prefixDirsPsr4[$prefix] = array_merge(
 $this->prefixDirsPsr4[$prefix],
-(array) $paths
+$paths
 );
 }
 }
 /**
 * Registers a set of PSR-0 directories for a given prefix,
 * replacing any others previously set for this prefix.
 *
-* @param string       $prefix The prefix
+* @param string              $prefix The prefix
-* @param array|string $paths  The PSR-0 base directories
+* @param list<string>|string $paths  The PSR-0 base directories
+*
+* @return void
 */
 public function set($prefix, $paths)
 {
 if (!$prefix) {
 $this->fallbackDirsPsr0 = (array) $paths;
 /**
 * Registers a set of PSR-4 directories for a given namespace,
 * replacing any others previously set for this namespace.
 *
-* @param string       $prefix The prefix/namespace, with trailing '\\'
+* @param string              $prefix The prefix/namespace, with trailing '\\'
-* @param array|string $paths  The PSR-4 base directories
+* @param list<string>|string $paths  The PSR-4 base directories
 *
 * @throws \InvalidArgumentException
+*
+* @return void
 */
 public function setPsr4($prefix, $paths)
 {
 if (!$prefix) {
 $this->fallbackDirsPsr4 = (array) $paths;
 /**
 * Turns on searching the include path for class files.
 *
 * @param bool $useIncludePath
+*
+* @return void
 */
 public function setUseIncludePath($useIncludePath)
 {
 $this->useIncludePath = $useIncludePath;
 }
 /**
 * Turns off searching the prefix and fallback directories for classes
 * that have not been registered with the class map.
 *
 * @param bool $classMapAuthoritative
+*
+* @return void
 */
 public function setClassMapAuthoritative($classMapAuthoritative)
 {
 $this->classMapAuthoritative = $classMapAuthoritative;
 }
 /**
 * APCu prefix to use to cache found/not-found classes, if the extension is enabled.
 *
 * @param string|null $apcuPrefix
+*
+* @return void
 */
 public function setApcuPrefix($apcuPrefix)
 {
-$this->apcuPrefix = function_exists('apcu_fetch') && ini_get('apc.enabled') ? $apcuPrefix : null;
+$this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null;
 }
 /**
 * The APCu prefix in use, or null if APCu caching is not enabled.
 *
 /**
 * Registers this instance as an autoloader.
 *
 * @param bool $prepend Whether to prepend the autoloader or not
+*
+* @return void
 */
 public function register($prepend = false)
 {
 spl_autoload_register(array($this, 'loadClass'), true, $prepend);
+if (null === $this->vendorDir) {
+return;
+}
+if ($prepend) {
+self::$registeredLoaders = array($this->vendorDir => $this) + self::$registeredLoaders;
+} else {
+unset(self::$registeredLoaders[$this->vendorDir]);
+self::$registeredLoaders[$this->vendorDir] = $this;
+}
 }
 /**
 * Unregisters this instance as an autoloader.
+*
+* @return void
 */
 public function unregister()
 {
 spl_autoload_unregister(array($this, 'loadClass'));
+if (null !== $this->vendorDir) {
+unset(self::$registeredLoaders[$this->vendorDir]);
+}
 }
 /**
 * Loads the given class or interface.
 *
 * @param  string    $class The name of the class
-* @return bool|null True if loaded, null otherwise
+* @return true|null True if loaded, null otherwise
 */
 public function loadClass($class)
 {
 if ($file = $this->findFile($class)) {
-includeFile($file);
+$includeFile = self::$includeFile;
+$includeFile($file);
 return true;
 }
+return null;
 }
 /**
 * Finds the path to the file where the class is defined.
 *
 }
 return $file;
 }
+/**
+* Returns the currently registered loaders keyed by their corresponding vendor directories.
+*
+* @return array<string, self>
+*/
+public static function getRegisteredLoaders()
+{
+return self::$registeredLoaders;
+}
+/**
+* @param  string       $class
+* @param  string       $ext
+* @return string|false
+*/
 private function findFileWithExtension($class, $ext)
 {
 // PSR-4 lookup
 $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
 $first = $class[0];
 if (isset($this->prefixLengthsPsr4[$first])) {
 $subPath = $class;
 while (false !== $lastPos = strrpos($subPath, '\\')) {
 $subPath = substr($subPath, 0, $lastPos);
-$search = $subPath.'\\';
+$search = $subPath . '\\';
 if (isset($this->prefixDirsPsr4[$search])) {
+$pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
 foreach ($this->prefixDirsPsr4[$search] as $dir) {
-$length = $this->prefixLengthsPsr4[$first][$search];
+if (file_exists($file = $dir . $pathEnd)) {
-if (file_exists($file = $dir . DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $length))) {
 return $file;
 }
 }
 }
 }
 return $file;
 }
 return false;
 }
+/**
+* @return void
+*/
+private static function initializeIncludeClosure()
+{
+if (self::$includeFile !== null) {
+return;
+}
+/**
+* Scope isolated include.
+*
+* Prevents access to $this/self from included files.
+*
+* @param  string $file
+* @return void
+*/
+self::$includeFile = \Closure::bind(static function($file) {
+include $file;
+}, null, null);
+}
 }
-/**
-* Scope isolated include.
-*
-* Prevents access to $this/self from included files.
-*/
-function includeFile($file)
-{
-include $file;
-}

Mercurial > hg > rc1

comparison vendor/composer/ClassLoader.php @ 43:771f6803cc4b default tip