离线安装唯一合法命令是 composer install,需预先存在 composer.lock 且清空 vendor;必须统一 PHP 版本与扩展,禁用 path 类型仓库,打包前确保 dist 包或补全 .gitignore 排除文件。

离线安装包必须用 composer install,不是 composer require
离线时执行 composer require 会直接报错 Could not find package,因为它硬依赖网络查询 Packagist。唯一合法命令是 composer install,前提是当前目录下已有完整的 composer.lock 和干净的 vendor/(或为空)。批量配置的本质,是让多个项目共享同一套已验证的依赖快照。
- 所有项目必须共用一份原始
composer.lock—— 它不是“建议”,而是离线安装的校验凭据 - 每个项目根目录下都要有该
composer.lock,且不能手动编辑(哈希不匹配会导致跳过安装) - 执行前务必清空目标项目的
vendor/:用rm -rf vendor/或composer install --no-autoloader --dry-run预检 - 若某项目需额外 dev 包,应在生成 lock 文件时就用
composer install --no-dev统一裁剪,避免离线时因--no-dev参数缺失导致失败
批量部署前必须统一 PHP 环境和扩展
不同 PHP 小版本(如 8.2.10 vs 8.2.12)或缺失 mbstring、openssl 扩展,会导致 vendor/autoload.php 加载失败或类找不到。这不是 Composer 报错,而是运行时报错,离线环境下极难定位。
- 源机(打包机)和所有目标机必须运行相同 PHP 版本(
php -v输出完全一致) - 用
php -m核对关键扩展:至少包含json、curl、openssl、mbstring、zip - 在源机执行
composer install --no-dev --optimize-autoloader后,立即测试 autoload:php -r "require 'vendor/autoload.php'; echo class_exists('Psr\Log\LoggerInterface') ? 'OK' : 'FAIL';" - 目标机解压后,优先运行
composer dump-autoload -o,可修复 symlink 路径错乱或权限问题
path 类型仓库适合多项目本地同步开发,但不适用于离线部署
用 "type": "path" 在 repositories 中引用 ../shared-lib,确实能实现多项目实时共享一个本地包,但它依赖符号链接,在离线部署到生产环境时会失效——因为 vendor/ 目录被整体拷贝后,symlink 指向的是源机路径,而非目标机相对结构。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 开发阶段可用:
composer require myorg/core:dev-main+path仓库,改代码立刻生效 - 但发布前必须切换回标准包引用:删掉
path配置,改用"myorg/core": "^2.0"并重新composer update --lock生成真实 dist 信息 - CI 流水线中禁止保留
path仓库配置,否则composer install在离线构建节点上会报Source path ../shared-lib does not exist - 若真要复用代码,应走 Git 私有仓库 + tag 版本,而非文件系统路径
批量打包 vendor 要绕过 .gitignore 干扰
直接 tar -czf vendor.tgz vendor/ 可能漏掉某些包里被 .gitignore 排除但运行必需的文件(比如 resources/ 或预编译的 dist/ 目录),尤其常见于前端集成类包(如 laravel-mix)。
- 打包前先在源机进入
vendor/,执行find . -name '.gitignore' -exec dirname {} \; | xargs -I{} sh -c 'cd {}; git check-ignore -v * 2>/dev/null | cut -d" " -f3-'快速扫描哪些子目录受忽略影响 - 更稳妥做法:用
composer install --no-dev --prefer-dist --no-scripts确保只拉 dist 包(ZIP 形式),再打包;dist 包不含 Git 元数据,不受.gitignore干扰 - 若必须含 source 包(如调试需要),则打包前先
git ls-files --others --exclude-standard -z | xargs -0 tar -rf vendor.tar补全被忽略但未跟踪的文件 - 目标机解压后,检查关键包是否存在
src/和dist/目录,例如ls -l vendor/monolog/monolog/{src,dist}
批量配置的复杂点不在命令本身,而在于环境一致性验证必须前置——没跑通 php -r "require 'vendor/autoload.php';" 的 vendor,无论打包多整齐,到目标机就是不可用的。很多人卡在“明明 vendor 拷过去了却 Class not found”,问题八成出在 PHP 小版本或扩展缺失,而不是 Composer 命令写错。

















