罗罗编程学习记录
本页内容 展开查看

04.5.1.4 Composer、PSR 规范与依赖治理

所属:全栈开发面试题库 / 04 后端语言与运行时 / 04.5 PHP / 04.5.1 PHP 语言与工程

04.5.1.4-001 Composer 是什么,三个关键文件/目录?

一句话结论

Composer 是 PHP 依赖与包管理工具:composer.json 声明项目元数据与依赖约束,composer.lock 锁定解析出的精确版本,vendor/ 存放已安装依赖与自动加载器。

概念解释

Composer 解析版本约束、下载包、生成自动加载映射。json 是人维护的清单,lock 是可复现安装快照,vendor 是生成物。应用项目应提交 lock,库包通常不提交。

原理流程

  1. json 声明 require 约束。
  2. composer update 解析并写入 lock。
  3. composer install 按 lock 安装到 vendor。

代码或图示

{
  "require": {
    "php": ">=8.2",
    "monolog/monolog": "^3.0"
  }
}

常见误区

  • 把 vendor 纳入版本管理:它是生成物,应加入 .gitignore。
  • 以为 install 会更新依赖:install 按 lock 安装,update 才重新解析。

追问

  • Composer 从哪里拉包?答:默认 Packagist 公共仓库,可配置私有仓库/ VCS/路径包。
  • php 依赖声明什么?答:声明运行时 PHP 版本约束,Composer 安装时校验环境版本。

04.5.1.4-002 自动加载配置:PSR-4、classmap、files 区别?

一句话结论

psr-4 按命名空间前缀运行时计算文件路径;classmap 预扫描生成类名→文件静态表;files 列出非类文件(函数库)在初始化时加载。

概念解释

三种 autoload 方式覆盖不同需求:PSR-4 灵活、新增类无需重建;classmap 查找快但改动需 dump;files 用于无法靠类加载的函数/常量文件。

原理流程

  1. json autoload 配置三种方式。
  2. dump-autoload 生成映射。
  3. 类加载按 PSR-4 计算路径或查 classmap;files 直接 include。

代码或图示

{
  "autoload": {
    "psr-4": { "App\\": "src/" },
    "classmap": ["legacy/"],
    "files": ["src/helpers.php"]
  }
}

常见误区

  • 把函数库写成 PSR-4:函数无类名,必须放 files。
  • 改类位置后不 dump:classmap 仍是旧映射,类加载失败。

追问

  • PSR-4 与 classmap 性能差异?答:classmap 哈希查表快;PSR-4 运行时字符串拼接路径。生产可用 --optimize-autoloader 生成 classmap。
  • files 加载时机?答:自动加载文件被引入时即 include,每次请求加载,不宜放重逻辑。

04.5.1.4-003 composer dump-autoload 与 --optimize-autoloader?

一句话结论

dump-autoload 重新生成自动加载映射文件;--optimize-autoloader 扫描类生成 classmap 静态表,消除运行时路径计算,提升生产加载速度。

概念解释

开发环境 PSR-4 灵活即可;生产环境优化为 classmap,类名直接查表。优化模式下新增/移动类需重新 dump,否则加载不到。

原理流程

  1. 改动命名空间/目录/类后执行 dump。
  2. 优化参数扫描所有类生成静态映射。
  3. vendor/autoload.php 注册生成的加载器。

代码或图示

composer dump-autoload
composer dump-autoload --optimize-autoloader

常见误区

  • 生产只装依赖不优化:每次请求运行时计算 PSR-4 路径,小项目差异小,大项目有收益。
  • 优化后改类不重新 dump:classmap 缺新类,报类未找到。

追问

  • --classmap-authoritative 是什么?答:只查 classmap,找不到就不再回退 PSR-4,更快但要求类全部入表(以当前 Composer 版本为准)。
  • 自动加载文件在哪?答:vendor/composer/autoload_*.php,由 autoload.php 统一引入。

04.5.1.4-004 版本约束:^/~/*/=/通配?

一句话结论

^1.2.3 允许兼容更新(<2.0),~1.2.3 限制在更窄范围,* 任意版本,= 精确锁定,1.2.* 限定小版本;Composer 按语义化版本解析。

概念解释

语义化版本 MAJOR.MINOR.PATCH:不兼容变更升 MAJOR,兼容功能升 MINOR,修复升 PATCH。约束决定可选更新范围,lock 记录实际选中版本。

原理流程

  1. 解析器在约束范围选最新兼容版本。
  2. 写入 composer.lock。
  3. update 才按约束重新解析。

代码或图示

{
  "require": {
    "a/a": "^1.2",
    "b/b": "~1.2.0",
    "c/c": "1.2.*",
    "d/d": "=2.0.0"
  }
}

常见误区

  • 以为 ~1.2 能升到 1.3:~ 边界较窄,具体范围以 Composer 文档为准。
  • 改约束后自动更新 lock:需 composer update 重新解析。

追问

  • stability 约束怎么写?答:可加 @dev/@beta 等稳定性标记;稳定包默认不装预发布版本。
  • 分支别名?答:dev 分支可用 dev-main 或别名 ^1.0-dev,具体语法以 Composer 文档为准。

04.5.1.4-005 install 与 update 的区别,lock 何时更新?

一句话结论

install 按 composer.lock 安装已有版本,无 lock 时解析并生成;update 重新解析约束、升级依赖并改写 lock;lock 只在 update/require 时更新。

概念解释

部署环境用 install 保证与 lock 一致;开发时改约束后 update 更新锁定版本。CI/生产不应随意 update,避免引入未验证新版本。

原理流程

  1. install:读 lock,按锁定版本装 vendor。
  2. update:解析 json 约束,选新版本,重写 lock。
  3. 新增包用 composer require,同时写 json 与 lock。

代码或图示

composer install          # 按 lock
composer update monolog/* # 只更新指定包
composer require guzzlehttp/guzzle

常见误区

  • 生产跑 update:可能拉入未测试的新版本,破坏可复现性。
  • 以为 install 会同步 json 新约束:不会,需 update 才更新 lock。

追问

  • --no-dev 作用?答:不安装 require-dev 依赖,生产环境使用。
  • lock 冲突如何合并?答:合并后执行 update 重新解析,避免手工编辑 lock。

04.5.1.4-006 require 与 require-dev,--no-dev?

一句话结论

require 是运行时必需依赖;require-dev 仅开发/测试(PHPUnit、静态分析、代码风格工具);生产安装 --no-dev 排除开发依赖。

概念解释

依赖分层减小生产 vendor 体积与攻击面。测试框架、lint 工具不应进入生产运行时。autoload-dev 对应开发期自动加载(如测试目录)。

原理流程

  1. 运行时库写 require。
  2. 开发工具写 require-dev。
  3. 部署 install 加 --no-dev 跳过 dev 依赖。

代码或图示

{
  "require": { "php": ">=8.2" },
  "require-dev": { "phpunit/phpunit": "^11" }
}

常见误区

  • 把测试框架放进 require:生产多装无用依赖。
  • 生产漏 --no-dev:开发工具进入 vendor,增大体积与风险。

追问

  • autoload-dev 用于什么?答:开发期加载测试/示例目录,不进生产自动加载。
  • dev 依赖被运行时代码引用怎么办?答:说明该库应提升到 require,或拆分公共逻辑。

04.5.1.4-007 PSR-1/PSR-12 编码风格要点?

一句话结论

PSR-1 基础规范(文件编码、PHP 标签、命名约定);PSR-12 是代码风格标准:4 空格缩进、命名空间声明、类/方法大括号位置、类名大驼峰、方法名蛇形等。

概念解释

PSR 是 PHP 协作规范,统一团队风格。PSR-12 细化缩进、换行、可见性声明、关键词大小写等。可用 PHP-CS-Fixer/PHP_CodeSniffer 自动检查与修复。

原理流程

  1. 按 PSR-12 书写格式。
  2. CI 用 cs-fixer/phpcs 检查风格。
  3. 不达标阻断合并或自动修复。

代码或图示

<?php
declare(strict_types=1);

namespace App\Service;

final class UserService
{
    public function create(array $data): User
    {
    }
}

常见误区

  • 混用 Tab 与空格:PSR-12 规定 4 空格缩进。
  • 类名蛇形/方法名大驼峰:类名 PascalCase,方法/变量 snake_case。

追问

  • 自动检查工具?答:php-cs-fixer fix 自动修复,phpcs 只报告;配置规则集对齐 PSR-12。
  • PSR 与框架规范冲突?答:以团队/框架规则为准,PSR 是基线兼容规范。

04.5.1.4-008 PSR-4 自动加载规范要点?

一句话结论

PSR-4 把命名空间前缀映射到基准目录,类名剩余部分转为子目录与文件名;类全名 = 前缀 + 相对路径段,文件以 .php 结尾,大小写与类名一致。

概念解释

规范解耦包内部目录结构与命名空间。前缀 App\ → src/,App\Service\User → src/Service/User.php。自动加载器按此规则计算路径。

原理流程

  1. 匹配最长命名空间前缀。
  2. 剥离前缀,剩余段替换 \ 为 /。
  3. 拼接基准目录与 .php 加载文件。

代码或图示

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

常见误区

  • 目录名与命名空间段大小写不符:Linux 加载失败。
  • 文件名缺 .php 或类名与文件名不一致:规范要求一致。

追问

  • PSR-4 支持子命名空间吗?答:支持,多层段逐级映射子目录。
  • 与旧 PSR-0 区别?答:PSR-4 不把前缀段转为目录层级,路径更扁平;新项目用 PSR-4。

04.5.1.4-009 常见 PSR:日志、HTTP 消息、容器、中间件、HTTP 客户端?

一句话结论

PSR-3 日志接口,PSR-7 HTTP 消息(请求/响应/流),PSR-11 容器接口,PSR-15 中间件接口,PSR-18 HTTP 客户端接口;这些标准接口让框架与组件互通。

概念解释

各 PSR 定义统一契约:PSR-3 logger 接口,PSR-7 消息抽象,PSR-11 容器 get/has,PSR-15 中间件处理链,PSR-18 客户端 sendRequest。依赖接口而非具体实现可替换组件。

原理流程

  1. 组件依赖 PSR 接口类型提示。
  2. 框架/库提供对应实现。
  3. 换实现不改业务调用代码。

代码或图示

interface LoggerInterface {
    public function log($level, $message, array $context = []): void;
}

常见误区

  • 以为 PSR 提供实现:PSR 只定接口,实现由 Monolog/DI 容器等提供。
  • 混淆 PSR-7 与 PSR-18:前者是消息对象,后者是发送消息的客户端契约。

追问

  • PSR-11 容器方法?答:get($id) 取条目、has($id) 判断是否存在。
  • 中间件如何组成链?答:PSR-15 请求处理器与中间件接口,按责任链顺序包装处理。

04.5.1.4-010 依赖冲突排查:why/why-not/depends?

一句话结论

composer why <包> 查看谁依赖该包,composer why-not <包> <版本> 分析为何不能安装指定版本,composer depends 列出某包的依赖;用于定位约束冲突来源。

概念解释

版本冲突常由间接依赖约束叠加导致。顺着依赖链找到锁定版本的上游约束,再决定升级哪个包或放宽约束。

原理流程

  1. why 反向追溯引入路径。
  2. why-not 检查阻止安装的约束。
  3. 调整对应包约束或升级上游。

代码或图示

composer why monolog/monolog
composer why-not guzzlehttp/guzzle 7.0
composer depends symfony/http-foundation

常见误区

  • 直接改 lock 解决冲突:应通过 update 让解析器重算。
  • 只看直接依赖:冲突常在间接依赖链上。

追问

  • 冲突输出怎么读?答:信息列出要求不同版本的包链与约束,按链定位可升级/放宽的一方。
  • 多版本并存说明什么?答:两个上游约束范围无交集,Composer 选择各自兼容版本,增加 vendor 体积。

04.5.1.4-011 重复依赖与 composer outdated?

一句话结论

composer outdated 列出可升级的依赖及当前/最新版本;重复版本用 composer depends/依赖树分析,评估能否统一约束到同一版本。

概念解释

重复依赖增加体积与补丁面。outdated 帮助定期跟进安全更新与功能升级;升级前需测试兼容性。

原理流程

  1. outdated 对比已装版本与仓库最新版。
  2. 查看依赖树找重复包来源。
  3. 统一约束或接受多版本,记录原因。

代码或图示

composer outdated
composer show symfony/*

常见误区

  • 盲目升级最新 MAJOR:不兼容变更需回归测试。
  • 忽略安全公告:应定期 audit/outdated 跟进补丁版本。

追问

  • 如何限制只看补丁更新?答:outdated 有参数显示可用更新类型;具体选项以 Composer 版本为准。
  • 重复依赖能强制合并吗?答:约束范围有交集才可统一;上游固定旧版本时无法强制。

04.5.1.4-012 私有包仓库:repositories 配置?

一句话结论

composer.json repositories 可配置私有 VCS、Path 或 Composer 类型仓库,用于内部私有包;优先级与认证凭证通过仓库配置或 auth 信息管理。

概念解释

公共 Packagist 之外,团队内部库可托管 Git 仓库、本地路径或私有 Composer 仓库。配置后 Composer 从这些源解析与下载私有包。

原理流程

  1. 声明 repositories 类型与地址。
  2. 配置访问凭证(token/SSH/HTTP auth)。
  3. require 私有包名,Composer 从私有源拉取。

代码或图示

{
  "repositories": [
    { "type": "vcs", "url": "git@git.example.com:team/pkg.git" },
    { "type": "path", "url": "../local-pkg" }
  ]
}

常见误区

  • 把凭证写进 json 提交仓库:凭证应放 auth 配置/环境变量,不入库。
  • 私有包名与公共包冲突:命名空间前缀区分内部包。

追问

  • Path 包适合什么?答:本地并行开发多包,路径映射直接引用;发布时改 VCS/私有仓库。
  • 私有 Composer 仓库做什么?答:承载聚合包元数据与版本,类似私有 Packagist(如 Satis/私有部署,具体方案依团队)。

04.5.1.4-013 脚本钩子 scripts?

一句话结论

composer.json scripts 在 install/update/test 等事件阶段注册命令,如 post-autoload-dump、pre-install-cmd;用于清理、构建、生成缓存等自动化步骤。

概念解释

脚本钩子绑定 Composer 事件,可执行 PHP 闭包、命令或自定义脚本。常见于框架安装后发布配置、清缓存、生成代理类。

原理流程

  1. scripts 字段映射事件名到命令数组。
  2. Composer 对应事件触发执行。
  3. 脚本可调用 vendor 内二进制命令。

代码或图示

{
  "scripts": {
    "post-autoload-dump": ["php bin/console cache:warmup"],
    "test": "phpunit"
  }
}

常见误区

  • 把重逻辑放 Composer 钩子:耦合安装流程,应独立命令按需执行。
  • 脚本依赖未安装的 dev 工具:生产 --no-dev 钩子会失败。

追问

  • 自定义脚本命令怎么跑?答:composer test 执行 scripts 中注册的命名命令。
  • 事件顺序?答:pre/post 对应命令前后阶段;具体事件列表以 Composer 文档为准。

04.5.1.4-014 依赖安全审计与版本锁定?

一句话结论

定期用安全审计工具检查已知漏洞依赖;应用项目锁定 composer.lock 保证环境一致,补丁版本按公告评估升级,避免生产引入未验证版本。

概念解释

依赖治理包含:锁定可复现版本、跟踪安全公告、及时打补丁、控制 vendor 体积。Composer 提供 audit 命令(以当前版本可用性为准),对照漏洞数据库扫描 lock。

原理流程

  1. 安装按 lock 锁定版本。
  2. 审计工具扫描受影响包。
  3. 升级补丁版本,回归测试后更新 lock。

代码或图示

composer audit
composer update vendor/package --with-patch

常见误区

  • 长期不跟进依赖公告:已知漏洞组件留在生产。
  • 生产直接 update 全部依赖:应按公告逐个升级并测试。

追问

  • 审计数据来源?答:漏洞数据库缓存,需定期更新;工具与命令以当前 Composer/生态为准。
  • 无法升级旧包怎么办?答:评估隔离、补丁替代或替换组件,记录风险接受结论。

04.5.1.4-015 classmap 与 PSR-4 性能取舍?

一句话结论

PSR-4 灵活、改类无需重建但运行时计算路径;classmap 查表快但新增/移动类必须 dump;生产优化用 classmap,开发保留 PSR-4 灵活性。

概念解释

加载性能差异在大型项目明显:每次请求加载多个类,路径计算累积。优化 autoloader 扫描全量类生成静态表,牺牲改动时的重建步骤换查找速度。

原理流程

  1. 开发:PSR-4 直接计算路径。
  2. 生产 dump 优化生成 classmap。
  3. 类变更后重新 dump 保持表完整。

代码或图示

composer dump-autoload --optimize-autoloader

常见误区

  • 优化后新增类不重建表:classmap 找不到新类。
  • 小项目过度优化:收益有限,按项目规模选择。

追问

  • classmap 存哪?答:vendor/composer/autoload_classmap.php 类名到文件路径数组。
  • 自动加载失败先怀疑什么?答:优化表过期、命名空间前缀不符、文件大小写。

04.5.1.4-016 扩展依赖 ext-* 与平台包?

一句话结论

require 中 ext-<name> 声明 PHP 扩展依赖(如 ext-pdo、ext-json),Composer 安装时校验扩展是否启用;php 约束 PHP 版本,平台包保护运行时环境。

概念解释

代码依赖特定扩展函数/类,必须在 require 声明,否则新环境缺扩展才在运行时报错。Composer 把 php/ext-* 作为平台包校验,不下载安装扩展。

原理流程

  1. require 写 ext-json: "*" 等。
  2. install/update 检查当前 PHP 与扩展版本。
  3. 不满足则报错,提示安装启用扩展。

代码或图示

{
  "require": {
    "php": ">=8.2",
    "ext-pdo": "*",
    "ext-mbstring": "*"
  }
}

常见误区

  • 代码用了扩展函数却不声明 ext-*:环境缺失时运行期致命错误。
  • 以为 Composer 会自动安装扩展:平台包只校验,扩展需系统/镜像安装。

追问

  • 如何查看已装扩展?答:php -m 或 phpinfo();Composer show 查看平台包约束。
  • 扩展版本约束怎么写?答:ext-gd: "^8.0" 等版本范围,以扩展实际版本号为准。

04.5.1.4-017 项目初始化与命名空间约定?

一句话结论

composer init 交互式生成 composer.json;项目根命名空间前缀(如 App\)映射 src/,测试目录用 autoload-dev,包名遵循 vendor/package 小写短横线。

概念解释

初始化约定:包名 vendor/project,源码 PSR-4 前缀,dev 自动加载测试目录。命名空间与目录一致,便于团队协作与自动加载。

原理流程

  1. init 生成 json 基本结构。
  2. 配置 psr-4 前缀与基准目录。
  3. 编写代码对齐命名空间与目录。

代码或图示

composer init

常见误区

  • 包名用大写/下划线:Composer 包名规范小写、短横线分隔。
  • 源码放根目录无命名空间:破坏 PSR-4 与自动加载约定。

追问

  • 库包与应用包 json 区别?答:库包声明 autoload 供下游使用,应用包可含 scripts 与 dev 依赖;库通常不提交 lock。
  • 测试目录怎么自动加载?答:autoload-dev.psr-4 映射 Tests\ 到 tests/。

04.5.1.4-018 lock 文件提交策略?

一句话结论

应用/项目提交 composer.lock 保证团队、CI、生产环境依赖一致;可复用的库包不提交 lock,以便测试在依赖最新兼容版本下是否兼容。

概念解释

lock 锁定解析快照。部署按 install 复现;库面向下游,自带 lock 会固定自己的依赖版本,掩盖与新依赖的兼容问题。

原理流程

  1. 应用:lock 入库,install 按锁定版本。
  2. 库:lock 加入 .gitignore,CI update 验证兼容。
  3. 升级时 update 并重测。

代码或图示

应用项目:composer.lock 提交版本库
库包:    composer.lock 忽略

常见误区

  • 所有项目都忽略 lock:可执行部署项目恰恰需要锁定可复现版本。
  • 库提交 lock 后下游受其影响:下游按自己 lock 解析,但库自带 lock 不利兼容验证。

追问

  • 如何在干净环境按 lock 安装?答:composer install --no-dev,严格按 lock 解析。
  • lock 合并冲突怎么办?答:保留双方后执行 update 重新解析,不手工改版本号。