
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 项目中执行。更新风险需结合自定义代码、模块和数据评估。
评论