离线部署Composer必须提前在联网环境准备完整安装包,包括可执行文件、PHP依赖、可信签名及镜像源配置;断网服务器需严格校验PHP版本、扩展、时间同步及权限,禁用所有网络命令。

断网服务器上不能直接运行 curl 或 php -r "copy(...)" 下载 Composer 安装脚本,必须提前在有网环境准备所有依赖文件,再离线搬运部署。
先在联网机上打包完整安装包
离线安装的核心是把 Composer 运行所需的一切“静态化”:可执行文件、PHP 运行时依赖、可信签名、镜像源配置。不能只拷一个 composer.phar 就完事。
- 用和目标服务器完全一致的 PHP 版本(包括 minor 版本,如 8.2.15)执行安装,避免扩展缺失或 ABI 不兼容
- 执行三步校验安装:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"→php -r "echo hash_file('sha384', 'composer-setup.php');"对比官网公布的 SHA384 值 → 确认后才运行php composer-setup.php --install-dir=/tmp/composer-bin --filename=composer - 同时生成一份最小化镜像配置:运行
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/(或阿里云地址),然后手动提取~/.composer/config.json文件 - 最后打包:
tar -czf composer-offline.tgz /tmp/composer-bin/composer ~/.composer/config.json
离线服务器上验证 PHP 环境是否真可用
很多断网服务器看似装了 PHP,但缺关键扩展或权限受限,导致 composer.phar 加载失败——错误常被掩盖成 “failed to open stream”,实际是 ext-openssl 或 ext-zip 没启用。
- 检查必需扩展:运行
php -m | grep -E "openssl|zlib|json|mbstring|curl|zip",缺任何一项都可能让 Composer 在解析composer.json或解压 dist 包时静默崩溃 - 确认 CLI 和 Web 使用的是同一个 PHP 配置:
php --ini输出的配置路径,应与宝塔或 Apache 的php.ini一致;否则putenv被禁用(常见于宝塔安全设置)会导致卡在 “Loading composer repositories” - 测试基础功能:把
composer.phar拷过去后,先运行php composer.phar --version,而不是直接php composer.phar install
全局命令失效?别硬加 PATH,改用绝对路径调用
断网服务器通常权限收紧,/usr/local/bin 不在 www-data 或 nginx 用户的 PATH 中,且修改 PATH 后还要重启服务才能生效——不现实。更稳的方式是绕过 PATH。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 把
composer放到项目目录下,比如/www/wwwroot/myapp/composer,并确保它有执行权限:chmod +x /www/wwwroot/myapp/composer - 部署脚本里统一用绝对路径调用:
/www/wwwroot/myapp/composer install --no-dev --optimize-autoloader --no-interaction - 如果必须全局可用,用软链而非移动:
sudo ln -sf /www/wwwroot/myapp/composer /usr/local/bin/composer,避免因 SELinux 或 Capabilities 导致权限丢失
没有 composer.json 怎么办?别用 create-project
有人想在断网机上用 composer create-project laravel/laravel 初始化项目,这注定失败——它需要实时拉取 packagist 元数据和 ZIP 包。离线环境只能靠预构建。
- 在联网机上用目标框架的稳定 tag 构建好完整项目(含
vendor/、composer.lock、已生成的 autoload),再整体打包同步 - 若需定制依赖,先在联网机运行
composer require foo/bar --no-update修改composer.json,再composer update --no-dev --lock锁定并下载所有 dist 包,最后把整个vendor/打包带走 - 离线服务器上禁止运行任何带网络行为的命令:
composer update、composer search、composer diagnose(它会尝试 ping packagist)全都会卡死或报错
最易被忽略的一点:离线服务器上的 date 时间不准,会导致 HTTPS 证书校验失败——哪怕你已经把所有文件拷过去了,php composer.phar install 仍可能停在 “Resolving dependencies” 并无任何提示。务必先运行 date 核对,偏差超 3 分钟就用 chronyd -q -s 同步一次。










