Qué ha cambiado en Moodle 5.1
A partir de la versión 5.1, Moodle ha modificado su estructura de carpetas por motivos de seguridad. Hasta entonces, todos los ficheros de la aplicación estaban en la misma carpeta a la que apuntaba el dominio. Ahora, en cambio:
La mayor parte del contenido se guarda en una subcarpeta llamada public.
El resto de ficheros pasan a la carpeta inmediatamente superior en el árbol de directorios.
El document root del dominio (la carpeta a la que apunta) debe ser precisamente esa subcarpeta public, no la raíz como antes.
Si no se realiza este ajuste, la actualización no se completa correctamente y es muy frecuente que la web devuelva un error HTTP 500.
Síntomas habituales
Tras subir el core a Moodle 5.1+, la web muestra error 500 y no carga.
Al intentar instalar Moodle 5.1+ desde Softaculous aparece un aviso similar a: "The folder ... should not be accessible via web. This folder is a document root of another domain" o "It seems that the Moodle files are already present at this location".
Aparecen errores internos al tocar ciertas opciones del panel de administración (por ejemplo, al cambiar el tema o entrar en algunas secciones), a veces relacionados con la caché de plantillas.
Cómo dejar el dominio apuntando a "public"
El ajuste se hace desde cPanel, en el apartado de Dominios:
Entra en cPanel y ve a Dominios.
Localiza el dominio o subdominio donde está Moodle y pulsa en Administrar.
Cambia el document root para que apunte a la subcarpeta public de tu instalación (por ejemplo, a
.../tucarpeta/public).Coloca el resto de ficheros de Moodle en la carpeta inmediatamente superior, tal y como indica la documentación oficial de Moodle.
El acceso para el usuario no cambia: seguirás entrando con la URL de tu dominio o subdominio habitual; lo único que cambia es a qué carpeta interna apunta.
Instalación nueva con Softaculous
Si haces una instalación limpia de Moodle 5.1+ con Softaculous, ten en cuenta que solo permite instalar esa versión sobre un dominio que apunte a public_html. Si el dominio o subdominio apunta a otra carpeta, o si por encima existen otras instalaciones, Softaculous mostrará los avisos indicados arriba y no dejará continuar.
En ese caso tienes dos opciones:
Ajustar el document root del dominio según se explica en el apartado anterior.
Realizar la instalación manual, descargando el paquete .zip oficial de Moodle y siguiendo los pasos del asistente, respetando la nueva estructura de carpetas (public + carpeta superior).
Otros requisitos de Moodle 5.x
MySQL 8.4 a nivel de servidor. Moodle 5.x requiere MySQL 8.4. Esto no se cambia desde cPanel; depende del servidor donde esté alojado tu Moodle.
Extensión PHP sodium. Viene activada en los planes específicos de Moodle, pero no está disponible en otros tipos de plan aunque cambies la versión de PHP.
Tema y plugins compatibles. Antes de actualizar el core, comprueba que tu tema y tus plugins son compatibles con Moodle 5.1+; un tema o plugin incompatible puede provocar errores fatales. Actualiza los plugins de uno en uno y verifica que cada uno funciona, en lugar de actualizarlos todos a la vez.
Inodos. Vigila no superar el límite de inodos del plan durante el proceso: si se rebasa, puede que algunos ficheros no se copien o actualicen correctamente.
¿Prefieres que lo hagamos nosotros?
El cambio de estructura de la 5.1 puede resultar laborioso. Disponemos de un servicio de actualizaciones de Moodle con el que nos encargamos de actualizar tu Moodle cada vez que sale una nueva versión durante un año. Se contrata de forma individual por cada Moodle. Si te interesa, abre un ticket desde tu Área de Clientes y te damos los detalles.