composer 文件。
自动加载的类型
总体来说 composer 提供了几种自动加载类型
- classmap
- psr-0
- psr-4
- files
这几种自动加载都会用到，理论上来说，项目代码用 psr-0 已经被抛弃了，不过有些历史遗留依然在用，所以偶尔也会看到。
classmap
这应该是最最简单的 autoload 模式了。大概的意思就是这样的：
{
"classmap": ["src/"]
}
然后 composer 在背后就会读取这个文件夹中所有的文件 然后再 class 的 namespace + classname 生成成一个 key => value 的 php 数组
<?php
return [
'App\\Console\\Kernel' => $baseDir . '/app/Console/Kernel.php'
];
?>
然后就可以光明正大地用 compoesr 会吭哧吭哧地去动态读取 psr-4 和 prs-0 的内容。
psr-0
现在这个标准已经过时了。当初制定这个标准的时候主要是在 php 从 5.2 刚刚跃迁到 5.3+ 有了命名空间的概念。所以这个时候 Acme_Util_ClassName 这样的写法。
{
"name": "acme/util",
"auto" : {
"psr-0": {
"Acme\\Util\\": "src/"
}
}
}
文档结构是这样的
vendor/
acme/
util/
composer.json
src/
Acme/
Util/
ClassName.php
ClassName.php 中是这样的
<?php
class Acme_Util_ClassName{}
?>
我们可以看到由于旧版本的 php 没有 namespace 所以必须通过 psr-4
psr-4
这个标准出来的时候一片喷声，大概的意思就是 psr-0 然后紧跟着进推翻了自己。不过 FIG 也有自己的苦衷，帮没有 namespace 支持的 php5.2 擦了那么久的屁股，在2014年10月21日的早晨，终于丢失了睡眠。 抛弃了 psr-0 的 composer 从此变得非常清爽。 最简单来讲就是可以把 prs-4 的 namespace 直接想想成 file structure
{
"name": "acme/util",
"auto" : {
"psr-4": {
"Acme\\Util\\": "src/"
}
}
}
vendor/
acme/
util/
composer.json
src/
ClassName.php
可以看到将 \ 所以就没有必要有 psr-0 那么深得文档结构了。
<?php
namespace Acme\Util;
class ClassName {}
?>
file
然而这还是不够。因为可能会有一些全局的 helper function 的存在。 这个写法很简单就不多看了。
{
"files": [
"path/to/file.php"
]
}
autoload_real.php
好了看了所有的 autoload 类型那么直接怒看一发实现。 首先映入眼帘的就是一坨，我的是这样的 getLoader
<?php
// autoload_real.php @generated by Composer
class ComposerAutoloaderInit64c47026c93126586e44d036738c0862
{
private static $loader;
public static function loadClassLoader($class)
{
if ('Composer\Autoload\ClassLoader' === $class) {
require __DIR__ . '/ClassLoader.php';
}
}
public static function getLoader()
{
if (null !== self::$loader) {
return self::$loader;
}
spl_autoload_register(array('ComposerAutoloaderInit64c47026c93126586e44d036738c0862', 'loadClassLoader'), true, true);
self::$loader = $loader = new \Composer\Autoload\ClassLoader();
spl_autoload_unregister(array('ComposerAutoloaderInit64c47026c93126586e44d036738c0862', 'loadClassLoader'));
$map = require __DIR__ . '/autoload_namespaces.php';
foreach ($map as $namespace => $path) {
$loader->set($namespace, $path);
}
$map = require __DIR__ . '/autoload_psr4.php';
foreach ($map as $namespace => $path) {
$loader->setPsr4($namespace, $path);
}
$classMap = require __DIR__ . '/autoload_classmap.php';
if ($classMap) {
$loader->addClassMap($classMap);
}
$loader->register(true);
$includeFiles = require __DIR__ . '/autoload_files.php';
foreach ($includeFiles as $file) {
composerRequire64c47026c93126586e44d036738c0862($file);
}
return $loader;
}
}
function composerRequire64c47026c93126586e44d036738c0862($file)
{
require $file;
}
?>
在讲什么？其实很简单。
- 找 Composer\ClassLoader 如果不存在就是生成一个实例放在
ComposerAutoloaderInit64c47026c93126586e44d036738c0862中 - 然后将 composer cli 生成的各种
autoload_psr4,autoload_classmap,autoload_namespaces(psr-0) 全都注册到 Composer\ClassLoader 中。 - 直接 require 所有在
autoload_files中的文件
其中 composerRequire64c47026c93126586e44d036738c0862 要解释下。 为什么这个不直接用 require 而是定义在了类的外边？ 调查 Composer\ClassLoader 发现了这么一个注释
Scope isolated include. Prevents access to $this/self from included files.
好吧还是怕二笔程序员犯浑。想想一下，如果有人在 autoload_files 中的文件中写了 self 那就屎了。所以当require 一个file的时候我们希望解释器能够成功报错。 不容易，终于快要胜利了。
composer dump-autoload ?
刚开始接触用 composer 的时候一直被这个问题蛊惑。很不理解为什么总是要打这句命令才能不报错，现在终于知道根结了。
database 文件夹使用 classmap 来做加载的。所以只有在打了 composer dumpautoload 之后 composer 才会更新 autoload_classmap 的内容。
composer dump-autoload ?
可以怒用 psr-4 注册一个文件夹这样增减文件就不用再管了。psr-4 去自动查找文件。
composer dump-atoload -o ?
因为 psr-4 自动加载会再背后跑一些逻辑。具体可以调查 Composer\ClassLoader 去看。
<?php
private function findFileWithExtension($class, $ext)
{
// PSR-4 lookup
$logicalPathPsr4 = strtr($class, '\\', DIRECTORY_SEPARATOR) . $ext;
$first = $class[0];
if (isset($this->prefixLengthsPsr4[$first])) {
foreach ($this->prefixLengthsPsr4[$first] as $prefix => $length) {
if (0 === strpos($class, $prefix)) {
foreach ($this->prefixDirsPsr4[$prefix] as $dir) {
if (is_file($file = $dir . DIRECTORY_SEPARATOR . substr($logicalPathPsr4, $length))) {
return $file;
}
}
}
}
}
// PSR-4 fallback dirs
foreach ($this->fallbackDirsPsr4 as $dir) {
if (is_file($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr4)) {
return $file;
}
}
// PSR-0 lookup
if (false !== $pos = strrpos($class, '\\')) {
// namespaced class name
$logicalPathPsr0 = substr($logicalPathPsr4, 0, $pos + 1)
. strtr(substr($logicalPathPsr4, $pos + 1), '_', DIRECTORY_SEPARATOR);
} else {
// PEAR-like class name
$logicalPathPsr0 = strtr($class, '_', DIRECTORY_SEPARATOR) . $ext;
}
if (isset($this->prefixesPsr0[$first])) {
foreach ($this->prefixesPsr0[$first] as $prefix => $dirs) {
if (0 === strpos($class, $prefix)) {
foreach ($dirs as $dir) {
if (is_file($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
return $file;
}
}
}
}
}
// PSR-0 fallback dirs
foreach ($this->fallbackDirsPsr0 as $dir) {
if (is_file($file = $dir . DIRECTORY_SEPARATOR . $logicalPathPsr0)) {
return $file;
}
}
// PSR-0 include paths.
if ($this->useIncludePath && $file = stream_resolve_include_path($logicalPathPsr0)) {
return $file;
}
}
?>
可以看到 psr-4 或者 psr-0 的自动加载都是一件很累人的事儿。基本是个 composer dump-autoload -o 之后，composer 就会提前加载需要的类并提前返回。这样大大减少了 IO 和深层次的 loop。
http://blog.hans-lizihan.com/php/2015/06/25/php-composer-autoload.html