目录

  • composer
    • autoload_classmap.php
    • autoload_files.php：助手文件
    • autoload_real.php：自动加载逻辑
    • autoload_static.php：
    • autoload_psr4.php：PSR4配置文件
    • autoload_namespace.php：PSR0配置文件
    • ClassLoader.php：类加载器实现一个PSR-0、PSR-4和classmap类加载器。
  • autoload.php：入口文件，加载 autoload_real.php 文件 调用加载器 getLoader()

生命周期

  • autoload.php：入口文件，加载 autoload_real.php 文件 调用加载器 getLoader()
  • autoload_real.php getLoader() 静态方法，注册loadClassLoader用来加载初始化ClassLoader类
  • 判断是否支持静态初始化（静态初始化只支持 PHP5.6 以上版本并且不支持 HHVM 虚拟机）
    这一过程主要将缓存的文件加载进程序，赋值给ClassLoader的属性
    • 支持静态初始化 加载autoload_static.php 文件
    • 不支持
      • 加载 autoload_namespaces.php
      • 加载 autoload_psr4.php’
      • 加载 autoload_classmap.php
  • 将 ClassLoader::loadClass注册为自动加载函数
  • 加载 autoload_files.php 助手文件

类的加载

类的加载调用ClassLoader::loadClass文件，顺序如下

  • 调用 findFile 查找具体文件

    • 在 classMap 数组中查找类 找到返回
    • 如果使用 composer —class-authorizative 或者 该类被标记为missing 返回false
    • 如果开启了 apcu扩展，在apcu扩展中查找

    • 在系统文件中查找（通过类名和后缀） ```php /**

      • 在文件系统中查找类
      • @param string $class 要查找的类
      • @param string $ext 后缀

      • @return bool|false|string / private function findFileWithExtension($class, $ext) { /*

        • PSR-4 lookup

        • 在符合 PSR-4 规范的集合中查找 */ // $class = App\Http\Controllers\Home\HomeController // $ext = .php // $logicalPathPsr4 = App/Http/Controllers/Home/HomeController.php $logicalPathPsr4 = strtr($class, ‘\‘, DIRECTORY_SEPARATOR) . $ext;

          $first = $class[0];// A // 查找前缀数组 // $first = A if (isset($this->prefixLengthsPsr4[$first])) { // $subPath = App\Http\Controllers\Home\HomeController $subPath = $class; // 循环逐级向上查找 // 第一次循环 $lastPos = 25 $subPath = App\Http\Controllers\Home $search = App\Http\Controllers\Home\ // 第二次循环 $lastPos = 20 $subPath = App\Http\Controllers $search = App\Http\Controllers\ // 第三次循环 $lastPos = 8 $subPath = App\Http $search = App\Http\ // 第四次循环 $lastPos = 3 $subPath = App $search = App\ // 查找到App\返回文件地址 $pathEnd = /Http/Controllers/Home/HomeController.php // $logicalPathPsr4 = App/Http/Controllers/Home/HomeController.php

          while (false !== $lastPos = strrpos($subPath, ‘\‘)) {

          1.  $subPath = substr($subPath, 0, $lastPos);
          2.  $search = $subPath . '\\';// Illuminate\Foundation\
          3.  if (isset($this->prefixDirsPsr4[$search])) { // 在Psr-4 前缀目录 对应数组中查找
          4.      $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
          5.      // 在系统目录中查找文件，查找到返回
          6.      foreach ($this->prefixDirsPsr4[$search] as $dir) {
          7.          if (file_exists($file = $dir . $pathEnd)) {
          8.              return $file;
          9.          }
          10.      }
          11.  }

          } }

          // PSR-4 fallback dirs // 在fallbackDirsPsr4中查找文件 foreach ($this->fallbackDirsPsr4 as $dir) { if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {

          1.  return $file;

          } }

  1.     /**
  2.      * 在符合 PSR-0 规范的集合中查找
  3.      * PSR-0 lookup
  4.      *
  5.      */
  6.     // 如果包含命名空间
  7.     if (false !== $pos = strrpos($class, '\\')) {
  8.         // namespaced class name
  9.         // 获取符合psr0规范的类名，包含命名空间
  10.         // Dir1\Dir2\Dir3_ClassName1  ---> Dir1\Dir2/ClassName1
  11.         $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
  12.             . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
  13.     } else {
  14.         // PEAR-like class name
  15.         // PEAR的风格类
  16.         // Dir1_Dir2_ClassName1 --->Dir1/Dir2/ClassName1
  17.         $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
  18.     }
  20.     if (isset($this->prefixesPsr0[$first])) {
  21.         foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
  22.             if (0 === strpos($class, $prefix)) {
  23.                 foreach ($dirs as $dir) {
  24.                     if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
  25.                         return $file;
  26.                     }
  27.                 }
  28.             }
  29.         }
  30.     }
  32.     // PSR-0 fallback dirs
  33.     foreach ($this->fallbackDirsPsr0 as $dir) {
  34.         if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
  35.             return $file;
  36.         }
  37.     }
  39.     // PSR-0 include paths.
  40.     if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
  41.         return $file;
  42.     }
  44.     return false;
  45. }

}

  2.    - 如果开启了HHVM 在hack文件中搜索
  3.    - 开启 apcu 扩展，缓存查找目标信息
  4.    - 没有找到 标记missing
  5. - 调用外部函数 includeFile 加载找到的文件
  7. <a name="5b804b05"></a>
  8. ### 源码
  10. <a name="composer_real.php"></a>
  11. #### composer_real.php
  13. ```php
  14. <?php
  16. // autoload_real.php @generated by Composer
  18. class ComposerAutoloaderInite1402bdd050981d44622d2e1c72145b4
  19. {
  20.     private static $loader;
  22.     /**
  23.      * 加载 ClassLoader.php
  24.      * @param string $class 类名
  25.      */
  26.     public static function loadClassLoader($class)
  27.     {
  28.         if ('Composer\Autoload\ClassLoader' === $class) {
  29.             // 如若是 Composer\Autoload\ClassLoader 类，包含当前目录下的ClassLoader
  30.             require __DIR__ . '/ClassLoader.php';
  31.         }
  32.     }
  34.     // 注册加载器
  35.     public static function getLoader()
  36.     {
  37.         if (null !== self::$loader) {
  38.             return self::$loader;
  39.         }
  41.         // 注册self::loadClassLoader为自动加载函数，用来加载 ClassLoader
  42.         spl_autoload_register(array('ComposerAutoloaderInite1402bdd050981d44622d2e1c72145b4', 'loadClassLoader'), true, true);
  43.         // 实例话ClassLoader
  44.         self::$loader = $loader = new \Composer\Autoload\ClassLoader();
  45.         // 注销 self::loadClassLoader 为自动加载函数
  46.         spl_autoload_unregister(array('ComposerAutoloaderInite1402bdd050981d44622d2e1c72145b4', 'loadClassLoader'));
  47.         /**
  48.          * 初始化 自动加载核心对象
  49.          * 声明静态加载器：静态初始化只支持 PHP5.6 以上版本并且不支持 HHVM 虚拟机（Facebook 的一个为php提高性能的一个开源项目）
  50.          * PHP_VERSION_ID：70322
  51.          * defined('HHVM_VERSION')：false
  52.          * zend_loader_file_encoded：如果当前文件是Zend编码的文件，则返回true。
  53.          */
  54.         $useStaticLoader = PHP_VERSION_ID >= 50600 && !defined('HHVM_VERSION') && (!function_exists('zend_loader_file_encoded') || !zend_loader_file_encoded());
  55.         if ($useStaticLoader) {
  56.             // 支持静态加载，加载 autoload_static 文件
  57.             require_once __DIR__ . '/autoload_static.php';
  58.             // 调用匿名函数 实现静态加载（实际对加载器$loader属性赋值）
  59.             call_user_func(\Composer\Autoload\ComposerStaticInite1402bdd050981d44622d2e1c72145b4::getInitializer($loader));
  60.         } else {
  61.             // 不支持静态加载，加载 autoload_namespaces 文件，使用命名空间
  62.             $map = require __DIR__ . '/autoload_namespaces.php';
  63.             // 遍历文件 设置 prefixesPsr0
  64.             foreach ($map as $namespace => $path) {
  65.                 $loader->set($namespace, $path);
  66.             }
  67.             // 加载 autoload_psr4.php
  68.             $map = require __DIR__ . '/autoload_psr4.php';
  69.             // 遍历文件 设置 prefixLengthsPsr4 prefixDirsPsr4
  70.             foreach ($map as $namespace => $path) {
  71.                 $loader->setPsr4($namespace, $path);
  72.             }
  73.             // 加载 autoload_classmap.php
  74.             $classMap = require __DIR__ . '/autoload_classmap.php';
  75.             // 配置存在 设置 classMap
  76.             if ($classMap) {
  77.                 $loader->addClassMap($classMap);
  78.             }
  79.         }
  81.         $loader->register(true);
  83.         if ($useStaticLoader) {
  84.             $includeFiles = Composer\Autoload\ComposerStaticInite1402bdd050981d44622d2e1c72145b4::$files;
  85.         } else {
  86.             $includeFiles = require __DIR__ . '/autoload_files.php';
  87.         }
  88.         foreach ($includeFiles as $fileIdentifier => $file) {
  89.             composerRequiree1402bdd050981d44622d2e1c72145b4($fileIdentifier, $file);
  90.         }
  92.         return $loader;
  93.     }
  94. }
  96. function composerRequiree1402bdd050981d44622d2e1c72145b4($fileIdentifier, $file)
  97. {
  98.     if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) {
  99.         require $file;
  101.         $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true;
  102.     }
  103. }

ClassLoader.php

  1. <?php
  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.  */
  13. namespace Composer\Autoload;
  15. /**
  16.  * ClassLoader implements a PSR-0, PSR-4 and classmap class loader.
  17.  * 类加载器实现一个PSR-0、PSR-4和classmap类加载器。
  18.  *     $loader = new \Composer\Autoload\ClassLoader();
  19.  *
  20.  *     // register classes with namespaces
  21.  *     // 通过命名空间注册类  使用add()方法
  22.  *     $loader->add('Symfony\Component', __DIR__.'/component');
  23.  *     $loader->add('Symfony',           __DIR__.'/framework');
  24.  *
  25.  *     // activate the autoloader
  26.  *     // 启动自动加载器 使用register()
  27.  *     $loader->register();
  28.  *
  29.  *     // to enable searching the include path (eg. for PEAR packages)
  30.  *     // 启用对include路径的搜索（例如PEAR包）
  31.  *     $loader->setUseIncludePath(true);
  32.  *
  33.  * In this example,
  34.  * if you try to use a class in the Symfony\Component namespace or one of its children
  35.  * (Symfony\Component\Console for instance),
  36.  * the autoloader will first look for the class under the component/ directory,
  37.  * and it will then fallback to the framework/ directory
  38.  * if not found before giving up.
  39.  * 在本例中，如果您尝试使用Symfony\Component命名空间中的某个类或其子级之一
  40.  * （例如Symfony\Component\Console），
  41.  * 则autoloader将首先在Component/目录下查找该类，如果找不到该类，则会在放弃之前回退到framework/目录。
  42.  *
  43.  * This class is loosely based on the Symfony UniversalClassLoader.
  44.  * 这个类松散地（不精确的）基于Symfony UniversalClassLoader。
  45.  *
  46.  * @author Fabien Potencier <fabien@symfony.com>
  47.  * @author Jordi Boggiano <j.boggiano@seld.be>
  48.  * @see    http://www.php-fig.org/psr/psr-0/
  49.  * @see    http://www.php-fig.org/psr/psr-4/
  50.  */
  51. class ClassLoader
  52. {
  53.     // PSR-4
  54.     /**
  55.      * PSR-4 前缀-长度 数组
  56.      * @var array
  57.      *  ['p'] => array(
  58.      *      ['phpDocumentor\Reflection\'] => 25
  59.      *  ),
  60.      * ['X'] => array(
  61.      *      ['XdgBaseDir\'] => 11
  62.      * ),
  63.      */
  64.     private $prefixLengthsPsr4 = array();// PSR-4 前缀-长度
  65.     /**
  66.      * PSR-4 前缀-目录
  67.      * @var array
  68.      * 'phpDocumentor\Reflection\'=>[
  69.      *      '/Users/sun/code/php/laravel/blog/vendor/composer/../phpdocumentor/reflection-common/src',
  70.      *      '/Users/sun/code/php/laravel/blog/vendor/composer/../phpdocumentor/reflection-docblock/src',
  71.      *      '/Users/sun/code/php/laravel/blog/vendor/composer/../phpdocumentor/type-resolver/src'
  72.      * ]
  73.      * 'XdgBaseDir\'=>[
  74.      *      '/Users/sun/code/php/laravel/blog/vendor/composer/../dnoegel/php-xdg-base-dir/src'
  75.      * ]
  76.      */
  77.     private $prefixDirsPsr4 = array(); // PSR-4 前缀目录
  78.     private $fallbackDirsPsr4 = array(); // PSR-4 回退目录
  80.     // PSR-0
  81.     /**
  82.      * @var array
  83.      * 'M'=>[
  84.      *      'Mockery'=>'/Users/sun/code/php/laravel/blog/vendor/composer/../mockery/mockery/library'
  85.      *  ]
  86.      */
  87.     private $prefixesPsr0 = array();
  88.     private $fallbackDirsPsr0 = array();
  90.     private $useIncludePath = false; // 对include路径的搜索（例如PEAR包）
  91.     /**
  92.      * class 对应路径
  93.      * @var array
  94.      * 'phpDocumentor\Reflection\Utils'=>'/Users/sun/code/php/laravel/blog/vendor/composer/../phpdocumentor/reflection-docblock/src/Utils.php'
  95.      */
  96.     private $classMap = array();
  97.     private $classMapAuthoritative = false;
  98.     private $missingClasses = array();
  99.     private $apcuPrefix; // apcu 缓存前缀 null
  101.     /**
  102.      * 获取prefixesPsr0数组
  103.      * @return array|mixed
  104.      */
  105.     public function getPrefixes()
  106.     {
  107.         /**
  108.          * 如果 PSR-0 数组不为空，合并 PSR-0 数组，并返回
  109.          */
  110.         if (!empty($this->prefixesPsr0)) {
  111.             // 调用回调函数，并把一个数组参数作为回调函数的参数
  112.             // 作用：数组降低维度，二维降到一维数组
  113.             return call_user_func_array('array_merge', $this->prefixesPsr0);
  114.         }
  116.         return array();
  117.     }
  119.     /**
  120.      * 返回 prefixDirsPsr4
  121.      * @return array
  122.      */
  123.     public function getPrefixesPsr4()
  124.     {
  125.         return $this->prefixDirsPsr4;
  126.     }
  128.     /**
  129.      * 获取 PSR-0 回退目录数组
  130.      * @return array
  131.      */
  132.     public function getFallbackDirs()
  133.     {
  134.         return $this->fallbackDirsPsr0;
  135.     }
  137.     /**
  138.      * 获取 PSR-4 回退目录数组
  139.      * @return array
  140.      */
  141.     public function getFallbackDirsPsr4()
  142.     {
  143.         return $this->fallbackDirsPsr4;
  144.     }
  146.     /**
  147.      * 获取 class Map
  148.      * @return array
  149.      */
  150.     public function getClassMap()
  151.     {
  152.         return $this->classMap;
  153.     }
  155.     /**
  156.      * 添加 class Map
  157.      * 如果存在，追加
  158.      * @param array $classMap Class to filename map
  159.      */
  160.     public function addClassMap(array $classMap)
  161.     {
  162.         if ($this->classMap) {
  163.             $this->classMap = array_merge($this->classMap, $classMap);
  164.         } else {
  165.             $this->classMap = $classMap;
  166.         }
  167.     }
  169.     /**
  170.      * 为一个给定的前缀注册一组PSR-0目录，可以将其附加到先前为此前缀设置的目录的前面或后面。
  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.      * 如果 $prefix 存在，$path 添加到prefixesPsr0中，否则添加到fallbackDirsPsr0中
  174.      *
  175.      * @param string       $prefix  The prefix 前缀
  176.      * @param array|string $paths   The PSR-0 root directories PSR-0根目录
  177.      * @param bool         $prepend Whether to prepend the directories 是否在目录前
  178.      */
  179.     public function add($prefix, $paths, $prepend = false)
  180.     {
  181.         // 不存在前缀
  182.         if (!$prefix) {
  183.             // 是否添加到 Psr0回退目录 目录前
  184.             if ($prepend) {
  185.                 // 添加到 Psr0回退目录 目录前
  186.                 $this->fallbackDirsPsr0 = array_merge(
  187.                     (array) $paths,
  188.                     $this->fallbackDirsPsr0
  189.                 );
  190.             } else {
  191.                 // 添加到 Psr0回退目录 目录后
  192.                 $this->fallbackDirsPsr0 = array_merge(
  193.                     $this->fallbackDirsPsr0,
  194.                     (array) $paths
  195.                 );
  196.             }
  198.             return;
  199.         }
  201.         // 存在前缀
  202.         $first = $prefix[0];
  203.         // psr0 前缀数组中 不存在但前前缀
  204.         if (!isset($this->prefixesPsr0[$first][$prefix])) {
  205.             $this->prefixesPsr0[$first][$prefix] = (array) $paths;
  207.             return;
  208.         }
  209.         // 按照 前置判断 合并前缀数组
  210.         if ($prepend) {
  211.             $this->prefixesPsr0[$first][$prefix] = array_merge(
  212.                 (array) $paths,
  213.                 $this->prefixesPsr0[$first][$prefix]
  214.             );
  215.         } else {
  216.             $this->prefixesPsr0[$first][$prefix] = array_merge(
  217.                 $this->prefixesPsr0[$first][$prefix],
  218.                 (array) $paths
  219.             );
  220.         }
  221.     }
  223.     /**
  224.      * 为给定的命名空间注册一组PSR-4目录，可以将其附加到先前为此命名空间设置的目录之前。
  225.      * Registers a set of PSR-4 directories for a given namespace, either
  226.      * appending or prepending to the ones previously set for this namespace.
  227.      * 如果 $prefix 存在，
  228.      *      prefixDirsPsr4 存在 $path 更新到prefixesPsr4中，
  229.      *      prefixDirsPsr4 不存在 $path 添加到prefixesPsr4中，并设置prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
  230.      * 如果 $prefix 不存在，添加到fallbackDirsPsr4中
  231.      *
  232.      * @param string       $prefix  The prefix/namespace, with trailing '\\'  前缀/命名空间，以\\结尾
  233.      * @param array|string $paths   The PSR-4 base directories
  234.      * @param bool         $prepend Whether to prepend the directories
  235.      *
  236.      * @throws \InvalidArgumentException
  237.      */
  238.     public function addPsr4($prefix, $paths, $prepend = false)
  239.     {
  240.         if (!$prefix) {
  241.             // Register directories for the root namespace.
  242.             if ($prepend) {
  243.                 $this->fallbackDirsPsr4 = array_merge(
  244.                     (array) $paths,
  245.                     $this->fallbackDirsPsr4
  246.                 );
  247.             } else {
  248.                 $this->fallbackDirsPsr4 = array_merge(
  249.                     $this->fallbackDirsPsr4,
  250.                     (array) $paths
  251.                 );
  252.             }
  253.         } elseif (!isset($this->prefixDirsPsr4[$prefix])) {
  254.             // Register directories for a new namespace.
  255.             $length = strlen($prefix);
  256.             if ('\\' !== $prefix[$length - 1]) {
  257.                 throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
  258.             }
  259.             $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
  260.             $this->prefixDirsPsr4[$prefix] = (array) $paths;
  261.         } elseif ($prepend) {
  262.             // Prepend directories for an already registered namespace.
  263.             $this->prefixDirsPsr4[$prefix] = array_merge(
  264.                 (array) $paths,
  265.                 $this->prefixDirsPsr4[$prefix]
  266.             );
  267.         } else {
  268.             // Append directories for an already registered namespace.
  269.             $this->prefixDirsPsr4[$prefix] = array_merge(
  270.                 $this->prefixDirsPsr4[$prefix],
  271.                 (array) $paths
  272.             );
  273.         }
  274.     }
  276.     /**
  277.      * 为给定前缀注册一组PSR-0目录，替换先前为此前缀设置的任何其他目录。
  278.      * Registers a set of PSR-0 directories for a given prefix,
  279.      * replacing any others previously set for this prefix.
  280.      *
  281.      * @param string       $prefix The prefix
  282.      * @param array|string $paths  The PSR-0 base directories
  283.      */
  284.     public function set($prefix, $paths)
  285.     {
  286.         if (!$prefix) {
  287.             $this->fallbackDirsPsr0 = (array) $paths;
  288.         } else {
  289.             $this->prefixesPsr0[$prefix[0]][$prefix] = (array) $paths;
  290.         }
  291.     }
  293.     /**
  294.      * 为给定名称空间注册一组PSR-4目录，替换先前为此命名空间设置的任何其他项。
  295.      * Registers a set of PSR-4 directories for a given namespace,
  296.      * replacing any others previously set for this namespace.
  297.      *
  298.      * @param string       $prefix The prefix/namespace, with trailing '\\'
  299.      * @param array|string $paths  The PSR-4 base directories
  300.      *
  301.      * @throws \InvalidArgumentException
  302.      */
  303.     public function setPsr4($prefix, $paths)
  304.     {
  305.         if (!$prefix) {
  306.             $this->fallbackDirsPsr4 = (array) $paths;
  307.         } else {
  308.             $length = strlen($prefix);
  309.             if ('\\' !== $prefix[$length - 1]) {
  310.                 // 非空的PSR-4前缀必须以命名空间分隔符结尾。
  311.                 throw new \InvalidArgumentException("A non-empty PSR-4 prefix must end with a namespace separator.");
  312.             }
  313.             $this->prefixLengthsPsr4[$prefix[0]][$prefix] = $length;
  314.             $this->prefixDirsPsr4[$prefix] = (array) $paths;
  315.         }
  316.     }
  318.     /**
  319.      * 启用对类文件的包含路径的搜索
  320.      * Turns on searching the include path for class files.
  321.      *
  322.      * @param bool $useIncludePath
  323.      */
  324.     public function setUseIncludePath($useIncludePath)
  325.     {
  326.         $this->useIncludePath = $useIncludePath;
  327.     }
  329.     /**
  330.      * 可用于检查autoloader是否使用include路径检查类
  331.      * Can be used to check if the autoloader uses the include path to check for classes.
  332.      *
  333.      * @return bool
  334.      */
  335.     public function getUseIncludePath()
  336.     {
  337.         return $this->useIncludePath;
  338.     }
  340.     /**
  341.      * 关闭在前缀和回退目录中搜索尚未在类映射中注册的类
  342.      * Turns off searching the prefix and fallback directories for classes
  343.      * that have not been registered with the class map.
  344.      *
  345.      * @param bool $classMapAuthoritative
  346.      */
  347.     public function setClassMapAuthoritative($classMapAuthoritative)
  348.     {
  349.         $this->classMapAuthoritative = $classMapAuthoritative;
  350.     }
  352.     /**
  353.      * 如果在当前的类映射中找不到类，是否应该失败？
  354.      * Should class lookup fail if not found in the current class map?
  355.      *
  356.      * @return bool
  357.      */
  358.     public function isClassMapAuthoritative()
  359.     {
  360.         return $this->classMapAuthoritative;
  361.     }
  363.     /**
  364.      * APCu前缀，用于缓存已找到/未找到的类（如果已启用扩展）。
  365.      * APCu prefix to use to cache found/not-found classes, if the extension is enabled.
  366.      *
  367.      * @param string|null $apcuPrefix
  368.      */
  369.     public function setApcuPrefix($apcuPrefix)
  370.     {
  371.         /**
  372.          * apcu_fetch：从缓存中提取变量
  373.          * filter_var：函数通过指定的过滤器过滤一个变量。
  374.          * ini_get()：获取配置信息
  375.          * FILTER_VAILIDATE：如果是 “1”, “true”, “on” 以及 “yes”，则返回 true，如果是 “0”, “false”, “off”, “no” 以及 “”，则返回 false。否则返回 NULL。
  376.          *
  377.          * 判断是否开启APC User Cache，没有开启设置null，开启设置传递的值
  378.          */
  379.         $this->apcuPrefix = function_exists('apcu_fetch') && filter_var(ini_get('apc.enabled'), FILTER_VALIDATE_BOOLEAN) ? $apcuPrefix : null;
  380.     }
  382.     /**
  383.      * 获取正在使用的APCu前缀，如果未启用APCu缓存，则为null。
  384.      * The APCu prefix in use, or null if APCu caching is not enabled.
  385.      *
  386.      * @return string|null
  387.      */
  388.     public function getApcuPrefix()
  389.     {
  390.         return $this->apcuPrefix;
  391.     }
  393.     /**
  394.      * 将此实例注册为自动加载程序
  395.      * Registers this instance as an autoloader.
  396.      *
  397.      * @param bool $prepend Whether to prepend the autoloader or not
  398.      * 如果 $prepend 为true，则spl_autoload_register（）将在自动加载堆栈上预加autoloader，而不是追加它。
  399.      */
  400.     public function register($prepend = false)
  401.     {
  402.         spl_autoload_register(array($this, 'loadClass'), true, $prepend);
  403.     }
  405.     /**
  406.      * Unregisters this instance as an autoloader
  407.      * 将此实例注销为自动加载程序
  408.      */
  409.     public function unregister()
  410.     {
  411.         spl_autoload_unregister(array($this, 'loadClass'));
  412.     }
  414.     /**
  415.      * 加载给定的类或接口。（spl_autoload_register注册的方法）
  416.      * Loads the given class or interface.
  417.      * 不存在不处理
  418.      * @param  string    $class The name of the class 类名
  419.      * @return bool|null True if loaded, null otherwise
  420.      */
  421.     public function loadClass($class)
  422.     {
  423.         if ($file = $this->findFile($class)) {
  424.             includeFile($file);
  426.             return true;
  427.         }
  428.     }
  430.     /**
  431.      * 查找定义类的文件的路径
  432.      * Finds the path to the file where the class is defined.
  433.      *
  434.      * @param string $class The name of the class
  435.      *
  436.      * @return string|false The path if found, false otherwise
  437.      */
  438.     public function findFile($class)
  439.     {
  440.         // class map lookup
  441.         // 将 PSR-4/PSR-0 的规则转化为了 classmap 的规则，在classMap中查找类
  442.         if (isset($this->classMap[$class])) {
  443.             return $this->classMap[$class];
  444.         }
  445.         // composer 配置 --class-authorizative。在classMap查找不到的时候，认为为非法类，不在检索文件系统
  446.         // 已经被记录过一次的不存在的类，返回false
  447.         if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) {
  448.             return false;
  449.         }
  450.         // 如果开启扩展 apcu ，在apcu中查找类
  451.         //  classmap 中找不到目标类时，将在文件系统中找到的结果存储到共享内存中， 当下次再查找时就可以从内存中直接返回，不用再去文件系统中再次查找。
  452.         if (null !== $this->apcuPrefix) {
  453.             $file = apcu_fetch($this->apcuPrefix.$class, $hit);
  454.             if ($hit) {
  455.                 return $file;
  456.             }
  457.         }
  459.         // 在文件系统中查找类
  460.         $file = $this->findFileWithExtension($class, '.php');
  462.         // Search for Hack files if we are running on HHVM
  463.         // 如果我们在HHVM上运行，请搜索Hack文件
  464.         if (false === $file && defined('HHVM_VERSION')) {
  465.             $file = $this->findFileWithExtension($class, '.hh');
  466.         }
  468.         //  classmap 中找不到目标类时，将在文件系统中找到的结果存储到共享内存中， 当下次再查找时就可以从内存中直接返回，不用再去文件系统中再次查找。
  469.         if (null !== $this->apcuPrefix) {
  470.             // 仅当变量尚未存储时，才在数据存储中缓存该变量
  471.             apcu_add($this->apcuPrefix.$class, $file);
  472.         }
  474.         // 记住这个类不存在
  475.         if (false === $file) {
  476.             // Remember that this class does not exist.
  477.             $this->missingClasses[$class] = true;
  478.         }
  480.         return $file;
  481.     }
  483.     /**
  484.      * 在文件系统中查找类
  485.      * @param string $class 要查找的类
  486.      * @param string $ext 后缀
  487.      * @return bool|false|string
  488.      */
  489.     private function findFileWithExtension($class, $ext)
  490.     {
  491.         /**
  492.          * PSR-4 lookup
  493.          * 在符合 PSR-4 规范的集合中查找
  494.          */
  495.         // $class = App\Http\Controllers\Home\HomeController
  496.         // $ext = .php
  497.         // $logicalPathPsr4 = App/Http/Controllers/Home/HomeController.php
  498.         $logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
  500.         $first = $class[0];// A
  501.         // 查找前缀数组
  502.         // $first = A
  503.         if (isset($this->prefixLengthsPsr4[$first])) {
  504.             // $subPath =  App\Http\Controllers\Home\HomeController
  505.             $subPath = $class;
  506.             // 循环逐级向上查找
  507.             // 第一次循环  $lastPos = 25 $subPath = App\Http\Controllers\Home $search = App\Http\Controllers\Home\
  508.             // 第二次循环  $lastPos = 20 $subPath = App\Http\Controllers      $search = App\Http\Controllers\
  509.             // 第三次循环  $lastPos = 8  $subPath = App\Http                  $search = App\Http\
  510.             // 第四次循环  $lastPos = 3 $subPath = App                       $search = App\
  511.             // 查找到App\返回文件地址 $pathEnd = /Http/Controllers/Home/HomeController.php
  512.             //                     $logicalPathPsr4 = App/Http/Controllers/Home/HomeController.php
  514.             while (false !== $lastPos = strrpos($subPath, '\\')) {
  515.                 $subPath = substr($subPath, 0, $lastPos);
  516.                 $search = $subPath . '\\';// Illuminate\Foundation\
  517.                 if (isset($this->prefixDirsPsr4[$search])) { // 在Psr-4 前缀目录 对应数组中查找
  518.                     $pathEnd = DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $lastPos + 1);
  519.                     // 在系统目录中查找文件，查找到返回
  520.                     foreach ($this->prefixDirsPsr4[$search] as $dir) {
  521.                         if (file_exists($file = $dir . $pathEnd)) {
  522.                             return $file;
  523.                         }
  524.                     }
  525.                 }
  526.             }
  527.         }
  529.         // PSR-4 fallback dirs
  530.         // 在fallbackDirsPsr4中查找文件
  531.         foreach ($this->fallbackDirsPsr4 as $dir) {
  532.             if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
  533.                 return $file;
  534.             }
  535.         }
  538.         /**
  539.          * 在符合 PSR-0 规范的集合中查找
  540.          * PSR-0 lookup
  541.          *
  542.          */
  543.         // 如果包含命名空间
  544.         if (false !== $pos = strrpos($class, '\\')) {
  545.             // namespaced class name
  546.             // 获取符合psr0规范的类名，包含命名空间
  547.             // Dir1\Dir2\Dir3_ClassName1  ---> Dir1\Dir2/ClassName1
  548.             $logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
  549.                 . strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
  550.         } else {
  551.             // PEAR-like class name
  552.             // PEAR的风格类
  553.             // Dir1_Dir2_ClassName1 --->Dir1/Dir2/ClassName1
  554.             $logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
  555.         }
  557.         if (isset($this->prefixesPsr0[$first])) {
  558.             foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
  559.                 if (0 === strpos($class, $prefix)) {
  560.                     foreach ($dirs as $dir) {
  561.                         if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
  562.                             return $file;
  563.                         }
  564.                     }
  565.                 }
  566.             }
  567.         }
  569.         // PSR-0 fallback dirs
  570.         foreach ($this->fallbackDirsPsr0 as $dir) {
  571.             if (file_exists($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
  572.                 return $file;
  573.             }
  574.         }
  576.         // PSR-0 include paths.
  577.         if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
  578.             return $file;
  579.         }
  581.         return false;
  582.     }
  583. }
  585. /**
  586.  * Scope isolated include.
  587.  * 范围隔离包括（单独函数，非类方法）
  588.  * Prevents access to $this/self from included files.
  589.  * 阻止从包含的文件访问$this/self。
  590.  */
  591. function includeFile($file)
  592. {
  593.     include $file;
  594. }