composer 自动载入的四种方式

Composer 是PHP的一个包依赖管理工具，类似Ruby中的RubyGems或者Node中的NPM，它并非官方，但现在已经非常流行。此文并不介绍如何使用Composer，而是关注于它的autoload的内容吧。

对于第三方包的自动加载，Composer提供了四种方式的支持，分别是 PSR-0和PSR-4的自动加载，生成class-map，和直接包含files的方式。

首先引入autoload.php，在主文件 index.php 中。

require 'vendor/autoload.php';

PSR-4（推荐）

在composer.json里是这样进行配置的：

{
  "autoload": {
    "psr-4": {
      "Foo\\": "src/"
    }
  }
}

执行composer install更新自动加载。照PSR-4的规则，当在index.php中试图new Foo\Bar\Baz这个class时，composer会自动去寻找 "src/Bar/Baz.php" 这个文件，如果它存在则进行加载。

PSR-0（不推荐）

在composer.json里是这样进行配置的：

{
  "autoload": {
    "psr-0": {
      "Foo\\": "src/"
    }
  }
}

执行composer install更新自动加载。注意，照PSR-0的规则，当在index.php中试图new Foo\Bar\Baz这个class时，composer会去寻找 "src/Foo/Bar/Baz.php" 这个文件，如果它存在则进行加载。

NOTE:另外注意PSR-4和PSR-0的配置里，"Foo\"结尾的命名空间分隔符必须加上并且进行转义，以防出现"Foo"匹配到了"FooBar"这样的意外发生。

Class-map方式

{
  "autoload": {
    "classmap": ["src/", "lib/", "Something.php"]
  }
}

执行composer install更新自动加载。composer会扫描指定目录下以.php 或.inc 结尾的文件中的 class，生成 class 到指定 file path 的映射，并加入新生成的vendor/composer/autoload_classmap.php 文件中。 例如src/下有一个BaseController类，那么在autoload_classmap.php文件中，就会生成这样的配置:

'BaseController' => $baseDir . '/src/BaseController.php'

实例化类的方式这里有两种不同的情况。

• 如果加载的文件有命名空间，直接按命名空间实例化。
• 如果没有命名空间，直接按类名实例化。

Files方式

{
  "autoload": {
    "files": ["src/MyLibrary/functions.php"]
  }
}

执行composer install更新自动加载。Files方式，就是手动指定供直接加载的文件。比如说我们有一系列全局的helper functions，可以放到一个helper文件里然后直接进行加载，也就是说，当你用require 'vendor/autoload.php';加载自动加载类时自动将files里的文件加载进来了，你直接使用就行了。