composer 自动载入的四种方式
对于第三方包的自动加载,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
更新自动加载,更新执行composer dump-autoload。照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
更新自动加载,更新执行composer dump-autoload。注意,照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 dump-autoload。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
更新自动加载,更新执行composer dump-autoload。Files方式,就是手动指定供直接加载的文件。比如说我们有一系列全局的helper functions,可以放到一个helper文件里然后直接进行加载,也就是说,当你用require 'vendor/autoload.php';
加载自动加载类时自动将files里的文件加载进来了,你直接使用就行了。