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,库包通常不提交。
原理流程
- json 声明 require 约束。
composer update解析并写入 lock。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 用于无法靠类加载的函数/常量文件。
原理流程
- json
autoload配置三种方式。 - dump-autoload 生成映射。
- 类加载按 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,否则加载不到。
原理流程
- 改动命名空间/目录/类后执行 dump。
- 优化参数扫描所有类生成静态映射。
- 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 记录实际选中版本。
原理流程
- 解析器在约束范围选最新兼容版本。
- 写入 composer.lock。
- 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,避免引入未验证新版本。
原理流程
- install:读 lock,按锁定版本装 vendor。
- update:解析 json 约束,选新版本,重写 lock。
- 新增包用
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 对应开发期自动加载(如测试目录)。
原理流程
- 运行时库写 require。
- 开发工具写 require-dev。
- 部署 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 自动检查与修复。
原理流程
- 按 PSR-12 书写格式。
- CI 用 cs-fixer/phpcs 检查风格。
- 不达标阻断合并或自动修复。
代码或图示
<?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。自动加载器按此规则计算路径。
原理流程
- 匹配最长命名空间前缀。
- 剥离前缀,剩余段替换
\为/。 - 拼接基准目录与
.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。依赖接口而非具体实现可替换组件。
原理流程
- 组件依赖 PSR 接口类型提示。
- 框架/库提供对应实现。
- 换实现不改业务调用代码。
代码或图示
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 列出某包的依赖;用于定位约束冲突来源。
概念解释
版本冲突常由间接依赖约束叠加导致。顺着依赖链找到锁定版本的上游约束,再决定升级哪个包或放宽约束。
原理流程
why反向追溯引入路径。why-not检查阻止安装的约束。- 调整对应包约束或升级上游。
代码或图示
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 帮助定期跟进安全更新与功能升级;升级前需测试兼容性。
原理流程
- outdated 对比已装版本与仓库最新版。
- 查看依赖树找重复包来源。
- 统一约束或接受多版本,记录原因。
代码或图示
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 从这些源解析与下载私有包。
原理流程
- 声明 repositories 类型与地址。
- 配置访问凭证(token/SSH/HTTP auth)。
- 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 闭包、命令或自定义脚本。常见于框架安装后发布配置、清缓存、生成代理类。
原理流程
- scripts 字段映射事件名到命令数组。
- Composer 对应事件触发执行。
- 脚本可调用 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。
原理流程
- 安装按 lock 锁定版本。
- 审计工具扫描受影响包。
- 升级补丁版本,回归测试后更新 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 扫描全量类生成静态表,牺牲改动时的重建步骤换查找速度。
原理流程
- 开发:PSR-4 直接计算路径。
- 生产 dump 优化生成 classmap。
- 类变更后重新 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-* 作为平台包校验,不下载安装扩展。
原理流程
- require 写
ext-json: "*"等。 - install/update 检查当前 PHP 与扩展版本。
- 不满足则报错,提示安装启用扩展。
代码或图示
{
"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 自动加载测试目录。命名空间与目录一致,便于团队协作与自动加载。
原理流程
- init 生成 json 基本结构。
- 配置 psr-4 前缀与基准目录。
- 编写代码对齐命名空间与目录。
代码或图示
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 会固定自己的依赖版本,掩盖与新依赖的兼容问题。
原理流程
- 应用:lock 入库,install 按锁定版本。
- 库:lock 加入 .gitignore,CI update 验证兼容。
- 升级时 update 并重测。
代码或图示
应用项目:composer.lock 提交版本库
库包: composer.lock 忽略
常见误区
- 所有项目都忽略 lock:可执行部署项目恰恰需要锁定可复现版本。
- 库提交 lock 后下游受其影响:下游按自己 lock 解析,但库自带 lock 不利兼容验证。
追问
- 如何在干净环境按 lock 安装?答:
composer install --no-dev,严格按 lock 解析。 - lock 合并冲突怎么办?答:保留双方后执行 update 重新解析,不手工改版本号。