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的项目骨架。
使用
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
目录的源代码分发包。当你需要
