用途:指导并执行 Drupal Commerce 站点从 Drupal 9 升级到 Drupal 10,重点处理 Commerce 专有的数据库更新钩子失败与恢复。
主要能力:按四个阶段推进——盘点、Composer 升级、数据库更新与恢复、切换上线。盘点阶段检查 Drupal/PHP 版本(ddev drush status --fields=drupal-version,php-version,db-driver),列出已启用模块与 drupal/* 依赖,用 drupal-check 检测 D10 兼容性,导出配置作为回滚基线,并清点迁移模块与组、重置卡住的迁移状态、记录 system.schema 版本。升级阶段创建数据库快照(ddev snapshot --name=pre-d10-upgrade),更新 core-recommended 与 Commerce、commerce_stripe 约束,执行 ddev composer update -W。更新阶段运行 ddev drush updatedb -y,并针对典型阻塞给出恢复步骤:commerce_payment_method 字段存储定义导致 __PHP_Incomplete_Class、commerce_stripe_update_8102 列已存在、8104 钩子级错误(最后手段跳过,须在生产前回补)、dblog_update_10100 的 watchdog ALTER TABLE 超时或数值溢出、以及孤立 system.schema 条目;每种都含备份、修正、验证命令。
适用场景:Drupal 9 Commerce 站点升 D10、drush updatedb 涉及 Commerce 模块失败、commerce_stripe/dblog/system.schema 更新失败、含 Commerce/Stripe/支付模块的大版本升级规划。
限制:技能在 Phase 3 预期会出现阻塞,命令示例基于 DDEV 环境;跳过 8104 属最后手段且需人工复查,不可在无监督情况下直接上生产。升级前务必先备份数据库与配置。其他细节资料暂未提供。