源码分析（三）—自动加载篇（Loader的分析）

jiezi

6 年前

源码分析
自动加载
系统会调用 Loader::register() 方法注册自动加载，在这一步完成后，所有符合规范的类库（包括 Composer 依赖加载的第三方类库）都将自动加载。
系统的自动加载由下面主要部分组成：
1. 注册系统的自动加载方法 \think\Loader::autoload
2. 注册系统命名空间定义
3. 加载类库映射文件（如果存在）
4. 如果存在 Composer 安装，则注册 **Composer** 自动加载
5. 注册 extend 扩展目录
一个类库的自动加载检测顺序为：
1. 是否定义类库映射；
2. PSR- 4 自动加载检测；
3. PSR- 0 自动加载检测；
4. 可以看到，定义类库映射的方式是最高效的。
源码
/**
* 注册自动加载机制
* @access public
* @param callable $autoload 自动加载处理方法
* @return void
*/
public static function register($autoload = null)
{
// 注册系统自动加载
spl_autoload_register($autoload ?: ‘think\\Loader::autoload’, true, true);

// Composer 自动加载支持
if (is_dir(VENDOR_PATH . ‘composer’)) {
if (PHP_VERSION_ID >= 50600 && is_file(VENDOR_PATH . ‘composer’ . DS . ‘autoload_static.php’)) {
require VENDOR_PATH . ‘composer’ . DS . ‘autoload_static.php’;

$declaredClass = get_declared_classes();
$composerClass = array_pop($declaredClass);

foreach ([‘prefixLengthsPsr4’, ‘prefixDirsPsr4’, ‘fallbackDirsPsr4’, ‘prefixesPsr0’, ‘fallbackDirsPsr0’, ‘classMap’, ‘files’] as $attr) {
if (property_exists($composerClass, $attr)) {
self::${$attr} = $composerClass::${$attr};
}
}
} else {
self::registerComposerLoader();
}
}

// 注册命名空间定义
self::addNamespace([
‘think’ => LIB_PATH . ‘think’ . DS,
‘behavior’ => LIB_PATH . ‘behavior’ . DS,
‘traits’ => LIB_PATH . ‘traits’ . DS,
]);

// 加载类库映射文件
if (is_file(RUNTIME_PATH . ‘classmap’ . EXT)) {
self::addClassMap(__include_file(RUNTIME_PATH . ‘classmap’ . EXT));
}

self::loadComposerAutoloadFiles();

// 自动加载 extend 目录
self::$fallbackDirsPsr4[] = rtrim(EXTEND_PATH, DS);
}

框架自动加载

/**
* 自动加载
* @access public
* @param string $class 类名
* @return bool
*/
public static function autoload($class)
{
// 检测命名空间别名
if (!empty(self::$namespaceAlias)) {
$namespace = dirname($class);
if (isset(self::$namespaceAlias[$namespace])) {
$original = self::$namespaceAlias[$namespace] . ‘\\’ . basename($class);
if (class_exists($original)) {
return class_alias($original, $class, false);
}
}
}

if ($file = self::findFile($class)) {
// 非 Win 环境不严格区分大小写
if (!IS_WIN || pathinfo($file, PATHINFO_FILENAME) == pathinfo(realpath($file), PATHINFO_FILENAME)) {
__include_file($file);
return true;
}
}

return false;
}

检测命名空间别名
检查是否添加了命名空间别名，通过别名寻找原命名空间。如：

// 原
\App\Http\Controller\Index::class

// 添加别名后
\Controller\Index::class

thinkphp 通过 thinkLoader::addNamespaceAlias($namespace, $original) 添加命名空间别名。
// 位置在 thinkphp/library/think/Loader.php 的 260 行
/**
* 注册命名空间别名
* @access public
* @param array|string $namespace 命名空间
* @param string $original 源文件
* @return void
*/
public static function addNamespaceAlias($namespace, $original = ”)
{
if (is_array($namespace)) {
self::$namespaceAlias = array_merge(self::$namespaceAlias, $namespace);
} else {
self::$namespaceAlias[$namespace] = $original;
}
}

通过键为别名，值为原命名空间的数组，注册到 thinkLoader::$namespaceAlias 的属性。
通过 classmap，psr-4，psr- 0 查找文件

/**
* 查找文件
* @access private
* @param string $class 类名
* @return bool|string
*/
private static function findFile($class)
{
// 类库映射
if (!empty(self::$classMap[$class])) {
return self::$classMap[$class];
}

// 查找 PSR-4
$logicalPathPsr4 = strtr($class, ‘\\’, DS) . EXT;
$first = $class[0];

if (isset(self::$prefixLengthsPsr4[$first])) {
foreach (self::$prefixLengthsPsr4[$first] as $prefix => $length) {
if (0 === strpos($class, $prefix)) {
foreach (self::$prefixDirsPsr4[$prefix] as $dir) {
if (is_file($file = $dir . DS . substr($logicalPathPsr4, $length))) {
return $file;
}
}
}
}
}

// 查找 PSR-4 fallback dirs
foreach (self::$fallbackDirsPsr4 as $dir) {
if (is_file($file = $dir . DS . $logicalPathPsr4)) {
return $file;
}
}

// 查找 PSR-0
if (false !== $pos = strrpos($class, ‘\\’)) {
// namespace class name
$logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
. strtr(substr($logicalPathPsr4, $pos + 1), ‘_’, DS);
} else {
// PEAR-like class name
$logicalPathPsr0 = strtr($class, ‘_’, DS) . EXT;
}

if (isset(self::$prefixesPsr0[$first])) {
foreach (self::$prefixesPsr0[$first] as $prefix => $dirs) {
if (0 === strpos($class, $prefix)) {
foreach ($dirs as $dir) {
if (is_file($file = $dir . DS . $logicalPathPsr0)) {
return $file;
}
}
}
}
}

// 查找 PSR-0 fallback dirs
foreach (self::$fallbackDirsPsr0 as $dir) {
if (is_file($file = $dir . DS . $logicalPathPsr0)) {
return $file;
}
}

// 找不到则设置映射为 false 并返回
return self::$classMap[$class] = false;
}

thinkphp 添加的自动加载是通过 psr- 4 和 classmap 进行加载，方法分别是：thinkLoader::addClassMap($class, $map = ”) 和 thinkLoader::addNamespace($namespace, $path = ”)。
psr- 4 的加载方式是通过命名空间的首字母，查找对应的命名空间，再通过对应的命名空间拼接对应的文件目录，判断该文件是否存在，如果存在就加载文件，实现类的自动加载。
classmap 的加载方式是通过 composer du 生成对应的类映射，通过直接查找 class 对应的文件，从而实现自动加载。
其他的加载方式需要深入了解的可以自行研究代码。

/**
* 注册自动加载机制
* @access public
* @param callable $autoload 自动加载处理方法
* @return void
*/
public static function register($autoload = null)
{
….

// 注册命名空间定义
self::addNamespace([
‘think’ => LIB_PATH . ‘think’ . DS,
‘behavior’ => LIB_PATH . ‘behavior’ . DS,
‘traits’ => LIB_PATH . ‘traits’ . DS,
]);

// 加载类库映射文件
if (is_file(RUNTIME_PATH . ‘classmap’ . EXT)) {
self::addClassMap(__include_file(RUNTIME_PATH . ‘classmap’ . EXT));
}

….
}

composer 自动加载
thinkphp 中的 composer 自动加载不是通过 composer 自带的 autoload.php 进行自动加载的。是通过加载对应的 psr 文件进行注册加载的。

/**
* 注册自动加载机制
* @access public
* @param callable $autoload 自动加载处理方法
* @return void
*/
public static function register($autoload = null)
{
….

$declaredClass = get_declared_classes();
$composerClass = array_pop($declaredClass);

….
}