digitalpolygon / drupal-upgrade-plugin
一款旨在简化更新 Drupal 核心安装流程的 Composer 插件。
dev-main / 1.0.x-dev
2024-08-13 22:12 UTC
Requires
- php: >=7.3.0
- composer-plugin-api: ^2
Requires (Dev)
- composer/composer: ^2@stable
Suggests
- ion-bazan/composer-diff: v1.9.0
This package is auto-updated.
Last update: 2024-09-13 22:23:52 UTC
README
一款旨在简化更新 Drupal 核心到最新稳定版本的 Composer 插件。该工具确保您的 Drupal 网站在最小麻烦的情况下保持安全并保持更新,利用 Composer 的能力使更新过程顺畅高效。
功能
- 自动版本检测:识别您当前的 Drupal 核心版本和下一个可用的稳定版本。
- 无缝更新:使用
composer update --minimal-changes
在对依赖关系进行最小更改的情况下更新核心包。 - 用户确认:在升级之前提示用户确认,确保您始终处于控制之中。
- 回滚机制:在做出任何更改之前,通过备份 composer 文件提供安全的回滚。
- 依赖关系管理:高效处理所需和所需-dev 包的版本约束和更新。
安装
要安装 Drupal 核心Composer更新插件,请按照以下步骤操作
-
添加插件存储库:将插件GitHub存储库添加到您项目
composer.json
文件中的存储库部分。{ "repositories": [ { "type": "vcs", "url": "git@github.com:digitalpolygon/drupal-upgrade-plugin.git" } ] }
-
要求插件:将插件添加到您的项目
composer.json
文件。composer require digitalpolygon/drupal-upgrade-plugin;
用法
要更新您的 Drupal 核心到最新稳定版本,请在项目根目录中运行以下命令
composer drupal:core:version-change 10.3.1;
此命令将执行以下步骤
- 备份 composer 文件:备份当前的
composer.json
和composer.lock
文件。 - 确定当前版本:检测您的当前 Drupal 核心版本。
- 检查更新:查找下一个稳定的 Drupal 核心版本。
- 用户确认:提示您确认更新。
- 更新过程:将新版本添加到
composer.json
并运行composer update --minimal-changes
。 - 完成更新:将通配符版本替换为特定的大括号版本,并更新锁文件。
使用标志
您可以使用以下标志指定更新行为
--version=<version>
:要更新的 Drupal 核心特定版本。如果未指定,将考虑其他选项。--latest-minor
:更新到当前 Drupal 核心主版本的最新稳定次要版本。此选项确保您保持在当前主版本内,同时应用最新的次要更新。--latest-major
:更新到 Drupal 核心的最新稳定主版本。此选项将升级您的网站到最新可用的主版本。--next-major
:更新到 Drupal 核心下一个主版本的最新稳定版本。此选项为下一个主要版本准备您的网站。
您还可以使用 --yes
选项自动确认升级而无需提示
composer drupal:core:version-change 10.3.1 --yes;
此选项对于脚本化和自动化目的非常有用。
贡献
我们欢迎对该插件的功能和特性进行改进的贡献。请克隆存储库并提交改进或错误修复的拉取请求。