如何使用 Composer 的 archive 命令将项目打包成 zip 文件？

Composer 本身不提供公开的 archive 命令，其内部 archive 命令为隐藏功能，仅用于 Packagist 构建，用户执行会报错；推荐使用 composer install --no-dev --optimize-autoloader 配合系统 zip 工具，或 Composer 2.5+ 的实验性 pack 命令。

Composer 本身没有 archive 命令。官方 Composer 只提供 archive 作为内部命令（用于打包包分发），但**不对外公开使用**，也不支持直接通过 composer archive 打包当前项目。

为什么不能直接用 composer archive？

Composer 的 archive 是一个隐藏命令（Composer\Command\ArchiveCommand），仅在构建包时由 Packagist 或 composer pack（v2.5+ 实验性功能）间接调用，未开放给用户手动执行。运行 composer archive 会报错或提示“command not found”。

替代方案：用 composer install + 外部工具打包

标准做法是先生成可部署的精简项目（不含开发依赖和源码），再用系统命令压缩：

• 运行 composer install --no-dev --optimize-autoloader，确保 vendor/ 完整且只含运行时依赖
• 删除不需要发布的文件（如 .git、tests/、README.md 等），可用 .gitattributes 或 composer.json 的 archive 字段控制
• 用系统命令打包：
  Linux/macOS：zip -r project-release.zip . -x "node_modules/*" ".git/*" "tests/*"
  Windows（PowerShell）：Compress-Archive -Path . -DestinationPath project-release.zip -Exclude node_modules, .git, tests

进阶：用 composer.json 的 archive 配置自动过滤

在 composer.json 中添加 archive 字段，定义哪些路径在打包时被排除（适用于 composer pack 或第三方工具读取）：

"archive": {
  "exclude": [
    "/.git",
    "/.gitignore",
    "/tests",
    "/docs",
    "/docker-compose.yml"
  ]
}

⚠️ 注意：这个配置不会让 composer archive 变得可用，但部分 CI 工具或自定义脚本会识别它。

推荐：用 composer pack（Composer 2.5+）

Composer 2.5 引入了实验性命令 composer pack，可按配置生成归档包：

• 确保已安装 Composer 2.5 或更高版本（composer --version 查看）
• 运行 composer pack --format=zip，它会基于 composer.json 和 archive.exclude 生成 vendor-bin/{name}-{version}.zip
• 若需自定义输出路径，配合 --output-dir=dist 使用

基本上就这些。Composer 不提供开箱即用的 archive 命令，但用 install 加系统 zip 工具，或升级到 2.5+ 用 pack，都能可靠完成打包。不复杂但容易忽略版本和配置细节。