使用。gitattributes 文件中的 export-ignore 指令可有效排除 composer 包发布时的无关文件,如测试、示例等目录,确保 dist 包简洁;也可在 composer.json 中配置 archive.exclude 实现类似效果,但优先级低于。gitattributes;若需项目安装时精简依赖,应联系维护者优化或寻找轻量替代方案。

Composer 本身在安装和更新依赖时,主要处理的是 vendor 目录下的包文件,它不会自动把你的项目源码打包发布。但如果你是创建一个 Composer 包(比如类库),并希望在分发时排除某些文件或目录(如测试文件、文档、示例代码等),可以通过配置 composer.json 中的 archive 配置或使用 .gitattributes 文件来实现。
1. 使用 .gitattributes 排除文件(推荐用于 Git 仓库)
如果你的包托管在 Git 上,并通过 Composer 的 dist 方式分发(即打 tag 后发布的压缩包),Composer 会基于 Git 的归档机制生成压缩包。这时可以使用 .gitattributes 文件来指定哪些文件在打包时被排除。
在项目根目录创建或编辑 .gitattributes 文件:
/tests export-ignore
/examples export-ignore
/.gitattributes export-ignore
/README.md export-ignore
上面的配置表示:在执行 git archive(也就是 Composer 下载 dist 包时)会忽略这些文件或目录。
2. 在 composer.json 中定义 archive 配置
你也可以在 composer.json 中明确指定哪些文件包含或排除在归档包之外(适用于更精细控制):
{“name”: “your-vendor/your-package”, “archive”: { “exclude”: [ “/tests/”, “/examples/”, “/*.md”, “/config-dev.php“, “/var/” ] } }
注意 :该功能需要确保你使用的打包 工具 支持此配置(如 composer archive 命令或 CI 构建流程中正确处理)。不是所有环境都默认启用此行为,尤其是当包从 Git 自动构建时,仍以 .gitattributes 为准。
3. 不想让某些文件进入 vendor(项目依赖中)
如果你是项目开发者,只是不想某些依赖中的文件被加载或影响项目,Composer 本身不提供“安装依赖时排除其子文件”的功能。但你可以:
- 联系包维护者优化其
.gitattributes - 使用脚本在
post-autoload-dump或post-install-cmd中手动删除不需要的文件(不推荐,破坏完整性) - 考虑是否真的需要该依赖,或寻找更轻量替代方案
基本上就这些方法。最常用且可靠的是 .gitattributes + export-ignore,适合大多数开源 php 包的发布场景。只要打好标签,Composer 自动获取的 dist 包就会干净。
以上就是 Composer 如何排除特定的文件或目录的详细内容,更多请关注 php 中文网其它相关文章!