在无Git服务器部署PHP项目时，需强制Composer使用dist包。应提交composer.lock文件，并在部署时执行composer install --no-dev --prefer-dist，确保依赖从压缩包安装而非源码克隆，避免因缺少Git导致失败。
理解 --prefer-dist 参数
Composer 支持两种获取依赖包的方式：source 和 dist。
- source：通过版本控制系统（如 Git）克隆源码，适合开发环境。
- dist：下载预构建的压缩包（通常是 ZIP 或 TAR），适合生产部署。
在无 Git 的服务器上，必须使用 --prefer-dist 参数，告诉 Composer 优先从 dist 包中安装依赖，避免因缺少 Git 而失败。
确保 composer.lock 文件已提交
为了保证部署的一致性和可重复性，应在本地或 CI 环境中先运行：
composer install --prefer-dist
这会生成或更新 composer.lock 文件，记录所有依赖的确切版本和分发方式。将此文件提交到版本控制中，确保服务器拉取的是锁定版本。
服务器部署时只需执行：
composer install --no-dev --prefer-dist
其中：
-
--no-dev排除开发依赖，节省空间并提高安全性。 -
--prefer-dist强制使用 dist 包，不尝试克隆源码。
处理私有包或镜像问题
如果项目依赖私有仓库，这些包可能默认配置为 source 方式。即使使用 --prefer-dist，Composer 仍可能尝试克隆。
解决方案是在 composer.json 中为私有包显式指定 dist 地址：
"repositories": [
{
"type": "package",
"package": {
"name": "vendor/private-package",
"version": "1.0.0",
"dist": {
"url": "https://example.com/packages/private-package-1.0.0.zip",
"type": "zip"
},
"autoload": {
"psr-4": { "Private\\": "src/" }
}
}
}
]
这样 Composer 会直接下载 ZIP 包，完全不需要 Git。
优化部署流程
为提升部署效率，可以结合以下做法：
- 在 CI/CD 中构建完整 vendor 目录后打包上传，服务器直接解压，跳过 Composer 安装。
- 使用
composer config preferred-install dist将 dist 设为默认策略。 - 启用 Composer 全局缓存，加快重复依赖的安装速度。
若服务器完全离线，可在有网络的环境中执行 composer install --prefer-dist，然后将整个项目目录同步过去。
--prefer-dist，就能在无 Git 环境中顺利部署 Composer 项目。关键是提前规划好依赖来源，避免现场出错。 
