composer archive不支持私有化分发，它仅打包已安装包的快照，不含源码、autoload配置及依赖锁定；私有分发需先用composer install --no-dev --prefer-dist生成干净vendor，再配合composer.lock、dist预下载和--repository-url=file://离线仓库实现。
Composer archive 命令本身不支持私有化分发
直接用 composer archive 打包项目，只会把 vendor/ 里已安装的包压缩成 zip，不包含源码、不处理 autoload、不解决依赖版本锁定问题——它本质上是个“快照打包工具”，不是分发方案。
想实现 PHP 核心逻辑离线私有化分发，得绕过 archive，改用更可控的组合方式：
-
composer install --no-dev --optimize-autoloader --prefer-dist确保 vendor 干净且加载高效 - 手动把
composer.json和composer.lock一并打进包（否则离线环境无法复现依赖） - 若含私有包（如 GitLab 私仓），必须提前用
composer config repositories.xxx配置好镜像或 dist URL，否则 archive 后的包在离线机上composer install会卡在“找不到包”
离线分发必须带完整 vendor + lock 文件
只传 composer.json 给客户，等于没给。没有 composer.lock，composer install 会重新解析依赖树，可能拉到不兼容的新版——尤其当私有包未打 tag 或分支不稳定时，结果不可控。
实操建议：
- 打包前运行
composer install --no-dev --ignore-platform-reqs（避免因目标机 PHP 版本低而失败） - 检查
vendor/composer/installed.json是否存在，它是 autoload 的依据，缺失会导致Class not found - 如果核心逻辑含扩展（如
ext-redis），需在文档中明确列出php.ini依赖项，不能指望 composer 自动处理
私有包离线可用的关键：dist 包预下载 + 替换 URL
默认情况下，私有 Git 仓库走 source 模式（clone），离线即失败。必须强制转为 dist 模式，并把 tarball 提前下好。
操作步骤：
- 在联网环境执行
composer config --global repo.packagist.org false关闭 Packagist - 为私有包配置 dist：
composer config repositories.myprivatelib package '{"packagist.org":false,"type":"package","package":{"name":"myorg/mylib","version":"1.2.3","dist":{"url":"https://internal.example.com/dist/mylib-1.2.3.zip","type":"zip"}}}' - 再跑
composer update myorg/mylib --no-dev，此时会下载并缓存该 zip 到~/.composer/cache/files/ - 打包时把整个
~/.composer/cache/files/对应目录复制进分发包，供离线机通过composer config cache-files-dir指向使用
离线环境 composer install 失败的三个高频原因
不是命令写错，而是环境假设错了：
-
Could not fetch https://repo.packagist.org/packages.json：没关 Packagist，也没设--repository-url=file:///path/to/mirror -
Failed to download myorg/mylib: file could not be downloaded (HTTP 404)：dist URL 是相对路径或内网地址，离线机访问不到；应改用本地file://协议，例如"url":"file:///mnt/dist/mylib-1.2.3.zip" -
Class XXX not found：autoload 未重生成，必须在离线机上运行composer dump-autoload --optimize，不能跳过
真正麻烦的从来不是打包，而是让离线机相信“这些文件就是全部依赖”，这需要提前验证 vendor 目录完整性、autoload 映射正确性、以及所有 require 的扩展是否就位——少一个环节，上线就报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
