Composer archive排除文件忽略特定文件打包技巧【进阶】_网络技术

Composer archive排除文件忽略特定文件打包技巧【进阶】

发布时间 - 2026-01-25 00:00:00 点击率：次

composer archive 默认仅依据 .gitignore 和 .gitattributes 过滤文件，不识别 .dockerignore、autoload.exclude 等；推荐用 .gitattributes 精确控制，或 Composer 2.2+ 的 config.archive.excludes 配置。

composer archive 命令默认打包哪
些文件

composer archive 不是 Composer 的核心命令，它来自 composer/composer 自带的归档功能（实际由 Composer\Command\ArchiveCommand 实现），但默认行为非常简单粗暴：只按 .gitignore 和 .gitattributes 过滤，不读 .dockerignore、不认 exclude-from-classmap、也不管 autoload.exclude。

这意味着：

如果你没配 .gitignore，它会把 vendor/、tests/、phpunit.xml 全塞进去
如果你用的是 SVN 或没有版本控制，composer archive 会直接打包整个目录（包括 node_modules）

用 .gitattributes 精确控制 archive 排除项

这是最可靠、最被 composer archive 原生支持的方式。它优先级高于 .gitignore，且明确用于归档过滤。

在项目根目录创建或编辑 .gitattributes，写入：

vendor/ export-ignore
tests/ export-ignore
phpunit.xml export-ignore
.dockerignore export-ignore
*.md export-ignore

注意点：

每行一个路径模式，结尾必须加 export-ignore（不是 export-ignore 的其他值会被忽略）
路径是相对于项目根的，不支持通配符如 */cache/，只支持前缀匹配（cache/ 可以，/cache/ 不行）
.gitattributes 本身不会被打包（Composer 内部硬编码排除了它）
修改后无需 git add -f，composer archive 直接读取文件内容

为什么 ignore-platform-reqs 不影响 archive

这是常见误解：--ignore-platform-reqs 是给 install / update 用的，和打包完全无关。archive 过程不解析 composer.json 中的 platform 或 config.platform，也不会跳过任何 require-dev 包——它只管“文件是否存在+是否被 export-ignore 标记”。

所以：

即使你加了 --ignore-platform-reqs，composer archive 仍会把 vendor/ 下所有已安装的包源码（含 dev 包）全打进去（如果没被 .gitattributes 排除）
若你真想排除 vendor/，唯一办法就是用 .gitattributes 显式声明 vendor/ export-ignore
想只打包源码不带依赖？那 composer archive 不是合适工具，应改用 git archive 或自定义 tar 命令

替代方案：用 composer config archive.excludes 更灵活

从 Composer 2.2+ 开始，支持在 composer.json 里声明归档排除规则（比 .gitattributes 更直观，且不依赖 Git）：

{
    "config": {
        "archive": {
            "excludes": [
                "/vendor",
                "/tests",
                "/.env*",
                "/phpstan.neon"
            ]
        }
    }
}

关键细节：

路径以 / 开头表示项目根相对路径（/vendor ≠ vendor/）
支持 glob（/.env* 有效，/*/.log 无效）
该配置仅被 composer archive 读取，不影响 install/update
如果同时存在 .gitattributes 和 config.archive.excludes，两者叠加生效（不是覆盖）
注意斜杠方向：Windows 用户也必须用 /，Composer 会自动转换

真正容易被忽略的是：这个配置只在本地运行 composer archive 时起作用；CI 环境若用的是旧版 Composer（composer --version 校验。

# php # js # git # json # node # docker # composer # windows # 编码 # 工具 # win # 为什么 # require # xml # svn # 的是 # 这是 # 会把 # 自定义 # 不支持 # 你没 # 只在 # 自带 # 真想 # 不带

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：如何解决PHP项目中需要使用HeadlessChrome的需

下一篇：1帕斯卡等于多少压强气压单位换算与物理常识

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：如何解决PHP项目中需要使用HeadlessChrome的需

下一篇：1帕斯卡等于多少压强气压单位换算与物理常识