Instalación y Configuración de Contao CMS en el Entorno ServBay

Contao es un potente sistema de gestión de contenidos de código abierto (CMS) especialmente indicado para la construcción de sitios web de pequeñas y medianas empresas, portales o aplicaciones web complejas. Esta guía detalla cómo instalar y configurar Contao en ServBay, un entorno local de desarrollo web para macOS que te permite iniciar rápidamente tus proyectos con Contao.

ServBay ofrece un entorno integral que integra PHP, Composer, servicios de bases de datos como MySQL/MariaDB y PostgreSQL, así como servidores web Caddy, Nginx y Apache, simplificando enormemente la configuración local. Con ServBay, puedes cubrir fácilmente todos los requisitos de ejecución de Contao.

¿Qué es Contao?

Contao es un CMS de código abierto construido sobre PHP, conocido por su alto nivel de flexibilidad, facilidad de uso y un potente panel de administración. Ofrece funcionalidades avanzadas como gestión detallada de permisos, control de versiones, soporte multiidioma, tratamiento responsivo de imágenes y una arquitectura modular que permite ampliar funcionalidades mediante extensiones. La filosofía de Contao es ofrecer una base sólida para que desarrolladores y diseñadores creen sitios web personalizados sin partir de cero.

Requisitos Previos

Antes de comenzar la instalación de Contao, asegúrate de cumplir con los siguientes requisitos:

1. ServBay instalado y en ejecución: Debes tener ServBay instalado en tu sistema macOS. Verifica que ServBay esté funcionando y que la versión de PHP necesaria (Contao requiere versiones específicas de PHP, consulta la documentación oficial de Contao para los requisitos actualizados) y los servicios de base de datos (como MySQL o MariaDB) estén activados en ServBay.
2. Composer: ServBay ya integra Composer, por lo que no necesitas instalarlo aparte.
3. Acceso a Terminal: Necesitarás la terminal para ejecutar los comandos de Composer.

Pasos para Instalar Contao

En esta sección encontrarás el proceso detallado para instalar y configurar Contao en el entorno ServBay.

Paso 1: Crear el Directorio del Proyecto

Primero, navega al directorio raíz por defecto de ServBay: /Applications/ServBay/www, y crea una nueva subcarpeta para tu proyecto de Contao.

cd /Applications/ServBay/www
mkdir servbay-contao-app
cd servbay-contao-app

Instalaremos Contao en el directorio servbay-contao-app.

Paso 2: Crear el Proyecto Contao con Composer

Contao recomienda la gestión e instalación vía Composer. Como ServBay ya incluye Composer, en el directorio del proyecto ejecuta el siguiente comando para crear el proyecto:

composer create-project contao/managed-edition .

Este comando descargará la última versión de Contao Managed Edition y todas sus dependencias en el directorio actual (.). El proceso puede tardar dependiendo de la velocidad de tu conexión.

Sobre Contao Managed Edition: contao/managed-edition es una versión oficial de Contao que incluye el núcleo y dependencias recomendadas, y configura una estructura estándar de proyecto. Ten en cuenta que el directorio público del sitio será la subcarpeta web dentro del proyecto.

Paso 3: Crear la Base de Datos y el Usuario

Contao requiere una base de datos para almacenar contenido y configuraciones. ServBay incluye herramientas de gestión como phpMyAdmin o Adminer para crear bases de datos y usuarios. A continuación, se describe el proceso usando phpMyAdmin:

1. Accede a phpMyAdmin provisto por ServBay

   Abre la URL local de ServBay: https://servbay.host/. Busca el enlace para ingresar a la herramienta phpMyAdmin.

2. Crea un usuario para la base de datos

   Por seguridad, es recomendable generar un usuario exclusivo para la aplicación Contao.

   a. Ve a la sección de cuentas de usuario

   En la página principal de phpMyAdmin, haz clic en el menú superior en “Cuentas de usuario”.
   

   b. Agrega una nueva cuenta de usuario

   Haz clic en “Agregar cuenta de usuario” y completa la siguiente información:
   
   *   **Nombre de usuario:** Elige un nombre para el usuario de la base de datos de Contao, por ejemplo `contao_user`.
   *   **Servidor:** Selecciona `localhost` para que sólo se permitan conexiones locales, lo que mejora la seguridad.
   *   **Contraseña:** Ingresa una **contraseña fuerte**. Evita contraseñas simples como `password123`; usa un generador de contraseñas para mayor solidez.
   *   **Repetir:** Ingresa nuevamente la contraseña.
   
   En la sección “Crear base de datos para el usuario”, normalmente elige “Crear una base de datos con el mismo nombre y otorgar todos los privilegios”. Así se crea automáticamente la base de datos `contao_user` y se conceden todos los permisos al usuario.
   
   *   Asegúrate de marcar la opción “Conceder todos los privilegios”.
   *   Haz clic en el botón “Ejecutar” al pie de la página para finalizar la creación.
   

Paso 4: Configurar el Sitio en ServBay

Ahora necesitas crear una configuración de sitio en ServBay apuntando al directorio de tu proyecto Contao.

1. Abrir ServBay y agregar un nuevo sitio

   Accede a la interfaz principal de ServBay. Haz clic en la pestaña “Sitios” en la barra lateral izquierda y pulsa el botón “Agregar” para crear una nueva configuración.

2. Completa la información de configuración

   • Nombre: Pon un nombre descriptivo, por ejemplo Mi Sitio Contao.
   • Dominio: Asigna un dominio local. Se recomienda usar .local o .servbay.demo, por ejemplo servbay-contao.local. ServBay resolverá automáticamente el dominio a tu máquina local.
   • Tipo de sitio: Selecciona PHP.
   • Versión de PHP: Elige la versión de PHP que cumpla con los requisitos de Contao según su documentación oficial.
   • Directorio raíz del sitio: Este paso es muy importante. Cuando instalas Contao con contao/managed-edition mediante Composer, los archivos públicos (incluyendo index.php) se encuentran en el subdirectorio web. Por tanto, la ruta debe señalar exactamente a: /Applications/ServBay/www/servbay-contao-app/web.

3. Guardar configuración

   Completa todos los campos y pulsa el botón “Guardar” en la parte inferior de la interfaz de ServBay. ServBay aplicará la nueva configuración del sitio.

Paso 5: Ejecutar el Instalador Web de Contao

Con el sitio ya configurado, puedes acceder al instalador web de Contao desde tu navegador usando el dominio local seleccionado.

1. Accede a la página de instalación

   Abre el navegador y entra a la ruta /contao/install usando el dominio configurado. Por ejemplo: https://servbay-contao.local/contao/install.

   Si todo está correctamente configurado, aparecerá la pantalla de instalación de Contao.

2. Introduce los datos de la base de datos

   El instalador te pedirá los detalles de acceso a la base de datos. Introduce los datos que creaste en el paso 3:

   • Host de la base de datos: localhost
   • Nombre de la base de datos: contao_user (si creaste una base de datos con el mismo nombre que el usuario)
   • Usuario: contao_user
   • Contraseña: La que asignaste en el paso anterior.

3. Crea el perfil de administrador

   Configura el usuario administrador del backend de Contao siguiendo las instrucciones e ingresa usuario, contraseña y correo electrónico. Asegúrate de usar una contraseña segura.

4. Finaliza la instalación

   Sigue los pasos restantes, los cuales normalmente incluyen la creación de las tablas de la base de datos. Haz clic en los botones correspondientes (“Instalar” o “Finalizar”) para completar la instalación.

Paso 6: Verificar la Instalación e Ingresar al Backend

Una vez completado el proceso de instalación, puedes verificar que Contao funcione y comenzar a administrar el sitio.

1. Visita la interfaz pública del sitio

   Accede desde el navegador al dominio configurado, por ejemplo https://servbay-contao.local/. Deberías ver la página de bienvenida por defecto de Contao o una página en blanco (ampliamente depende de la configuración por defecto). Esto indica que el servidor web funciona y el frontend de Contao está accesible.

2. Acceso al panel de administración de Contao

   Ingresa a la página de inicio de sesión para administradores, normalmente en https://servbay-contao.local/contao.

   Utiliza el usuario y contraseña que creaste en el paso 5 para acceder. Si todo es correcto, accederás al panel de administración y podrás comenzar a crear contenido, instalar extensiones y configurar el sitio.

Preguntas Frecuentes (FAQ)

P: ¿Qué hacer si obtengo un error al acceder a https://servbay-contao.local/ o https://servbay-contao.local/contao/install?

R:

• Verifica que ServBay está ejecutándose: Asegúrate que la app ServBay se encuentra activa junto con los servicios de PHP y el servidor web (Caddy o Nginx).
• Revisa la configuración del sitio: Comprueba nuevamente los datos de configuración en ServBay, especialmente el dominio, tipo de sitio, versión de PHP y la carpeta raíz del sitio. Recuerda que el directorio público para contao/managed-edition es la carpeta web dentro del proyecto.
• Comprueba la resolución de dominio: ServBay gestiona de forma automática los dominios .local. Si usaste otro sufijo o sigue el problema, prueba reiniciar ServBay o verifica el archivo hosts del sistema (aunque normalmente no es necesario).
• Consulta los logs del servidor web: Accede a los registros de Caddy o Nginx proporcionados por ServBay para obtener información más detallada sobre cualquier error.

P: ¿Qué hacer si falla la conexión a la base de datos?

R:

• Verifica que los servicios de base de datos están activos: Asegúrate que MySQL/MariaDB o PostgreSQL estén corriendo en ServBay.
• Confirma las credenciales: Comprueba que el host (localhost), la base de datos, el usuario y la contraseña que introduces coinciden con los creados en phpMyAdmin.
• Permisos del usuario: Verifica que el usuario creado tenga todos los permisos necesarios sobre la base de datos de Contao.

P: ¿Qué hacer si aparecen errores de permisos durante la instalación?

R: El instalador de Contao requiere permisos de escritura en ciertos directorios. Aunque la configuración predeterminada de ServBay suele ser suficiente, si encuentras problemas, puedes ajustar los permisos en la terminal así:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # Reemplaza your_username con tu usuario de macOS
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao puede requerir permisos de escritura aquí

Ten cuidado con chmod 777, ya que no es seguro para entornos en producción, aunque en desarrollo local es común para evitar problemas de permisos.

Resumen

Siguiendo esta guía, deberías haber instalado y configurado correctamente Contao CMS en un entorno local de ServBay. El entorno integrado de ServBay simplifica la gestión de dependencias con Composer, la creación de bases de datos y la configuración del servidor web, permitiéndote concentrarte en el desarrollo de tu sitio con Contao. Ahora puedes comenzar a crear contenido, diseñar páginas, instalar extensiones y temas desde el backend, y así construir tu web personalizada.

Para más información y recursos sobre el uso y posibilidades de Contao, consulta la documentación oficial de Contao.