composer如何在WordPress VIP Go环境中合规使用依赖？（只读文件系统适配）

vip go 上 composer install 失败是因为 webroot 只读，必须本地或 ci 构建 vendor 并上传；autoload.php 需用绝对路径如 dirname(abspath) . ‘/vendor/autoload.php’ 加载，且 composer.json 仅保留 name、require、autoload 等必要字段。

为什么 composer install 在 VIP Go 上直接失败？

VIP Go 环境的 webroot（如 /public）是只读文件系统，而 Composer 默认会往 vendor/ 和 composer.lock 写入内容。你执行 composer install 时大概率看到：Permission denied: vendor/autoload.php 或 Failed to write ... read-only file system。这不是权限没开全，是平台设计如此——运行时不可写，必须把依赖构建过程移出运行时。

• 构建阶段必须在本地或 CI 中完成，不是在 VIP Go 服务器上
• vendor/ 目录必须作为构建产物整体上传，不能靠线上生成
• composer install --no-dev --optimize-autoloader 是构建命令的标准形态

如何让 autoload.php 正确加载只读 vendor？

VIP Go 的 PHP 自动加载机制本身没问题，但路径错位会导致 require_once 找不到 vendor/autoload.php。常见错误是：本地构建时用的是相对路径 require 'vendor/autoload.php';，而上传后文件结构变了，或者 wp-content/mu-plugins/ 下插件试图从错误位置加载。

• 确保 vendor/autoload.php 路径在代码中写死为绝对路径，例如：require_once <strong>DIR</strong> . '/../../vendor/autoload.php';
• 不要用 get_template_directory() 或 plugin_dir_path() 动态拼接，它们可能返回 webroot 下的路径，而 vendor/ 实际在项目根（与 wp-content 同级）
• 检查 WP_CONTENT_DIR 和实际目录层级，VIP Go 推荐将 vendor/ 放在站点根目录（即 /，和 wp-content 并列），然后在 mu-plugin 或主题中用 dirname(ABSPATH) . '/vendor/autoload.php'

composer.json 中哪些字段在 VIP Go 上容易引发部署失败？

VIP Go 的部署流程会解析 composer.json，但不执行 scripts，也不支持 post-install-cmd 这类钩子。如果你写了：

• "scripts": { "post-install-cmd": "chmod -R 755 vendor/" } → 完全无效，且可能让部署卡住

• "config": { "vendor-dir": "wp-content/vendor" } → 危险，wp-content 下目录可能被扫描或暴露，且与 VIP Go 的安全策略冲突

• "minimum-stability": "dev" 或大量 "repositories" → 增加构建失败概率，CI 拉包超时或鉴权失败

• 只保留必要字段：name、require、autoload

• autoload 推荐用 "psr-4"，避免 "classmap" 导致大体积扫描

• 所有依赖必须是稳定版（^x.y.z），禁用 dev-master 或分支别名

如何验证本地构建结果能在 VIP Go 上真正跑通？

光是 composer install 成功、文件传上去不报 500，不代表 autoload 或扩展调用就对了。真实问题常出现在运行时：

• 用 php -l 检查所有入口文件语法，特别是 mu-plugin 的主文件
• 在本地模拟只读环境：chmod -R 555 vendor/ && php -r "require 'vendor/autoload.php';"，看是否 fatal Error
• 部署后，在 VIP Go 的 debug 模式下访问 wp-admin/admin-ajax.php?action=vip_go_debug_autoload（如有）或手动触发一个依赖服务，观察 error_log 是否出现 Class not found 或 include(): Failed opening
• 注意扩展兼容性：VIP Go 默认启用 OPcache，但某些依赖（如旧版 monolog/monolog）的动态 require 可能被 OPcache 缓存路径，导致类加载失败，此时需加 opcache.restrict_api=""（仅限测试）

VIP Go 对 Composer 的约束本质是「构建与运行分离」，不是不让用，而是不允许把构建逻辑塞进运行时。最常被忽略的点是：以为上传了 vendor/ 就万事大吉，却没校验 autoload.php 的加载路径是否真的指向它——路径错一格，整个依赖链就断了。