composer自动加载实例分析

小云云

发布时间：2018-02-26 10:37:14

2261人浏览过

来源于php中文网

原创

通过在composer.json文件中配置需要加载的类、命名空间，通过执行composer install 命令自动生成类名和对应的类文件的映射，而后通过注册loadClass方法，实现对composer管理的诸多类的自动加载；

如何在composer.json文件中配置类和命名空间？

共有四种方式：
psr-0（网上查到的例子和psr-4没有看出太大区别，且已不推荐使用);
psr-4;
class-map;
files；
在composer.json文件中添加以下代码块：

"autoload": {
    "psr-4": {
        "src\darren\": "src/",
        "project\darren\": "project"
        },
    "files": ["common/Darren.php", "common/Since.php"],
    "classmamp": [lib]
}

测试代码目录结构如下：

common
    Darren.php
    Since.php
lib
    Darren.php
    Since.php
project
    Darren.php
src
    Darren.php
vendor
composer.json
index.php

代码中的命名空间习惯为：目录名/Darren
当我们配置好composer.json文件，并执行compoer install命令后，在vendor/composer目录下会自动生成一些php文件，这些文件实际上记录了类、命名空间和对应的类文件的映射，下面一一举例说明；

PSR-4

如上所述，通过psr-4方式配置了两个命名空间的自动加载，分别是srcdaren和projecrdarren；vendor/composer目录下自动生成了autoload_psr4.php文件，具体代码如下所示：

<?php

// autoload_psr4.php @generated by Composer

$vendorDir = dirname(dirname(__FILE__));
$baseDir = dirname($vendorDir);

return array(
'src\darren\' => array($baseDir . '/src'),
'project\darren\' => array($baseDir . '/project'),
);

Classmap方式

classmap方式只需要我们配置需要自动加载的目录，compoer会自动扫描目录下的的.php文件或.inc文件中的class，并自动生成这些类和其对应的类文件的映射关系，保存在vendor/composer目录下的autoload_classmap.php文件中，具体代码如下：

<?php

// autoload_classmap.php @generated by Composer

$vendorDir = dirname(dirname(__FILE__));
$baseDir = dirname($vendorDir);

return array(
'lib\darren\Darren' => $baseDir . '/lib/Darren.php',
'lib\since\Since' => $baseDir . '/lib/Since.php',
);

其中libdarren为命名空间，Darren为类名；

Files

files方式其实就是手动指定要加载的文件，这通常适用于一些全局的functions，可以将这些functions统一放在一个文件里，然后直接进行加载；
上述的配置文件通过files方式加载了两个文件common/Darren.php和common/Since.php，vendor/composer目录下自动生成了autoload_files.php文件，具体代码如下所示：

<?php

// autoload_files.php @generated by Composer

$vendorDir = dirname(dirname(__FILE__));
$baseDir = dirname($vendorDir);

return array(
'b704865b506bf33e8097e6f62604fc7f' => $baseDir . '/common/Darren.php',
'603921ee67f9053beb44a88f05b115d2' => $baseDir . '/common/Since.php',
);

composer是如何实现自动加载的？

配置完compoer.json文件，跑完了composer install命令，在文件的开始引用vendor/autolaod.php即可实现类的自动加载，那么composer是如何实现自动加载的呢？

这里先插叙一点php的特性：当调用不存在的类时，系统会自动调用__autoload( )方法来加载相应的类；

举例子说明如下：
我们在index.php文件中调用Darren类中的testAutoload( )方法【Darren类与index.php文件在同级目录】，这里我们没有在index.php文件中引入Darren类，那么肯定是会报错的；但是我们可以重写__autoload( )方法实现Darren类的加载，具体代码如下：

//当调用不存在的类时，系统自动调用__autolaod()查找
function __autolaod($class)
{
    $file = $class . '.php';
    if (is_file($file)) {
        require_once($file);
    }
}
Darren::testAutoload();

我们也可以通过spl_autoload_register( )方法来注册一个其它方法来替代__autoload( )；

举例如下：

function loader($class)
{
    $file = $class . '.php';
    if (is_file($file)) {
        require_once($file);
    }
}
spl_autoload_register('loader');
Darren::testAutoload();

这样，loader方法就取代了__autoload;

PatentPal专利申请写作

AI软件来为专利申请自动生成内容

下载

接下来我们继续研究composer背后的加载机制，autoload.php中引入了autoload_real.php然后调用了getLoader( )方法，getLoader( )方法具体代码如下：

public static function getLoader()
{
    if (null !== self::$loader) {
        return self::$loader;
    }

    spl_autoload_register(array('ComposerAutoloaderInit0a8197b9e4da93df051721eff8ed7b28', 'loadClassLoader'), true, true);
    self::$loader = $loader = new ComposerAutoloadClassLoader();
    spl_autoload_unregister(array('ComposerAutoloaderInit0a8197b9e4da93df051721eff8ed7b28', 'loadClassLoader'));

    $map = require __DIR__ . '/autoload_namespaces.php';
    foreach ($map as $namespace => $path) {
        $loader->set($namespace, $path);
    }

    //整理通过psr-4方式配置的类
    $map = require __DIR__ . '/autoload_psr4.php';
    foreach ($map as $namespace => $path) {
        $loader->setPsr4($namespace, $path);
    }

    //整理通过classmap方式配置的类
    $classMap = require __DIR__ . '/autoload_classmap.php';
    if ($classMap) {
        $loader->addClassMap($classMap);
    }

    //注册实现自动加载的方法
    $loader->register(true);

    //直接引入通过files配置的类
    $includeFiles = require __DIR__ . '/autoload_files.php';
    foreach ($includeFiles as $fileIdentifier => $file) {
        composerRequire0a8197b9e4da93df051721eff8ed7b28($fileIdentifier, $file);
    }

    return $loader;
}

该方法先是创建了一个ClassLoader类的对象，然后加载composer自动生成的那些记录类、命名空间与文件映射关系的文件，调用ClassLoader中的方法对这些文件整理，并将映射关系通过数组保存，数组的键为类名或者命名空间加类名，数组的值为类对应的类文件地址；这里值得注意的一点是，我们通过files配置的那些需要自动加载的类，是直接将类文件引入进来，并不是在调用时才去加载，代码如下：

function composerRequire0a8197b9e4da93df051721eff8ed7b28($fileIdentifier, $file)
{
    if (empty($GLOBALS['__composer_autoload_files'][$fileIdentifier])) {
        require $file;//直接引入类文件
        $GLOBALS['__composer_autoload_files'][$fileIdentifier] = true;
     }
}

ClassLoader类中值得注意的方法：

通过register方法注册loadClass方法，取代__autoload( )方法，实现类的加载

public function register($prepend = false)
{
    spl_autoload_register(array($this, 'loadClass'), true, $prepend);
}

loadClass方法查找类对应的文件，并引入：

public function loadClass($class)
{
    if ($file = $this->findFile($class)) {
        includeFile($file);
        return true;
    }
}

具体如何查找数组从而得到该类对应的类文件，可以通过xdebug跟一遍代码，并不难理解；