Solución de problemas de instalación

Problemas comunes¶

En primer lugar, asegúrate de que:

• Seguiste todas las instrucciones aquí para tu distribución.
• Estás usando al menos PHP 8.1+ (obligatorio desde MODX 3.2; las versiones 3.x anteriores permitían PHP 7.2+).
• Está utilizando MySQL superior a 4.1.20, pero no ninguna iteración de MySQL 5.0.51 (incluida 5.0.51a).
• Borraste el directorio core/cache/ completamente antes de comenzar la configuración. A veces, los permisos de archivo incorrectos pueden causar problemas.
• Limpiaste la caché y las cookies de tu navegador.

Mensajes de error PDO¶

Si recibes mensajes de error relacionados con PDO durante la instalación, antes de continuar con los mensajes de error específicos que se detallan a continuación, confirma que la configuración de PDO esté realizada correctamente. Puedes hacerlo ejecutando este código (reemplaza user/password/database/host con tus datos):

<?php
/* Connect to an ODBC database using driver invocation */
$dsn = 'mysql:dbname=testdb;host=localhost';
$user = 'dbuser';
$password = 'dbpass';

try {
  $dbh = new PDO($dsn, $user, $password);
} catch (PDOException $e) {
  echo 'Connection failed: ' . $e->getMessage();
}
?>

Si esto falla, la configuración de tu PDO no es correcta.

Errores comunes¶

Aquí hay algunos problemas comunes que pueden ocurrir durante la instalación y sus soluciones:

"¡Aparece una pantalla en blanco en lugar de la página de opciones!"¶

Probablemente hayas copiado config.inc.tpl en config.inc.php, lo cual es incorrecto. Convierte el archivo config.inc.php en un archivo vacío y escribible.

Si cambiaste el nombre de config.inc.tpl a config.inc.php, cámbielo a config.inc.tpl y crea un archivo en blanco llamado config.inc.php que se pueda escribir.

"¡Hice clic en instalar y obtuve una pantalla en blanco!"¶

Asegúrate de que tu configuración memory_limit en php.ini esté establecida en al menos 24M (el valor que verifica Setup). Para servidores más lentos, es posible que necesites subirlo a 64M.

"No se puede conectar a la base de datos" en la página de opciones de la base de datos¶

Una de las causas comunes de este problema es que estés utilizando un puerto no estándar para MySQL. Intenta poner esta sintaxis en el campo de nombre de host (reemplazando los datos con el host y el puerto de tu servidor mysql):

my.basededatos.com;port=3307

Warning: PDO::__construct() [pdo.--construct]: [2002] Argumento no válido (intentando conectarse a través de unix: //) o "Checking database:Could not connect to the mysql server"¶

Esto significa que tu socket MySQL está configurado incorrectamente. Por lo general, esto se puede solucionar agregando (o actualizando) tu php.ini:

mysql.default_socket=/path/to/my/mysql.sock
mysqli.default_socket=/path/to/my/mysql.sock
pdo_mysql.default_socket=/path/to/my/mysql.sock

La página de inicio de sesión sigue redirigiéndome a si misma sin error¶

Esto puede suceder con las antiguas instalaciones beta de Revolution. Para solucionarlo, elimina las 3 configuraciones de sistema siguientes de la tabla [prefijo]_system_settings en la base de datos (donde prefijo es el prefijo de tu tabla):

• session_name
• session_cookie_path
• session_cookie_domain

Luego elimina el archivo core/cache/config.cache.php.

A menos, por supuesto, que los hayas cambiado explícitamente para algún propósito propio.

Rareza general en el Manager¶

En algunos sistemas, especialmente con alojamiento compartido, puede haber un problema con la configuración del sistema compress_js y/o compress_css. Ve a Administrador → Configuración del Sistema y escribe 'compress' (sin las comillas) en el cuadro de búsqueda, en la esquina superior derecha. Apaga las dos configuraciones, luego cierra la sesión, elimina todos los archivos en el directorio core/cache, borra la memoria caché y las cookies de tu navegador, y vuelve a iniciar sesión.

Si el Manager está lo suficientemente desordenado que no te deja cambiar la configuración, consulta la nota a continuación sobre cómo cambiar las dos configuraciones de sistema en la tabla modx_system_settings de la base de datos con PhpMyAdmin.

El árbol de recursos / elementos / archivos no aparece¶

Además, las "fallas" de la página pueden provenir de elementos almacenados en la memoria caché de tu propio navegador, lo que puede provocar que el árbol de recursos / elementos / archivos no aparezca debido a versiones antiguas de JavaScript y otros archivos que se utilizan en el lado del cliente. Esto puede verificarse accediendo al administrador con un navegador que no se utilizó anteriormente para hacerlo.

La solución simple: borra la memoria caché de tu navegador e inicia sesión nuevamente en el Manager .

Una solución más completa:

1. Menú principal → Contenido → Limpiar Caché
2. Menú de usuario → Acceso → Vaciar Permisos, luego Acceso → Vaciar Todas las Sesiones
3. Esto vaciará todo y cerrará sesión
4. Por último, borra la memoria caché del navegador

¡No puedo iniciar sesión en el administrador después de la instalación!¶

Si está redirigiendo nuevamente a la pantalla de inicio de sesión, intenta configurar esto en tu archivo .htaccess, en la raíz de tu instalación MODX:

php_value session.auto_start 0

No se pudo conectar con el servidor de la base de datos. Verifique las propiedades de conexión e intente nuevamente. Acceso denegado¶

En algunos alojamientos compartidos, si creas un nombre de usuario para tu base de datos con un guion bajo (_), puede causar problemas. Asegúrate de que el nombre de usuario de tu base de datos no contenga guion bajo e inténtalo de nuevo.

Otros casos frecuentes están cubiertos en Preguntas frecuentes y solución de problemas.

Si tu manager de MODX no se carga correctamente, faltan partes del Manager o hay errores de JavaScript 400 en el Manager¶

Si tu manager de MODX no se carga correctamente debido a errores 400 al intentar cargar los archivos JavaScript comprimidos (los paquetes listos como modx.jsgrps-min.js que sirve compress_js), es probable que se deba a una configuración incorrecta del servidor. Si esto no se puede rectificar en el servidor, puedes deshabilitar manualmente la compresión JS y CSS de la siguiente manera:

1. Entra en la base de datos utilizando PhpMyAdmin y busca la tabla prefijo_system_settings (prefijo suele ser modx).
2. Busca las filas con valores compress_js y compress_css en el campo key y establece su valor en 0, y guárdalas.
3. Vacía tu directorio core/cache/.
4. Borra la memoria caché y las cookies de tu navegador
5. Inicia sesión en el Manager.

Esto te permitirá usar el Manager sin compresión JS y CSS.

Faltan partes del Manager, cadenas de idioma indefinidas o hay errores de JavaScript 500 en el Manager¶

1. Asegúrate de que tu carpeta Connectors/ tenga permisos 0755

¿Aún tienes problemas??¶

Si todavía tienes problemas, publica tu error y la información del entorno del servidor en la Comunidad MODX, e intentaremos y solucionar tu problema lo antes posible.