SuperAPI AI 工具集

drupal-config-mgmt

通用与其它

查看项目

更新于 10-16 05:50

技能介绍

本技能用于安全地管理 Drupal 配置,涵盖导入、导出、Config Split 拆分和环境同步。

用途与主要能力:可查看配置(config:get、config:status)、导出或导入全部或单个配置对象、使用 config:set / config:delete 修改单值,以及管理 Config Split(config-split:status、csex、csim、activate/deactivate、status-override)。

远程命令:示例以 Pantheon 的 terminus drush <site>.<env> -- <cmd> 给出,其他主机可替换为对应远程 drush 形式或 drush @<alias> <cmd>。

核心安全要点:远程 CLI 包装器通常非交互执行,Drush 默认 --yes,因此 cim/config:import 会自动确认并导入。预览应加 --no --diff,例如 terminus drush {site}.{env} -- cim --no --diff;只读命令最安全。默认一次只处理一个命名配置对象,避免整套 cex/cim 把他人未提交的漂移一并卷入,整套导入留给部署环节,并在干净且已提交的树上执行后再检查 git status config/。单文件部分导入示例:mkdir -p .config-one && cp config/default/config.name.yml .config-one/ && ddev drush config:import --partial --source=/var/www/html/.config-one -y。

限制:资料未提供价格、收费、适用 Drupal 或 Drush 版本等细节;部分命令存在版本差异,如 Drush 13 的 config:import 没有 --skip-config,需用 config_ignore 或单文件部分导入。Config Split 定义必须写入活动配置(数据库)而非仅导出文件,否则不生效。完整与部分拆分语义不同:complete_list 会把配置从 config/default 移出,partial_list 保留并打补丁。建议改配置优先在站点内变更再导出单对象,避免手写 YAML 丢失依赖,并用 config:status 验证。