标签搜索

Drupal 如何安全更新?Composer、数据库与回滚检查

微芒网
2026-11-19 / 9 - 阅读

Drupal 如何安全更新?Composer、数据库与回滚检查主题示意

Drupal 更新包括代码依赖、数据库结构和缓存等环节。本文覆盖已使用 Composer 管理的项目,在当前主版本范围内进行小版本或补丁更新。大版本升级、非 Composer 项目和自定义部署流程需要按对应官方指南另外评估。

更新前清点版本和备份

记录 PHP、Composer、Drupal 核心、Drush、模块和主题版本,检查官方支持范围和待更新包的发行说明。以项目目录为工作位置,保留 composer.json、composer.lock、配置、公开与私有文件、数据库及部署清单。

备份应保存到受限位置,并确认能在独立环境恢复。数据库包含客户或账号信息时,测试环境按业务需要脱敏并限制访问。文件和数据库选择同一可解释的时间点,避免恢复后互相不一致。

在测试环境先看更新范围

以下命令用于查看版本与可用更新。Drush 路径以项目实际安装为准。

php --version
composer --version
composer show drupal/core-recommended
composer outdated "drupal/*"

如果 core-recommended 未安装,先确认项目实际依赖 drupal/core 还是其他模板,按对应文档操作。阅读 composer.json 的版本约束,检查补丁和自定义模块依赖。

先预览依赖变更

对于使用 core-recommended 的项目,可在独立开发环境预览核心更新。

composer update "drupal/core-*" --with-all-dependencies --dry-run

确认预期版本和依赖变更后,在该测试环境执行实际更新。约束范围来自项目 composer.json。

composer update "drupal/core-*" --with-all-dependencies

不要为消除冲突而直接删除锁文件或忽略平台依赖。遇到约束问题,查看 Composer 的冲突信息,并使用 prohibits 或 why-not 定位阻止目标版本的依赖。目标版本需按当前项目填写。

模块和主题按各自包名与发行说明更新,并核对核心兼容性。一次大范围变更出现问题时,回到已知基线,缩小范围排查。

更新数据库和缓存

代码更新完成后,使用项目的 Drush 执行数据库更新和缓存重建。这里展示已安装在 vendor/bin 的 Drush。

vendor/bin/drush updatedb
vendor/bin/drush cache:rebuild

执行前确认数据库连接指向测试站。查看退出状态与日志,检查后台状态报告、内容编辑、权限、搜索、表单和实际启用的业务流程。配置由代码管理的项目,还要按既定导出与导入流程核对更新后的配置差异。

将已验证的版本部署到生产

部署时使用已经通过验证的 composer.json 和 composer.lock,在约定维护窗口安装锁定依赖。以下为常见命令示意,实际构建目录和权限按项目部署方式调整。

composer install --no-dev --optimize-autoloader

备份、维护模式、文件同步、数据库更新、配置导入和缓存重建的顺序,应在测试环境按项目流程完整演练。生产环境重新运行不受控的依赖求解,可能生成不同于测试版本的组合。

回滚时同时考虑代码和数据库

数据库更新可能改变表结构与数据。出现故障后,仅切回旧代码未必足够。按演练方案恢复匹配的代码、锁文件、配置、文件和数据库,并评估维护窗口期间新增订单或内容的处理。

检查阶段 核对内容
更新前 备份可恢复、目标版本明确、依赖兼容
测试更新后 数据库更新完成、状态报告和业务通过
正式部署后 匿名与登录用户流程、定时任务、错误日志
回滚演练 代码与数据库版本匹配、数据差异已处理

本文提供官方文档基础上的流程说明,尚未在读者的 Drupal 项目中执行。更新风险需结合自定义代码、模块和数据评估。

Drupal 核心 Composer 更新文档 · 相关备份思路 · WordPress 性能排查

Composer 命令文档 · Drush 数据库更新命令

2

评论

博主关闭了本网站的评论