composer install 在 ddev 容器中失败，因默认不挂载 vendor/ 且宿主机与容器的 php 版本、扩展（如 mbstring、xml）及 composer 配置不一致，导致类找不到或文件无法加载；所有 composer 命令须在容器内执行（如 ddev exec composer install），并确保 php 版本、扩展、缓存组件（opcache/apcu）匹配项目要求。
为什么 composer install 在 DDEV 容器里失败？
因为 DDEV 默认不挂载 vendor/ 目录，且宿主机的 Composer 配置、PHP 版本、扩展（如 mbstring、xml）和容器内不一致。直接在宿主机跑 composer install 生成的 vendor/ 往往无法被容器内 PHP 正确加载，报错像 Class not found 或 require(): Failed opening required。
实操建议：
- 所有 Composer 命令必须在 DDEV 容器内执行：用
ddev exec composer install或先ddev ssh再运行composer命令 - 确认容器 PHP 版本匹配项目要求：查看
ddev describe中的php_version，必要时在.ddev/config.yaml中设置php_version: "8.2" - Drupal 9+/10 项目需确保容器启用了
opcache和apcu（DDEV 默认已开），否则drush cr可能卡住或报Cache backend not available - WordPress 插件依赖若含二进制扩展（如
ext-gd），需检查ddev describe输出中是否列出该扩展；没列出就说明未启用，得改config.yaml加webimage_extra_packages: [php-gd]
composer create-project 初始化 Drupal/WordPress 项目时卡住？
常见于国内网络环境直连 Packagist，或 DDEV 容器 DNS 解析异常。不是 Composer 本身问题，而是请求超时或重定向失败，表现是命令长时间无响应、最后报 Could not fetch https://repo.packagist.org/packages.json。
实操建议：
- 临时换国内镜像源：进容器后执行
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意：仅限开发，勿用于生产构建） - 更稳妥的方式是在项目根目录加
composer.json并预设仓库配置，避免全局修改影响其他项目 - WordPress 官方推荐用
wp-cli搭配composer管理插件：先ddev exec wp core download，再用composer require wpackagist-plugin/advanced-custom-fields，比直接create-project更可控 - Drupal 项目优先用
drupal/recommended-project而非drupal/drupal：后者不带自动 autoloader 配置，容易导致vendor/autoload.php找不到
DDEV 中更新 composer.lock 后网站白屏或报错？
典型原因是 composer update 改变了核心包版本（比如 Drupal 核心从 10.1 升到 10.2），但数据库未同步、缓存未清、或模块兼容性未验证。白屏常伴随 PHP 错误被静默屏蔽，真实错误藏在 ddev logs -s web 或 var/log/php-fpm-error.log 里。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
- 永远先备份数据库：
ddev export-db --file=pre-update.sql - 更新前确认目标版本兼容性：Drupal 查 upgrade docs，WordPress 查插件页面的 “Tested up to” 字段
- 更新后立刻清缓存：
ddev exec drush cr（Drupal）或ddev exec wp rewrite structure '/%postname%/'+wp cache flush（WordPress） - 若出现
Class 'Drupal\...'找不到，大概率是vendor/权限不对或autoload_static.php生成失败，可删掉vendor/和composer.lock，重新ddev exec composer install
如何让 Composer 自动识别 DDEV 的多环境配置？
Composer 本身不感知 DDEV 环境变量，但 Drupal/WordPress 的自动加载、配置覆盖机制依赖它。常见问题是本地开发配置（如 settings.local.php）没生效，或 composer install 后找不到 web/sites/default/settings.php。
实操建议：
- Drupal：确保
web/sites/default/settings.php末尾有if (file_exists($app_root . '/' . $site_path . '/settings.local.php')) { include $app_root . '/' . $site_path . '/settings.local.php'; }，并把settings.local.php放进 Git（DDEV 默认会挂载它） - WordPress：用
wp-config.php中的if (file_exists(__DIR__ . '/wp-config-ddev.php')) { include __DIR__ . '/wp-config-ddev.php'; }方式分离配置，wp-config-ddev.php里可读取$_ENV['DDEV_PROJECT'] - 别在
composer.json的scripts里硬写路径，改用webroot和docroot相对路径，DDEV 的composer.json示例模板已适配此结构 - 如果用
composer install --no-dev上线部署，记得在 DDEV 里也保持一致——否则本地能跑，上线反而缺drush或phpunit
最易被忽略的是：DDEV 的 vendor/ 是容器内生成的，不能靠宿主机 IDE 的自动补全来判断类是否存在；真要调试，得进容器看 ls -l vendor/autoload.php 和 php -m | grep -E "(mbstring|xml|json)"。
