怎么配置离线服务器的Composer依赖缓存环境-composer-PHP中文网

不能直接复制其他项目的vendor目录，因autoload规则、minimum-stability、插件状态及post-autoload-dump脚本（含绝对路径）差异会导致类找不到、插件未加载或自动加载错乱；应复用composer缓存并配合--prefer-dist --no-scripts安装。

怎么配置离线服务器的composer依赖缓存环境

离线服务器必须复用 composer cache，不能拷 vendor 目录

直接把其他项目的 vendor 目录复制到离线服务器上，99% 会出错：类找不到、插件不加载、autoload.php 生成失败，甚至某些包的 post-autoload-dump 脚本因写入绝对路径而崩溃。根本原因在于 autoload 规则、minimum-stability、插件启用状态、PHP 版本兼容性等都和原项目强绑定。

真正可复用的只有 Composer 下载下来的原始 dist 包（.zip/.tar.gz），它们存在本地缓存目录里，不带环境痕迹，解压即用。

~/.composer/cache/files/（Linux/macOS）或 %APPDATA%\Composer\Cache\files\（Windows）是默认缓存位置
只要目标服务器架构一致（x86_64/arm64）、PHP 版本兼容、且缓存未被清空，composer install 就能跳过所有下载
必须确保离线机上的 COMPOSER_CACHE_DIR 环境变量指向该目录，或手动改 ~/.composer/config.json 中的 cache-dir 字段

打包并迁移 composer 缓存的实操步骤

在联网机器上执行一次完整安装，让缓存填满；再整体打包迁移，不是只拷几个包。

先运行 composer install --no-dev --prefer-dist（哪怕项目没 composer.lock，也要触发下载）
确认缓存已填充：ls -lh ~/.composer/cache/files/ | head -5 应能看到大量哈希命名的压缩包
打包整个 ~/.composer/cache/ 目录（含 files/、repo/、http/），不要只导 files/ —— repo/ 里存着包元数据，缺了它 Composer 会重新联网请求
传到离线服务器后，解压覆盖到对应用户家目录下的 .composer/cache/，比如 /root/.composer/cache/ 或 /home/www/.composer/cache/
验证是否生效：composer config --global cache-dir 输出应为迁移后的路径

离线安装时必须加的关键参数

即使缓存就位，不加限制参数仍可能失败——Composer 默认会尝试执行脚本、加载插件、校验 SSL，这些在离线环境全不可行。

Discussion Composer

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

下载

必加 --prefer-dist：强制走缓存里的 dist 包，跳过 source 克隆（需要 git）
必加 --no-scripts：禁用所有 post-install-cmd 类脚本，避免因缺失命令（如 php artisan）或路径错误中断
建议加 --no-plugins：防止插件尝试联网或调用不存在的扩展（如 composer-asset-plugin）
如果 PHP 的 openssl.cafile 或 curl.cainfo 为空，即使走本地缓存，Composer 仍可能卡在 SSL 验证环节——此时需手动配置 CA 路径，或临时设 export COMPOSER_DISABLE_TLS=1（仅限内网可信环境）

缓存失效或不全时的兜底方案

如果缓存目录为空，或部分包缺失（比如只传了 files/ 没传 repo/），composer install 仍会报错退出，无法降级处理。

这时只能退到「本地仓库」模式，但这不是“复用缓存”，而是搭建一个最小化的 Packagist 替代服务：

用 composer archive 把每个依赖打成 .zip，统一放在离线 HTTP 服务下（如 http://192.168.10.10/packages/）
在项目 composer.json 里加自定义仓库：{"type":"composer","url":"http://192.168.10.10/packages/"}
必须提前生成 packages.json（可用 packagist-mirror 工具，或手动整理），且所有依赖必须锁定具体版本号（"monolog/monolog": "2.10.0"），不支持 dev-master 这类分支引用

最常被忽略的一点：离线机上 php -m 是否包含 zlib 和 openssl 扩展——没有 zlib，连 .zip 包都解不开；没有 openssl，哪怕关了 TLS，composer install 也可能在解析 packages.json 时直接 segfault。