Solución de problemas de actualización de la base de datos

Antes de comenzar a solucionar problemas relacionados con la actualización de la base de datos, siempre haga una copia de seguridad de la base de datos y del código base.

Si existen problemas que impidan una ejecución segura de las actualizaciones de la base de datos, update.php mostrará un mensaje de error.

Lea cuidadosamente el mensaje de error para resolver el problema.

Módulos o temas incorrectos

En algunos casos, update.php puede informar sobre módulos o temas inválidos. Esto sucede cuando un módulo o tema está listado en el archivo de configuración core.extension.yml, pero falta o es incompatible con el sitio.

Para solucionar este problema, primero asegúrese de no haber importado una versión incorrecta del archivo core.extension.yml. Luego, solucione problemas adicionales según el mensaje específico que se muestre. Reinicie update.php una vez que el problema esté resuelto.

Módulo o tema ausente

1. Si update.php informa que un módulo o tema está ausente y se está usando el archivo core.extension.yml correcto, asegúrese de que el módulo o tema exista en el código base del sitio.

• Por ejemplo, revise [site-root]/modules y [site-root]/sites/all/modules para encontrar la carpeta que corresponde al nombre del módulo ausente. [site-root]/modules tiene prioridad sobre [site-root]/sites/all/modules, pero ambos se escanean en busca de módulos.

2. Si la carpeta falta por completo, busque el módulo en Drupal.org y trate de descargarlo nuevamente en la carpeta de sus módulos. Asegúrese de descargar una versión compatible con su versión de Drupal.

3. Si la carpeta está presente, es posible que falten archivos o que el contenido esté dañado de alguna forma. También puede buscar el módulo en Drupal.org y volver a descargarlo en ese caso. Sobrescriba la carpeta existente con la nueva versión descargada.

4. Si el módulo no fue descargado desde Drupal.org, trate de encontrar su fuente original.

• Si el módulo pertenece a su sitio o aplicación, intente localizar la versión original y volver a agregarla a la carpeta de módulos.
• Si el módulo fue creado por un tercero pero no está alojado en Drupal.org (por ejemplo, proporcionado en GitHub), intente encontrar una versión válida y vuelva a descargarla.

5. En última instancia, si no se puede encontrar el módulo, puede intentar eliminar la entrada correspondiente en core.extension.yml. Recuerde que esto puede causar otros errores fatales en el sitio.

6. Una vez que el módulo se haya restaurado, reinicie update.php.

Módulo o tema incompatible con la versión instalada de Drupal

1. Si update.php informa que un módulo o tema es incompatible con la versión instalada de Drupal, debe actualizar Drupal o actualizar el módulo o tema.

2. Primero, verifique qué versión del núcleo Drupal está instalada. Esto puede verse en la página Informes - Informe de estado (Reports - Status report).

3. Luego, verifique qué versión del módulo o tema está instalada leyendo el archivo modules/modulename/modulename.info.yml. Debe ver al menos una de las siguientes líneas en la parte superior del archivo:

core: 8.x
core_version_requirement: ^8.8 || ^9

Esto indica que el módulo es compatible con Drupal 8.8+ y Drupal 9. La clave core: 8.x es opcional en este caso y puede estar presente o no. (Más información sobre la clave core_version_requirement.)

core_version_requirement: ^9

Esto significa que el módulo solo es compatible con Drupal 9. (Más información sobre la clave core_version_requirement.)

core: 8.x

Esto significa que el módulo solo es compatible con Drupal 8.

core: 7.x

Esto significa que el módulo solo es compatible con Drupal 7.

4. Si la versión del núcleo Drupal es demasiado antigua para el módulo instalado, descargue una actualización para el núcleo Drupal.

5. Si la versión del módulo es demasiado antigua para la versión del núcleo Drupal, descargue o instale una versión actualizada del módulo.

6. Si no hay disponible una versión compatible del módulo o núcleo, puede que necesite restaurar una versión anterior desde una copia de seguridad.

7. Cuando versiones compatibles del núcleo Drupal y del módulo o tema estén disponibles en el código base, reinicie update.php.

Módulo o tema incompatible con la versión instalada de PHP

1. Si un módulo o tema es incompatible con la versión instalada de PHP, busque en el archivo modules/modulename/modulename.info.yml una línea similar a la siguiente:

php: 7.3

2. Opción 1. Instale la versión del módulo o tema que soporte la versión de PHP de su sitio.

3. Opción 2. Cambie la versión de PHP de su sitio a una compatible con el módulo.

4. Cuando las versiones compatibles de PHP y el módulo o tema afectado estén presentes en el código base, reinicie update.php.