如何在composer.json中指定一个包只能从源码安装?(--prefer-source)

尼克
发布: 2025-12-23 12:43:04
原创
221人浏览过
可通过配置 "preferred-install" 实现按包指定源码安装:在 composer.json 的 config 中设置,如 "myorg/private-lib": "source",并确保该包提供 VCS 源信息。

如何在composer.json中指定一个包只能从源码安装?(--prefer-source)

composer.json 中无法直接强制某个包“只能从源码安装”,因为 --prefer-source 是 Composer 的全局命令行选项,不是 per-package 配置项。但你可以通过几种方式间接实现类似效果。

使用 preferred-install 配置(推荐)

这是最接近你需求的方法:在项目根目录的 composer.json 中设置 "preferred-install",按包名或通配符指定安装方式。

  • 支持精确匹配(如 "vendor/package")、通配符(如 "vendor/*")或全局默认("*"
  • 值为 "source" 表示优先走 Git 克隆(即等效于 --prefer-source 对该包生效)

示例:

{
    "config": {
        "preferred-install": {
            "myorg/private-lib": "source",
            "monolog/monolog": "dist",
            "*": "dist"
        }
    }
}
登录后复制

这样,myorg/private-lib 每次 install/update 都会尝试从源码安装(前提是它有可用的 VCS 信息,如 git 地址),其他包走 dist。

确保包本身提供源码信息

Composer 只有在包的 composer.json 中声明了 source(即 "type": "vcs" 或包含 "source" 字段)时,才能用 --prefer-source 安装。如果你是包的维护者:

星绘
星绘

豆包旗下 AI 写真、P 图、换装和视频生成

星绘 429
查看详情 星绘
  • 在包的 composer.json 中确保有有效的 "source" 或托管在支持的 VCS(如 GitHub、GitLab)上
  • 不要只发布 dist 归档(如 zip/tar),否则即使设了 preferred-install,Composer 也会 fallback 到 dist

避免依赖缓存干扰

Composer 缓存可能让本该走 source 的包“悄悄”用了 dist 归档。可临时清缓存验证:

  • composer clear-cache
  • 再运行 composer installcomposer update myorg/private-lib
  • 检查 vendor/myorg/private-lib/.git 是否存在,存在即说明是 source 安装

不推荐:全局强制 --prefer-source

虽然可以每次执行 composer install --prefer-source,但这会影响所有包,且无法写进 composer.json 自动生效。不适合“仅对某包”的场景,也容易被团队成员忽略。

基本上就这些。核心要点是:preferred-install + 包本身支持 VCS 源码地址 = 可控的 per-package 源码安装行为。

以上就是如何在composer.json中指定一个包只能从源码安装?(--prefer-source)的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号