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,都能可靠完成打包。不复杂但容易忽略版本和配置细节。










