讲师中心 微信公众号
AI工具推荐 视频效率加速

Composer怎么安装离线包 Composer怎么进行离线部署【离线】

冬瑶君_8701

冬瑶君_8701

发布时间:2026-03-11 10:11:02

|

624人浏览过

|

来源于php中文网

原创

离线安装 Composer 需先在联网机下载校验 composer.phar 再拷贝至离线机;部署项目依赖须用 vendor/ + composer.lock,执行 composer install --no-plugins --no-scripts,并确保 PHP 环境一致。

composer怎么安装离线包 composer怎么进行离线部署【离线】

离线安装 Composer 本身要分两步走

Composer 不是单个二进制文件,离线装它,核心是:先在有网机器上下载 composer.phar,再拷到目标机器。别试图用包管理器(如 apt/yum)离线装——它们默认依赖在线源,且版本老旧、不保证兼容 PHP 新特性。

常见错误现象:curl: (7) Failed to connect to getcomposer.org port 443 或执行 php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" 直接失败。

  • 推荐做法:在能联网的同 PHP 版本环境里,用官方脚本生成带哈希校验的 composer.phar
  • 命令顺序必须是:php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" → php -r "if (hash_file('sha384', 'composer-setup.php') === 'e0012edf3e80b6978849f5eff0d4b4e4c79ff1609dd1f6a331a8365dfe33b4d8d826ad669113f128fd004e28787949af298b')(用当前官网提供的最新哈希值替换)→ php composer-setup.php → php -r "unlink('composer-setup.php');"
  • 生成后直接把 composer.phar 拷到离线机,加执行权限:chmod +x composer.phar,建议放系统路径如 /usr/local/bin/composer(软链或重命名都行)

离线部署项目依赖靠 vendor + lock 文件组合

离线部署不是“不用网络”,而是“不依赖远程仓库”。关键在于:所有包必须提前下载好,且 composer.lock 必须存在、内容完整。没有 lock 文件,composer install 在离线时会报错 Could not find package ... in a version installable using your PHP version。

使用场景:CI 构建机拉完依赖后打包整个 vendor/ 和 composer.lock,传到生产服务器。

Discussion Composer
Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载
  • composer install 是离线部署唯一合法命令;composer update 必须禁用(它会连 packagist.org)
  • 确保 composer install 执行前,vendor/ 是空的或已删干净——残留旧包可能引发 autoloader 冲突
  • 若项目用了私有包(如 GitLab 私仓),需提前把对应 Git 仓库 clone 到本地,并在 composer.json 中用 path 类型仓库声明:"repositories": [{"type": "path", "url": "/path/to/local/package"}]
  • PHP 版本和扩展(如 ext-zip、ext-openssl)必须与构建机一致,否则即使 vendor 完整,autoload.php 也可能 require 失败

离线时 vendor 包体积大?压缩和校验不能省

vendor 动辄百 MB,传输中出错很难察觉。直接 tar.gz 不够,必须附带校验机制,否则解压后跑不起来,排查成本远高于多加一步。

性能影响:未压缩的 vendor 上传慢、占空间;但过度压缩(如 xz)会增加解压 CPU 开销,对低配服务器不友好。

  • 推荐打包命令:tar -czf vendor.tar.gz vendor/ && sha256sum vendor.tar.gz > vendor.tar.gz.sha256
  • 离线机解压前先校验:sha256sum -c vendor.tar.gz.sha256,失败就停,别硬解
  • 别用 zip 归档 —— Windows 下换行符、权限位容易丢,tar 在 Linux/macOS 下更可靠
  • 如果项目含大量 dev-dependencies(如 phpunit),构建时加 --no-dev 参数,减小体积、避免误引入测试类到生产环境

离线环境下插件和脚本执行常被忽略

有些包带 scripts(比如 post-install-cmd),或依赖 composer-plugin-api 的插件(如 hirak/prestissimo),这些在离线时不会自动跳过,反而会卡住或报错。

容易踩的坑:以为 vendor 拷过去就万事大吉,结果 composer install 卡在 “Loading plugin hirak/prestissimo” 或执行 php artisan optimize(Laravel)失败。

  • 构建阶段就禁用插件:composer install --no-plugins --no-scripts,然后手动补运行必要脚本(如生成 autoload)
  • 确认 composer.json 里没写死需要联网的脚本,例如调用 curl 或 git pull 的自定义命令
  • 某些插件(如 composer-asset-plugin)已废弃,但旧项目 lock 文件里还留着,会导致离线 install 报 Plugin installation failed,得手动删掉 composer.lock 里的相关条目再重试
事情说清了就结束。最麻烦的永远不是“怎么打包”,而是构建机和目标机之间 PHP 行为差异、扩展缺失、甚至 umask 导致的文件权限问题——这些没法靠文档覆盖,得真刀真枪比对 php -m 和 php --ini 输出。

热门AI工具

更多
PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

837

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

815

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2468

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3681

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

5210

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

3496

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

6609

2025.08.05

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

1376

2026.03.04

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

80

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn