Errores comunes entre Moodle y PHP y cómo resolverlos
Moodle está escrito en PHP, y buena parte de los errores de instalación, actualización o rendimiento vienen de la configuración de PHP del servidor: una versión no compatible, una extensión que falta o unos límites demasiado bajos. En esta guía repasamos los errores más comunes y cómo resolverlos, también en instalaciones con asistentes como Softaculous en alojamientos compartidos.
Versión de PHP
Cada versión de Moodle funciona con un rango concreto de versiones de PHP; las versiones actuales requieren PHP 8.2 o superior. Usar una versión demasiado antigua impide instalar o actualizar; una demasiado nueva puede provocar avisos y fallos en plugins. Antes de cambiar la versión de PHP del servidor, hay que comprobar la compatibilidad de Moodle y de todos sus plugins.
Errores frecuentes y su causa
| Síntoma | Causa habitual | Solución |
|---|---|---|
| La instalación no avanza y pide requisitos | Extensiones de PHP que faltan (intl, zip, gd, mbstring, soap, sodium…) | Activarlas en el servidor o en el panel del alojamiento |
| Error al guardar formularios grandes o ajustes | max_input_vars demasiado bajo | Subirlo (Moodle recomienda al menos 5000) |
| Pantalla en blanco o error 500 | Falta de memoria o un error fatal de un plugin | Aumentar memory_limit y revisar el registro de errores |
| No se pueden subir archivos grandes | upload_max_filesize y post_max_size bajos | Ajustarlos a lo que necesitan los cursos |
| Copias de seguridad o actualizaciones que se cortan | max_execution_time corto | Ejecutar esas tareas por línea de comandos o ampliar el tiempo |
| Tareas programadas que no se ejecutan | El cron de Moodle no está configurado | Programar el cron del sistema cada minuto |
Instalar con Softaculous u otros asistentes
Los asistentes de los paneles de alojamiento permiten instalar Moodle en minutos, pero no siempre dejan el servidor bien preparado: la versión de PHP puede ser incorrecta, faltar extensiones, no configurarse el cron o quedar la carpeta de datos en una ubicación accesible desde la web. Tras instalar, conviene revisar la página de comprobación del entorno de Moodle y corregir todo lo que marque.
Para plataformas con muchos alumnos, un alojamiento compartido suele quedarse corto: conviene un servidor dedicado o en la nube, contratado a nombre de la empresa.
Caso ilustrativo
Un campus que se quedaba en blanco al calificar
Los docentes de un centro de formación veían una pantalla en blanco al guardar las calificaciones de cursos grandes. El error no dejaba rastro visible.
El registro de errores mostró que el formulario superaba el límite max_input_vars y que la memoria asignada a PHP era insuficiente. Tras ajustar ambos valores y revisar el resto de requisitos del entorno, las calificaciones se guardaron sin problemas.
Ejemplo basado en situaciones habituales en nuestros proyectos. Los datos se han modificado para proteger la confidencialidad de los clientes.
La visión de Ángel González
«La mayoría de fallos entre Moodle y PHP tienen una causa técnica concreta: una versión de PHP fuera del rango soportado, extensiones como intl o sodium sin instalar, límites de memoria insuficientes o un OPcache mal configurado. Por eso, antes de cada actualización revisamos la matriz de compatibilidad y ejecutamos la comprobación de entorno de Moodle en una copia. Además, recomiendo evitar los instaladores automáticos en producción: un despliegue controlado con Git y una configuración de PHP documentada ahorra muchas horas de incidencias.»
Ángel González, director de NOÁTICA Informática para empresas
Preguntas frecuentes
¿Dónde veo los errores de PHP de Moodle?
En el registro de errores del servidor y, temporalmente, activando la depuración de Moodle en un entorno de pruebas, nunca de forma permanente en producción.
¿Puedo actualizar PHP sin actualizar Moodle?
Solo si su versión de Moodle es compatible con la nueva versión de PHP. Si no, hay que planificar ambas actualizaciones juntas.
¿Sirve un alojamiento compartido para Moodle?
Para pruebas o plataformas pequeñas. Con muchos usuarios simultáneos es mejor un servidor dedicado o en la nube.
¿Su Moodle da errores que nadie sabe resolver?
Revisamos el servidor, PHP, la base de datos y los plugins de su plataforma y corregimos la causa de los errores, no solo el síntoma.
