Actualizar el núcleo de Drupal con Composer.

Learn DrupalDrupal-woordenlijst

Este artículo supone que instalaste Drupal con un proyecto de Composer como drupal/core-recommended o drupal/dxpr-marketing-cms-project

Lista las actualizaciones disponibles de Drupal

composer outdated "drupal/*"

Si no hay ninguna línea que empiece por drupal/core, Composer no tiene constancia de ninguna actualización. Si hay una actualización, continúa con los comandos siguientes

Crea una copia de seguridad de tu instancia de Drupal

Al actualizar un sitio web en producción, crea siempre una copia de seguridad antes de actualizar, aunque ya hayas probado la actualización con éxito en un entorno de desarrollo o de pruebas. Usa las herramientas de tu proveedor de alojamiento para crear una copia de seguridad o una instantánea de tu sitio Drupal.

Actualiza el código del núcleo de Drupal

si usas drupal/core-recommended:

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

Para simular la actualización y ver qué pasaría, sin cambiar nada en realidad, añade --dry-run.

Actualiza a la última versión de parche del núcleo

Si quieres actualizar tu sitio a la última versión de parche, pero no a la última versión menor, añade opciones --with= para cada dependencia drupal/core-* indicada en composer.json.

Por ejemplo, si 10.2 es la versión menor actual y quieres actualizar tu sitio a la última versión de parche de 10.3:

composer update "drupal/core-*" --with-all-dependencies --with=drupal/core-recommended:~10.3.0 --with=drupal/core-composer-scaffold:~10.3.0

Este ejemplo supone que  drupal/core-recommended y drupal/core-composer-scaffold son las únicas dependencias del núcleo de Drupal en composer.json.

Actualiza a una versión concreta del núcleo

En general, recomendamos no indicar una versión concreta del núcleo de Drupal al actualizar, salvo que sepas que quieres fijar una versión concreta. Si quieres fijar tu sitio a una versión concreta, puedes usar el ejemplo siguiente: 

Para fijar tu sitio a la versión 10.3.6 y actualizar todas las dependencias en consecuencia: 

composer require drupal/core-recommended:10.3.6 drupal/core-composer-scaffold:10.3.6 drupal/core-project-message:10.3.6 --update-with-all-dependencies

Aviso: si fijas tu sitio a una versión concreta del núcleo, esa versión se añadirá al archivo de bloqueo y las futuras actualizaciones no superarán esa versión. Vuelve a ejecutar el comando require como se indica más abajo para volver a una versión «no fijada» del núcleo.

Cómo dejar de fijar una versión concreta del núcleo

Si usas una versión fijada del núcleo de Drupal y quieres actualizar tu sitio a otra versión, tienes dos opciones.

  1. Puedes ejecutar el comando composer require anterior para indicar una nueva versión fijada del núcleo. 
  2. Puedes dejar de fijar tu versión del núcleo y actualizar a la última versión de Drupal.

Para dejar de fijar tu versión de Drupal, ejecuta este comando: 

composer require drupal/core-recommended drupal/core-composer-scaffold drupal/core-project-message --update-with-all-dependencies

Ejecuta las actualizaciones de la base de datos

Por comodidad hemos incluido los comandos de Drush necesarios para completar una actualización; a mucha gente le resulta Drush más rápido y fácil que el área de administración web.

Puedes usar drush:

drush updatedb
drush cache:rebuild

O puedes visitar [YOUR DOMAIN]/update.php en un navegador.