composer archive 的核心作用是为 Composer 项目或 Packagist 包创建干净的压缩包，排除 VCS 文件和开发依赖，适用于源码分发与部署；其命令可指定格式、路径与文件名，支持从 Packagist 直接归档特定版本包；与 git archive 不同，它基于 composer.json 理解项目结构，默认不包含 vendor 目录，强调源代码打包而非完整依赖；常用于生成轻量级源码包，配合 .gitattributes 的 export-ignore 可进一步精简内容，适合发布开源项目或构建分发包，但需注意它不生成含依赖的部署包，此类场景应结合 composer install –no-dev 后使用通用压缩工具完成。
composer archive
命令的核心作用，简而言之，就是为你当前的 Composer 项目，或者 Packagist 上的某个特定包，创建一个干净的压缩包。这个压缩包通常会排除版本控制系统（VCS）的相关文件（比如
.git
目录）以及开发依赖，使得它非常适合用于发布源代码、部署应用或者作为分发包。它就像一个贴心的打包工，帮你把项目整理得整洁利落，只留下你真正需要的部分。
当我们谈到
composer archive
的具体用法，其实它比我们想象的要灵活一些。最基础的命令形式是
composer archive
，直接在你当前项目的根目录运行，它会生成一个以项目名称和版本号命名的
zip
压缩包，默认放在当前目录下。
比如说，如果你有一个名为
my-awesome-app
的项目，版本是
1.0.0
，那么运行
composer archive
可能会得到
my-awesome-app-1.0.0.zip
。这个包里，你会发现
.git
目录不见了，那些只在开发环境需要的
vendor
目录下的包（如果你之前
composer install
时没有加
--no-dev
）也可能不会被包含进去，因为它默认是打包源代码。
更高级一点，你可以指定输出格式、目录和文件名：
composer archive --format=tar.gz --dir=/tmp/builds --file=my-app-release.tar.gz
这会生成一个
tar.gz
格式的压缩包，放在
/tmp/builds
目录下，文件名为
my-app-release.tar.gz
。这在自动化部署脚本里特别有用，你可以精确控制输出。
还有一个不那么常用但很有意思的用法，是针对 Packagist 上的特定包进行归档。
composer archive symfony/symfony 5.4.0 --dir=/tmp
这条命令会从 Packagist 下载
symfony/symfony
的
5.4.0
版本，并将其归档到
/tmp
目录下。这在你需要某个特定版本包的纯源码时非常方便，而不用去克隆整个 Git 仓库。
需要注意的是，
composer archive
在处理当前项目时，默认会排除
vendor
目录。这是它和
zip -r
等通用压缩命令最大的区别之一。它更倾向于打包“你的代码”，而不是“你的代码 + 依赖”。如果你想包含
vendor
目录用于部署，通常你需要一些额外的步骤，这我们后面会聊到。
composer archive
和
git archive
有什么不同？
这个问题我经常被问到，因为两者听起来都是“打包”或“归档”。但实际上，它们的侧重点和应用场景有着本质的区别。在我看来，理解这一点对于选择合适的工具至关重要。
git archive
，顾名思义，是 Git 的一个功能。它基于你的版本控制历史，从某个特定的提交（commit）、分支或标签中提取出项目文件，然后打包。它的核心逻辑是“从 Git 仓库中导出文件”。这意味着它会排除
.git
目录，但会包含所有被 Git 跟踪的文件。如果你在项目里有一些 Git 忽略但实际需要的文件（比如某些配置文件，或者一个自己编译的二进制文件），
git archive
会把它们包含进去，前提是它们没有被
.gitignore
排除。它的优势在于能够精确地从版本历史的任何一个点生成一个干净的快照。
而
composer archive
，它是一个 Composer 命令，它的“视野”更广，更“懂”你的 PHP 项目。它不仅会排除 VCS 文件，更重要的是，它理解
composer.json
和
composer.lock
。当你在当前项目运行
composer archive
时，它会创建一个只包含你项目源代码的压缩包，默认情况下，它不会包含本地的
vendor
目录。这是因为它认为
vendor
目录里的内容是可以通过
composer install
重新生成的。在我看来，这种设计哲学体现了 Composer 作为依赖管理器的核心思想：你的代码和你的依赖是两回事，依赖是动态生成的。
此外，
composer archive
还能直接从 Packagist 获取并归档一个特定的包，这是
git archive
无法做到的。
git archive
只能处理本地或远程 Git 仓库的某个分支或标签。所以，如果你需要一个干净的、不带 VCS 历史、且不包含本地
vendor
目录的项目源代码分发包，
composer archive
是首选。如果你只是想从 Git 仓库中导出特定版本的所有跟踪文件（包括那些不是 Composer 依赖的文件），那么
git archive
更合适。它们是互补的，而非替代品。
如何为项目生成一个干净的源代码分发包？
生成一个干净的源代码分发包，这正是
composer archive
的拿手好戏。很多时候，我们并不想把整个 Git 仓库，或者本地庞大的
vendor
目录一起打包分享出去。我们希望给别人的是一个精简、纯粹、可以直接进行
composer install
的项目骨架。
AppMall应用商店
AI应用商店，提供即时交付、按需付费的人工智能应用服务
56 查看详情
使用
composer archive
来做这件事非常直接：
确保你的
composer.json
配置正确。 这是基础，所有依赖都应该正确声明，并且
autoload
配置也要准确无误。在项目根目录运行命令。
composer archive --format=zip --dir=/tmp/releases --file=my-project-source-v1.0.0.zip
这条命令会：在
/tmp/releases
目录下创建一个名为
my-project-source-v1.0.0.zip
的压缩包。这个压缩包里只包含你项目自身的源代码文件。它会自动排除
.git
、
.svn
等版本控制相关目录。关键点： 它会排除你本地已存在的
vendor
目录。这意味着接收方拿到这个包后，需要自己运行
composer install
来安装依赖。
我个人觉得这种方式非常符合“分发源代码”的语义。想象一下，你要把你的开源项目发布到 GitHub release 页面，或者提供一个下载链接给用户自行安装，你肯定不希望用户下载一个几百兆甚至上 G 的压缩包，里面包含了他们可能根本不需要的开发依赖，甚至还有你的 Git 历史。一个轻量级的源代码包，让用户根据自己的环境来安装依赖，这才是最佳实践。
当然，如果你是为了一个完整的部署包（即包含
vendor
目录，可以直接上传到服务器运行），那么
composer archive
本身可能不是你最后一步的工具。在这种情况下，我通常会这样做：先在一个干净的环境里（比如 CI/CD 流程中）克隆项目，然后运行
composer install --no-dev --optimize-autoloader
来安装生产环境依赖，确保
vendor
目录生成。接着，我会使用
zip -r
或
tar -czf
这样的通用压缩命令，把整个项目目录（包括新生成的
vendor
目录）打包。所以，
composer archive
更多是用于“源代码分发”，而不是“完整部署包”的直接生成。
使用
composer archive
时有哪些常见的坑或最佳实践？
在实际使用
composer archive
的过程中，我遇到过一些让我挠头的情况，也总结了一些经验，希望能帮助你避开一些不必要的麻烦。
一个比较常见的“坑”就是，误以为
composer archive
会打包当前项目中的
vendor
目录，从而生成一个“开箱即用”的部署包。 就像我前面提到的，
composer archive
的设计理念是打包源代码，它会主动排除本地的
vendor
目录。如果你期望它能直接生成一个包含所有依赖的部署文件，你可能会失望。我记得有一次，我就是想快速打个包部署，结果发现上传到服务器的包里没有
vendor
，导致应用直接报错。后来才意识到，对于包含
vendor
的部署包，我得手动
zip
整个项目目录，或者在 CI/CD 流程中先
composer install --no-dev
再打包。
另一个小细节是关于
.gitattributes
的作用。
composer archive
在生成压缩包时，会尊重你的
.gitattributes
文件中定义的
export-ignore
规则。这意味着，如果你在
.gitattributes
里指定了某些文件或目录在导出时应该被忽略，
composer archive
也会照做。这其实是一个非常好的特性，可以帮助你进一步精简分发包。比如，你可以把一些只在本地开发使用的工具脚本或者测试文件通过
export-ignore
排除掉。
至于最佳实践，我个人觉得：
明确用途：
composer archive
最适合的场景是生成一个干净的、不含 VCS 历史和本地
vendor
目录的源代码分发包。当你需要
以上就是composer archive命令怎么用的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/541828.html
微信扫一扫 
支付宝扫一扫 
