composer.json 的 config 节点至关重要,直接影响安装更新成败、性能与安全:process-timeout 需按环境设为900+避免超时;preferred-install 区分 dist/source 以平衡速度与调试;vendor-dir 变更须同步调整 autoload 和代码路径;allow-plugins 和 audit.ignore 需显式配置以保障插件安全与审计准确。

composer.json 里的 config 节点不是可有可无的装饰项,它直接决定 install/update 的成败、加载速度、缓存行为甚至安全审计结果。不配或乱配,轻则超时失败,重则 CI 环境崩掉。
process-timeout 设置太低导致 composer update 卡死或报错
默认值 300 秒(5 分钟)在多数本地环境够用,但一旦项目依赖多、网络慢、或用了私有仓库,很容易触发 ProcessTimedOutException。这不是网络问题,是 Composer 主动中止了进程。
- 生产环境或 CI 中建议设为
900(15 分钟)或更高,尤其当require包含大量 dev-only 依赖时 - 临时覆盖可用命令行参数:
composer update --timeout=1200,但不如写进config.process-timeout稳定 - 注意:该值对
composer install同样生效;如果锁文件已存在,install通常更快,但仍可能因脚本执行超时失败
preferred-install 控制 dist/source 安装方式,影响首次安装速度和调试便利性
默认 "dist" 下载 zip 包最快,但你无法直接改 vendor 里的源码;选 "source" 会 git clone,方便本地 patch 或调试,但耗时长、占空间大。
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 全局设
"preferred-install": "dist"适合部署和 CI - 对特定组织包强制 source:
"preferred-install": { "myorg/*": "source", "*": "dist" },这样自己写的包可随时改,第三方包仍走 dist - Composer 2.2+ 支持通配符和精确匹配,顺序无关,但重复键会覆盖——别写两遍
"*"
vendor-dir 和 autoload 配置冲突导致类找不到
改 vendor-dir 不难,但很多人忘了同步调整自动加载逻辑或硬编码路径。比如把 vendor-dir 改成 "lib/vendor",却还在代码里写 require 'vendor/autoload.php',运行就报 failed to open stream。
-
vendor-dir只影响 Composer 自身行为,不影响你代码里怎么 require —— 你得手动改路径或用__DIR__ . '/lib/vendor/autoload.php' - 如果同时改了
autoload.psr-4映射,确保命名空间末尾带反斜杠:"App\": "src/",漏掉会导致class not found且无明确提示 - 改完务必运行
composer dump-autoload -o,否则新映射不生效;-o(optimize)必须加,否则 classmap 不重建
allow-plugins 和 audit.ignore 处理插件权限与安全警告
Composer 2.2+ 默认禁用所有插件,不显式声明 allow-plugins,composer install 会卡在交互确认;而 audit.ignore 不是“关掉扫描”,只是过滤已知误报。
- 允许指定插件:
"allow-plugins": { "phpstan/extension-installer": true, "dealerdirect/phpcodesniffer-composer-installer": true } - 禁止全部插件(最安全):
"allow-plugins": false,但某些包(如 PHPStan 扩展)会直接失效 -
audit.ignore接受 CVE 编号数组或对象,对象格式支持apply: "audit"或"install",后者连composer require时的检查都跳过——慎用
最容易被忽略的是:config 里的配置不会继承自父项目或全局设置,每个项目必须独立声明;而且 composer validate 不校验 config 值是否合法(比如把 process-timeout 写成字符串),只有运行时才暴露问题。

















