Cómo solucionar problemas en Joomla 3.4 al conectarse a una base de datos

El día de hoy estuve migrando un sitio que está hecho en Joomla 3.4 y de pronto recibí un error que estaba relacionado con la base de datos.

Quizás a algunos webmasters o usuarios les ha sucedido esto, y aprovecho para tratar de ayudarlos a resolver este problema. Lo primero, será ver como trabaja la conexión de base de datos, y luego vamos a tratar de descubrir que cosa está causando el problema.

Cómo funcionan las conexiones de base de datos en Joomla

La realidad es que no importa si se está ejecutando actualmente Joomla 1.0 o Joomla 3.0, porque en esencia, se aplicará el siguiente principio:

Principio

Tu cuenta de Hosting	El archivo configuration.php de Joomla
En el servidor se debe de tener: Una base de datos configurada Un nombre de usuario y la contraseña de base de datos El usuario de base de datos debe de tener los privilegios que le permitam acceder a la base de datos	El archivo de configuración debe coincidir con la configuración del servidor, por ejemplo:  Debe de tener el mismo nombre de usuario y la contraseña de base de datos que se encuentra en la cuenta del hosting Debe tener el nombre del servidor y de la base de datos correcta. Lo más frecuente es localhost, pero sólo el proveedor de hosting es quien te puede decir la respuesta correcta.

Si su cuenta de hosting no está bien configurada correctamente con una base de datos, o bien, si el archivo de configuración de Joomla no está configurado con esas mismas credenciales que se configuran en el host, lo más probable es que vas a recibir los mensajes de error.

Error al mostrar la página de error en el navegador

El error se muestra en inglés en la pantalla del navegador y dice: Error displaying the error page: Application Instantiation Error

Problema

Las siguientes causas hacen que este mensaje de error aparezca:

1. El nombre de usuario de base de datos en nuestro archivo configuration.php no coincide con lo que está configurado en nuestra cuenta de hosting
2. La contraseña de la base de datos en nuestro archivo configuration.php no coincide con lo que de lo que está configurado en nuestra cuenta de hosting
3. El nombre del host de la base de datos no puede conectarse a nuestro archivo configuration.php

Solución

En el archivo configuration.php de Joomla, hay que asegurarse que el nombre de usuario, la contraseña y el nombre del servidor de la base de datos sea la que se establece por el hosting.

Es el hosting el que define las siguientes variables:

// El nombre del usuario de la base de datos va aquí
public $user = 'database-username';
// La contraseña del usuario de la base de datos
public $password = 'database-password';
// El nombre del servidor donde se aloja la BD
public $host = 'localhost';