composer archive 命令在 Composer 2.0 中已被彻底移除,因其设计缺陷和低使用率;现应通过 composer install --no-dev --optimize-autoloader 结合系统归档工具完成生产打包。

直接用 composer archive 无法生成归档文件 —— 这个命令早在 Composer 2.0 就被彻底移除了。
为什么找不到 composer archive 命令?
Composer 官方在 v2.0 版本(2020 年底发布)中正式删除了 archive 子命令。它曾用于打包当前项目(含依赖),但因设计缺陷和使用率低被弃用。现在执行 composer archive 会报错:Command "archive" is not defined.
如果你看到旧文档或教程还在提这个命令,说明内容已过时。
替代方案:用 composer install --no-dev --optimize-autoloader 配合系统归档工具
实际生产打包的核心目标是:只保留运行时必需的代码(不含开发依赖、测试文件、.git 目录等),再压缩成 .zip 或 .tar.gz。正确流程如下:
- 确保
composer.json中的autoload和autoload-dev配置合理,避免自动加载无关类 - 运行
composer install --no-dev --optimize-autoloader --no-scripts,生成精简的vendor/ - 手动排除不需要的目录,例如:
vendor/bin/、vendor/*/tests/、vendor/*/Tests/、.git/、node_modules/ - 用系统命令打包(Linux/macOS):
zip -r app-release.zip . -x "*.git*" "vendor/*/tests/*" "vendor/*/Tests/*" "vendor/bin/*" "composer.lock"
(注意:排除composer.lock通常不推荐,除非你明确不需要锁定版本) - Windows 用户可用 7-Zip 命令行或 PowerShell 的
Compress-Archive,但需自行过滤路径
更可靠的做法:用 composer create-project + 自定义脚本
对于需要频繁发布的项目(如 Laravel 包、SaaS 后端),建议把打包逻辑写进脚本,而不是依赖 Composer 内置功能。例如在项目根目录加一个 build.sh:
#!/bin/bash rm -rf build/ mkdir build/ cp -r src/ public/ composer.json autoload.php build/ cd build composer install --no-dev --optimize-autoloader --quiet cd .. zip -r myapp-$(date +%Y%m%d).zip build/ -x "build/vendor/*/tests/*"
这样能完全控制哪些文件进包、哪些被忽略,也便于 CI/CD 集成。
真正容易被忽略的是:很多团队直接 zip 整个目录,结果把 vendor/composer/autoload_*.php 里的绝对路径缓存也打了进去 —— 这些路径在其他机器上会失效。务必用 --optimize-autoloader 生成可移植的扁平加载器,而不是依赖生成时的本地路径。










