U盘离线包必须包含composer.phar、composer.lock、完整vendor/目录和项目根目录下的composer.json四类文件；vendor需由--no-dev --prefer-dist生成且与lock严格匹配，phar须与目标PHP版本一致，权限与符号链接需用tar保留，断网时需禁用网络并清空全局repo配置，新增包应通过path仓库方式引入。
U盘离线包必须包含哪些文件才能直接运行
只拷 composer.phar 和 composer.lock 不够，U盘里至少得有这四样东西：composer.phar、composer.lock、完整 vendor/ 目录、项目根目录下的 composer.json。少任何一个，离线机上执行 composer install 都会卡住或报错。
常见错误现象：U盘插进去后运行 php composer.phar install，提示 Could not find package xxx 或直接跳过 vendor 生成；或者生成了 vendor 但运行时报 Class not found。
-
vendor/必须是composer install --no-dev --prefer-dist后的产物，不能是--prefer-source（内网没 git） -
composer.lock必须和 vendor 内容严格匹配——用sha256sum vendor/*/composer.json | sort和composer show --locked对比验证 -
composer.phar要在和目标环境一致的 PHP 版本下生成，否则哈希校验失败（比如 PHP 8.2 编译的 phar 在 PHP 8.1 上可能无法加载） - 别漏掉
autoload.php的依赖路径：确认vendor/autoload.php可被require，且里面没硬编码绝对路径（某些私有包会写死/home/user/project）
U盘里 vendor 目录为什么在目标机上权限不对
Linux/macOS 下打包时保留了符号链接和执行权限，Windows 上 U 盘解压后这些全丢了，导致 vendor/bin/ 下的脚本（如 phpunit、doctrine）无法执行，甚至 autoload 失败。
使用场景：金融客户内网服务器是 CentOS 7，运维从 Windows 笔记本拷贝 U 盘内容过来，chmod -R +x vendor/bin/ 后仍提示 Permission denied。
- Windows 打包前先用 WSL 或 Git Bash 进入项目目录，执行
tar -czf vendor.tar.gz vendor/，再把 tar.gz 拷到 U 盘 - 目标机解压不用
unzip，改用tar -xzf vendor.tar.gz，能还原所有权限和符号链接 - 如果只能用 zip，务必在 Windows 上用 7-Zip（不是系统自带压缩），勾选“存储符号链接”和“使用 Unix 文件属性”
- 检查关键文件权限：
ls -l vendor/autoload.php应为-rw-r--r--，ls -l vendor/bin/phpunit应为-rwxr-xr-x
怎么让 composer install 在断网时彻底不发任何 HTTP 请求
光加 COMPOSER_DISABLE_NETWORK=1 不够，Composer 还会尝试读取全局配置里的 repo 地址、proxy、甚至本地 ~/.composer/config.json 中残留的 repo.packagist，一碰就报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
典型错误信息：Failed to decode response: file_get_contents(): php_network_getaddresses: getaddrinfo failed，其实它根本没连外网，只是在解析配置时触发了 DNS 查询。
- 在联网机打包前，运行
composer config --global --unset repo.packagist和composer config --global --unset http-proxy - U盘里额外放一个
composer-config.json，内容为{"repositories": []}，离线机执行时加参数--config-file composer-config.json - 强制跳过 autoload 重建：
COMPOSER_DISABLE_NETWORK=1 php composer.phar install --no-plugins --no-scripts --no-autoloader - 最后补一记：
php composer.phar dump-autoload -o，否则部分 classmap 加载器不会生效
离线新增包时为什么 composer require 总失败
composer require 默认行为是联网查包名、版本、约束条件，离线环境下它根本不会看本地文件，直接报 Could not find package，哪怕你 U 盘里已经放好了 ZIP 包。
正确做法不是“装新包”，而是“告诉 Composer 去哪找已有的包”。最轻量方案就是用 path 类型仓库，不需要 HTTP 服务，也不依赖 ZIP 命名规则。
- 把新包源码（含合法
composer.json）放到 U 盘的packages/my-new-lib/目录下 - 确保该包的
composer.json里有"name"（如"acme/my-new-lib"）和"version"（如"1.0.0"）或分支标识（如"dev-main"） - 修改项目根目录的
composer.json，在repositories数组开头加一项：{"type": "path", "url": "packages/my-new-lib"} - 运行
COMPOSER_DISABLE_NETWORK=1 php composer.phar require acme/my-new-lib:dev-main—— 注意必须带:dev-main，否则它还是去查远程
真正麻烦的不是拷文件，而是路径一致性：U 盘挂载点在不同机器上可能变成 /media/usb 或 /mnt/usb，path 仓库的 url 得用相对路径，不能写绝对路径。
