项目配置通过composer.json管理本地依赖,全局配置通过~/.composer/下的文件设置用户级选项,前者作用于单个项目,后者影响所有项目,且项目配置优先级更高。

Composer 的配置分为全局配置和项目配置,两者作用范围和存放位置不同,理解它们的区别有助于更好地管理 PHP 依赖。
项目配置:composer.json
每个 PHP 项目根目录下的 composer.json 文件就是该项目的本地配置文件。它定义了当前项目所依赖的包、版本约束、自动加载规则、脚本钩子等信息。
常见内容包括:
- require:项目运行所需的核心依赖
- require-dev:开发阶段使用的工具,如测试框架
- autoload:类自动加载映射规则
- scripts:自定义执行脚本,如 post-install-cmd
执行 composer install 或 composer require 时,Composer 会读取这个文件来解析依赖并安装到 vendor/ 目录。
全局配置:存储在系统特定路径
全局配置不是某个单一文件,而是 Composer 在系统中维护的一组设置,主要来源于以下几个方面:
- 用户主目录下的 composer.json 和 config.json(通常位于 ~/.composer/ 或 ~/composer/)
- 通过 composer config --global 命令设置的选项会被写入全局配置文件
- 全局配置影响所有使用 Composer 的项目,例如默认仓库、GitHub OAuth token、缓存目录等
你可以运行以下命令查看全局配置路径:
composer config --global home输出结果通常是:~/.composer(Linux/macOS)或 C:\Users\用户名\AppData\Roaming\Composer(Windows)
关键区别与使用场景
项目配置关注“这个项目需要什么”,而全局配置关注“我这个用户如何使用 Composer”。
- 作用范围不同:项目配置只对当前项目生效;全局配置影响整个用户的 Composer 行为
- 文件位置不同:项目配置在项目根目录;全局配置在用户主目录下的 Composer 配置目录
- 典型用途不同:项目配置用于声明依赖;全局配置用于设置代理、认证令牌、默认行为等
例如,你在多个项目中使用私有 Git 仓库作为包源,可以将 SSH 密钥或 OAuth token 写入全局配置,避免重复配置。
优先级说明
当同一配置项同时出现在全局和项目中时,项目级别的设置优先级更高。比如自动加载规则或仓库地址,项目 composer.json 中的定义会覆盖全局设定。
基本上就这些。搞清楚哪个配置在哪里、管什么,能让你更高效地使用 Composer 管理依赖。不复杂但容易忽略细节。










