百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 热门文章 > 正文

深入解读PHP包管理器Composer实现原理

bigegpt 2024-10-04 14:06 43 浏览



Composer是用PHP开发的用来管理项目依赖的工具,当你在项目中声明了依赖关系后,composer可以自动帮你下载和安装这些依赖库,并实现自动加载代码。

定义一个composer.json:

{
	"name": "gitlib/composer",
	"require":{
		"predis/predis":"1.1.1"
	}
}

输入命令 composer install,composer会帮我们自动下载predis库,依赖库会默认放在项目的vendor目录下。

├── composer.json
├── composer.lock
├── index.php
└── vendor
 ├── autoload.php
 ├── composer
 │ ├── ClassLoader.php
 │ ├── LICENSE
 │ ├── autoload_classmap.php
 │ ├── autoload_namespaces.php
 │ ├── autoload_psr4.php
 │ ├── autoload_real.php
 │ ├── autoload_static.php
 │ └── installed.json
 └── predis
 └── predis

composer不仅仅帮我们处理依赖,还帮我们实现了自动加载。在vendor目录下有一个autoload.php, 只要在我们的项目中引入这个文件就可以自动加载依赖库。

<?php
require 'vendor/autoload.php';
$client = new Predis\Client();
$client->set('foo', 'bar');
$value = $client->get('foo');
echo $value;

可以看到Predis库完全不需要我们手动去加载,只需要require 'vendor/autoload.php',composer的自动加载机制会帮我们找到对应的文件并加载。

对于依赖库,composer帮我们处理好了自动加载, 那对于其他的类库,如何实现自动加载呢?

composer支持四种自动加载的方式:Files/Classmap/PSR-0/ PSR-4, 其中PSR-4是当前推荐的加载方式。

Files

Files 是最简单的加载方式,这种方式不管加载的文件是否用到始终都会加载,而不是按需加载, 修改项目根目下的composer.json, 加入 “autoload” 项:

{
	"name": "gitlib/composer",
	"require":{
		"predis/predis":"1.1.1"
	},
	"autoload":{
		"files":["Controller/User.php"]
	}
}

files键对应的值是一个数组,数组元素是文件的路径,路径是相对于应用的根目录。加上上述内容后,运行命令:

composer dump-autoload

让composer重建自动加载的信息,composer会把配置值写入与 Files加载方式对应的 verndor\composer\autoload_files.php配置文件中:

<?php
// autoload_files.php @generated by Composer
$vendorDir = dirname(dirname(__FILE__));
$baseDir = dirname($vendorDir);
return array(
 '7efd69bb86214589340b40039fd363f7' => $baseDir . '/Controller/User.php',
);

现在就可以在代码中里调用User类了。

<?php
require 'vendor/autoload.php';
$client = new Predis\Client();
$user = new \Controller\User();
$user->login();

Classmap

classmap引用的所有组合,都会在 install/update 过程中生成,并存储到vendor/composer/autoload_classmap.php 文件中。这个 map 是经过扫描指定目录(同样支持直接精确到文件)中所有的 .php 和 .inc 文件里内置的类而得到的。

{
	"name": "gitlib/composer",
	"require":{
		"predis/predis":"1.1.1"
	},
	"autoload":{
		"classmap":["Controller"]
	}
}

Composer会扫描Controller目录下的所有.php.inc文件,存储到vendor/composer/autoload_classmap.php文件中:

<?php
// autoload_classmap.php @generated by Composer
$vendorDir = dirname(dirname(__FILE__));
$baseDir = dirname($vendorDir);
return array(
 'Controller\\User' => $baseDir . '/Controller/User.php',
);

PSR-0

PSR-0自动加载规范是已经废弃的标准, 不再做说明。

PSR-4

PSR-4是Composer推荐使用的一种方式(关于PSR规范可参考:PHP标准规范PSR),因为它更易使用并能带来更简洁的目录结构。对于上面的Controller目录我们先改名src:

├── composer.json
├── composer.json.bk
├── composer.lock
├── index.php
├── src
│ └── User.php
└── vendor
 ├── autoload.php
 ├── composer
 └── predis

在composer.json中我们将Controller命名空间和src关联起来:

{
	"name": "gitlib/composer",
	"require":{
		"predis/predis":"1.1.1"
	},
	"autoload":{
		"psr-4": {
			"Controller\\":"src/"
		}
	}
}
PSR-4 的命名空间前缀也必须以 \\ 结尾,以避免类似前缀间的冲突。

psr-4中的key和value定义了namespace以及其对应的目录映射。按照PSR-4的规则,当试图自动加载”Controller\User”类的使用,会去寻找”src/User.php”这个文件,此时Controller并不会出现在文件路径中。

自动加载原理

下面我们通过源码分析composer是如何实现自动加载功能。

入口

<?php
require 'vendor/autoload.php';

我们通过require ‘vendor/autoload.php实现自动加载,vendor/autoloaad.php文件引用composer/autoload_real.php

<?php
// autoload.php @generated by Composer
require_once __DIR__ . '/composer/autoload_real.php';
return ComposerAutoloaderInitb84761f57e62a6a534584b91ca213591::getLoader();

autoload_real

autoload_real.php是自动加载引导类,程序主要调用了引导类的静态方法getLoader()

<?php
// autoload_real.php @generated by Composer
class ComposerAutoloaderInitb84761f57e62a6a534584b91ca213591
{
 private static $loader;
 public static function loadClassLoader($class)
 {
 if ('Composer\Autoload\ClassLoader' === $class) {
 require __DIR__ . '/ClassLoader.php';
 }
 }
 public static function getLoader()
 {
 // 返回Composer\Autoload\ClassLoader单例
 if (null !== self::$loader) {
 return self::$loader;
 }
 // 调用spl_autoload_register加载\Composer\Autoload\ClassLoader
 spl_autoload_register(array('ComposerAutoloaderInitb84761f57e62a6a534584b91ca213591', 'loadClassLoader'), true, true);
 // 实例化\Composer\Autoload\ClassLoader类
 self::$loader = $loader = new \Composer\Autoload\ClassLoader();
 spl_autoload_unregister(array('ComposerAutoloaderInitb84761f57e62a6a534584b91ca213591', 'loadClassLoader'));
 // 静态初始化只支持 PHP5.6 以上版本并且不支持 HHVM 虚拟机
 $useStaticLoader = PHP_VERSION_ID >= 50600 && !defined('HHVM_VERSION') && (!function_exists('zend_loader_file_encoded') || !zend_loader_file_encoded());
 if ($useStaticLoader) {
 // 使用 autoload_static 进行静态初始化
 require_once __DIR__ . '/autoload_static.php';
 call_user_func(\Composer\Autoload\ComposerStaticInitb84761f57e62a6a534584b91ca213591::getInitializer($loader));
 } else {
 // 如果PHP版本低于 5.6 或者使用 HHVM 虚拟机环境,那么就要使用核心类的接口进行初始化
 // PSR0 标准
 $map = require __DIR__ . '/autoload_namespaces.php';
 foreach ($map as $namespace => $path) {
 $loader->set($namespace, $path);
 }
 // PSR4 标准
 $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
 if ($useStaticLoader) {
 $includeFiles = Composer\Autoload\ComposerStaticInitb84761f57e62a6a534584b91ca213591::$files;
 } else {
 $includeFiles = require __DIR__ . '/autoload_files.php';
 }
 // files定义的文件,直接require就行了
 foreach ($includeFiles as $fileIdentifier => $file) {
 composerRequireb84761f57e62a6a534584b91ca213591($fileIdentifier, $file);
 }
 return $loader;
 }
}

autoload_static

<?php
// autoload_static.php @generated by Composer
namespace Composer\Autoload;
class ComposerStaticInitb84761f57e62a6a534584b91ca213591
{
 public static $files = array (
 '7efd69bb86214589340b40039fd363f7' => __DIR__ . '/../..' . '/Controller/User.php',
 );
 public static $prefixLengthsPsr4 = array (
 'P' => 
 array (
 'Predis\\' => 7,
 ),
 'C' => 
 array (
 'Controller\\' => 11,
 ),
 );
 public static $prefixDirsPsr4 = array (
 'Predis\\' => 
 array (
 0 => __DIR__ . '/..' . '/predis/predis/src',
 ),
 'Controller\\' => 
 array (
 0 => __DIR__ . '/../..' . '/src',
 ),
 );
 public static function getInitializer(ClassLoader $loader)
 {
 return \Closure::bind(function () use ($loader) {
 $loader->prefixLengthsPsr4 = ComposerStaticInitb84761f57e62a6a534584b91ca213591::$prefixLengthsPsr4;
 $loader->prefixDirsPsr4 = ComposerStaticInitb84761f57e62a6a534584b91ca213591::$prefixDirsPsr4;
 }, null, ClassLoader::class);
 }
}

静态初始化类的核心就是 getInitializer() 函数,它将自己类中的顶级命名空间映射给了 ClassLoader 类。

PSR4 标准顶级命名空间映射用了两个数组,第一个是用命名空间第一个字母作为前缀索引,然后是 顶级命名空间,但是最终并不是文件路径,而是 顶级命名空间的长度。为什么呢?

因为 PSR4 标准是用顶级命名空间目录替换顶级命名空间,所以获得顶级命名空间的长度很重要。

ClassLoader

public function register($prepend = false)
{
 spl_autoload_register(array($this, 'loadClass'), true, $prepend);
}
public function loadClass($class)
{
 if ($file = $this->findFile($class)) {
 includeFile($file);
 return true;
 }
}
/**
* Finds the path to the file where the class is defined.
*
* @param string $class The name of the class
*
* @return string|false The path if found, false otherwise
*/
public function findFile($class)
{
 // class map lookup
 if (isset($this->classMap[$class])) {
 return $this->classMap[$class];
 }
 if ($this->classMapAuthoritative || isset($this->missingClasses[$class])) {
 return false;
 }
 if (null !== $this->apcuPrefix) {
 $file = apcu_fetch($this->apcuPrefix.$class, $hit);
 if ($hit) {
 return $file;
 }
 }
 $file = $this->findFileWithExtension($class, '.php');
 // Search for Hack files if we are running on HHVM
 if (false === $file && defined('HHVM_VERSION')) {
 $file = $this->findFileWithExtension($class, '.hh');
 }
 if (null !== $this->apcuPrefix) {
 apcu_add($this->apcuPrefix.$class, $file);
 }
 if (false === $file) {
 // Remember that this class does not exist.
 $this->missingClasses[$class] = true;
 }
 return $file;
}
function includeFile($file)
{
 include $file;
}

ClassLoader 的 register() 函数将 loadClass() 函数注册到 PHP 的 SPL 函数堆栈中,每当 PHP 遇到不认识的命名空间时就会调用函数堆栈的每个函数,直到加载命名空间成功。所以 loadClass() 函数就是自动加载的关键了。

相关推荐

C#.NET Autofac 详解(c# autoit)

简介Autofac是一个成熟的、功能丰富的.NET依赖注入(DI)容器。相比于内置容器,它额外提供:模块化注册、装饰器(Decorator)、拦截器(Interceptor)、强o的属性/方法注...

webapi 全流程(webapi怎么部署)

C#中的WebAPIMinimalApi没有控制器,普通api有控制器,MinimalApi是直达型,精简了很多中间代码,广泛适用于微服务架构MinimalApi一切都在组控制台应用程序类【Progr...

.NET外挂系列:3. 了解 harmony 中灵活的纯手工注入方式

一:背景1.讲故事上一篇我们讲到了注解特性,harmony在内部提供了20个HarmonyPatch重载方法尽可能的让大家满足业务开发,那时候我也说了,特性虽然简单粗暴,但只能解决95%...

C# 使用SemanticKernel调用本地大模型deepseek

一、先使用ollama部署好deepseek大模型。具体部署请看前面的头条使用ollama进行本地化部署deepseek大模型二、创建一个空的控制台dotnetnewconsole//添加依赖...

C#.NET 中间件详解(.net core中间件use和run)

简介中间件(Middleware)是ASP.NETCore的核心组件,用于处理HTTP请求和响应的管道机制。它是基于管道模型的轻量级、模块化设计,允许开发者在请求处理过程中插入自定义逻辑。...

IoC 自动注入:让依赖注册不再重复劳动

在ASP.NETCore中,IoC(控制反转)功能通过依赖注入(DI)实现。ASP.NETCore有一个内置的依赖注入容器,可以自动完成依赖注入。我们可以结合反射、特性或程序集扫描来实现自动...

C#.NET 依赖注入详解(c#依赖注入的三种方式)

简介在C#.NET中,依赖注入(DependencyInjection,简称DI)是一种设计模式,用于实现控制反转(InversionofControl,IoC),以降低代码耦合、提高可...

C#从零开始实现一个特性的自动注入功能

在现代软件开发中,依赖注入(DependencyInjection,DI)是实现松耦合、模块化和可测试代码的一个重要实践。C#提供了优秀的DI容器,如ASP.NETCore中自带的Micr...

C#.NET 仓储模式详解(c#仓库货物管理系统)

简介仓储模式(RepositoryPattern)是一种数据访问抽象模式,它在领域模型和数据访问层之间创建了一个隔离层,使得领域模型无需直接与数据访问逻辑交互。仓储模式的核心思想是将数据访问逻辑封装...

C#.NET 泛型详解(c# 泛型 滥用)

简介泛型(Generics)是指在类型或方法定义时使用类型参数,以实现类型安全、可重用和高性能的数据结构与算法为什么需要泛型类型安全防止“装箱/拆箱”带来的性能损耗,并在编译时检测类型错误。可重用同一...

数据分析-相关性分析(相关性 分析)

相关性分析是一种统计方法,用于衡量两个或多个变量之间的关系强度和方向。它通过计算相关系数来量化变量间的线性关系,从而帮助理解变量之间的相互影响。相关性分析常用于数据探索和假设检验,是数据分析和统计建模...

geom_smooth()函数-R语言ggplot2快速入门18

在每节,先运行以下这几行程序。library(ggplot2)library(ggpubr)library(ggtext)#用于个性化图表library(dplyr)#用于数据处理p...

规范申报易错要素解析(规范申报易错要素解析)

为什么要规范申报?规范申报是以满足海关监管、征税、统计等工作为目的,纳税义务人及其代理人依法向海关如实申报的行为,也是海关审接单环节依法监管的重要工作。企业申报的内容须符合《中华人民共和国海关进出口货...

「Eurora」海关编码归类 全球海关编码查询 关务服务

  海关编码是什么?  海关编码即HS编码,为编码协调制度的简称。  其全称为《商品名称及编码协调制度的国际公约》(InternationalConventionforHarmonizedCo...

9月1日起,河南省税务部门对豆制品加工业试行新政7类豆制品均适用投入产出法

全媒体记者杨晓川报道9月2日,记者从税务部门获悉,为减轻纳税人税收负担,完善农产品增值税进项税额抵扣机制,根据相关规定,结合我省实际情况,经广泛调查研究和征求意见,从9月1日起,我省税务部门对豆制品...