composer config 可直接修改本地或全局配置,无需手动编辑文件;通过–local(默认)或–global指定作用域,用点号分隔的路径设置嵌套键值,支持查看(–list)、删除(–unset)及重置配置。

用 composer config 可以直接修改 Composer 的本地(项目级)或全局配置,无需手动编辑 composer.json 或 auth.json 文件。关键在于指定作用域和配置项路径。
指定配置作用域:–local 与 –global
默认情况下,composer config 修改的是当前项目的 composer.json(即 local 模式)。加 --global 参数则操作全局配置(通常位于 ~/.composer/config.json)。
- 改本地配置:直接运行命令,如
composer config repo.packagist composer https://packagist.phpcomposer.com - 改全局配置:加上
--global,如composer config --global github-oauth.github.com your_Token
常用配置项路径与用途
配置项路径遵循 JSON 键名结构,支持嵌套(用点号分隔)。几个高频场景:
- 设置私有仓库:
composer config repositories.myrepo vcs https://git.example.com/my/package.git - 配置 GitHub OAuth Token:
composer config --global github-oauth.github.com abc123def456 - 禁用 Packagist 默认源:
composer config --global packagist.org false - 设置镜像源(推荐国内用户):
composer config --global repo.packagist composer https://packagist.phpcomposer.com
查看、删除和重置配置
除了设置,config 命令也支持读取和清理:
- 查看某项配置:加
--list列出全部,或直接跟键名,如composer config github-oauth.github.com - 删除某项配置:加
--unset,如composer config --global --unset github-oauth.github.com - 清空整个配置文件(慎用):
composer config --global --unset *(仅限 global)
注意权限与生效时机
修改后配置立即写入对应 JSON 文件,但部分设置(如镜像源、OAuth)在下次 composer install 或 update 时才实际生效。全局配置需确保当前用户对 ~/.composer/ 有读写权限;若报错“Permission denied”,可 chown 修复。
基本上就这些。不复杂但容易忽略作用域和路径写法,多试两次就熟了。
以上就是如何通过 composer config 命令修改本地或全局配置?的详细内容,更多请关注php中文网其它相关文章!