Cómo instalar TYPO3 CMS en Rocky Linux 9

TYPO3 es un sistema de gestión de contenido de nivel empresarial, gratuito y de código abierto. Proporciona múltiples características de nivel empresarial, como un CMS escalable con soporte para múltiples sitios, instalaciones multilingües, una implementación de seguridad sólida, es extremadamente rápido y se puede ejecutar en cualquier lugar.

Usar TYPO3 CMS te permite construir sitios web flexibles y confiables. El TYPO3 CMS tiene una comunidad profesional vibrante en su backend. Y por diseño, el TYPO3 CMS es un sistema de gestión de contenido extensible con una arquitectura adaptable y desacoplada.

En esta guía, instalarás TYPO3 CMS - Sistema de Gestión de Contenido de Nivel Empresarial - en un servidor Rocky Linux 9. Configurarás TYPO3 CMS con el servidor web httpd, la base de datos MariaDB y la última versión de PHP 8.0. Esta guía incluye la implementación de HTTPS a través de Certbot y Letsencrypt, que se utilizarán para asegurar la implementación de TYPO3.

Requisitos previos

Primero, debes tener los siguientes requisitos para completar esta guía:

• Un servidor Rocky Linux 9 - Este ejemplo utiliza un Rocky Linux con el nombre de host ‘TYPO3-Roc k’.
• Un usuario no root con privilegios sudo/root.
• Un SELinux ejecutándose en modo permisivo.
• Un nombre de dominio apuntando a una dirección IP del servidor - Este ejemplo utiliza el dominio ‘howtoforge.local‘.

Eso es todo. Cuando todos los requisitos estén listos, ahora puedes comenzar la instalación.

Instalando el servidor web httpd

TYPO3 es un CMS (Sistema de Gestión de Contenido) de nivel empresarial y una aplicación web escrita en PHP. Se puede ejecutar con varios tipos de servidores web. En este ejemplo, instalarás y ejecutarás TYPO3 CMS con el servidor web httpd.

Antes de instalar cualquier paquete, ingresa el siguiente comando dnf para agregar el repositorio EPEL (Paquete Extra para Linux Empresarial) a tu sistema. Este repositorio será necesario más adelante para instalar paquetes adicionales.

sudo dnf install epel-release

Ahora ejecuta el siguiente comando dnf para instalar el servidor web httpd. Cuando se te pida, ingresa y para confirmar y presiona ENTER para continuar.

sudo dnf install httpd

Una vez que httpd esté instalado, ingresa el siguiente comando de utilidad systemctl para iniciar y habilitar el servidor web httpd. Esto ejecutará el servidor web httpd y lo habilitará para que se inicie automáticamente al arrancar el sistema.

sudo systemctl start httpd  
sudo systemctl enable httpd

Verifica el estado del servidor web httpd usando el siguiente comando systemctl. Deberías recibir una salida como ‘enabled‘, lo que confirma que el servicio httpd se ejecutará automáticamente al inicio. Y el estado del servidor web httpd está en ejecución.

sudo systemctl is-enabled httpd  
sudo systemctl status httpd

Antes de acceder a tu instalación de httpd, debes abrir los protocolos HTTP y HTTPS en tu sistema Rocky Linux a través de firewalld.

Ingresa el siguiente comando firewall-cmd para agregar ambos puertos HTTP y HTTPS al firewalld. Luego, recarga el firewalld para aplicar los cambios.

sudo firewall-cmd --add-service={http,https} --permanent  
sudo firewall-cmd --reload

La salida ‘success‘ confirma el éxito de la operación. Ahora puedes verificar la lista de reglas de firewalld a través del siguiente comando.

sudo firewall-cmd --list-all

En la sección ‘services’, deberías ver que ambos protocolos HTTP y HTTPS se han agregado al firewalld.

Ahora que has instalado el servidor web httpd y configurado firewalld. A continuación, comenzarás la instalación del servidor de base de datos MariaDB.

Instalando el servidor MariaDB

En esta sección, instalarás el servidor de base de datos MariaDB y asegurarás la implementación automáticamente usando el comando ‘mariadb-secure-installation’.

Para comenzar, ingresa el siguiente comando dnf para instalar el servidor de base de datos MariaDB.

sudo dnf install mariadb-server

Ingresa y cuando se te pida y presiona ENTER para continuar.

Ahora inicia y habilita el servicio de MariaDB usando el siguiente comando de utilidad systemctl. El servicio de MariaDB debería estar ahora en ejecución y también habilitado, lo que significa que el servicio de MariaDB se iniciará automáticamente al arrancar.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Ingresa el siguiente comando systemctl para verificar el servicio de MariaDB y asegurarte de que el servicio esté en ejecución y habilitado.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Una salida ‘enabled‘ confirma que el servidor MariaDB está habilitado y se ejecutará automáticamente al inicio del sistema. La salida ‘active (running)‘ confirma que el servidor MariaDB está en ejecución.

Por último, ejecuta el siguiente comando ‘mariadb-secure-installation’ para asegurar la implementación de MariaDB.

sudo mariadb-secure-installation

Ahora se te preguntará sobre las siguientes configuraciones - Puedes ingresar y para confirmar o n para no.

• ¿Cambiar la autenticación a unix_socket? ingresa n.
• ¿Cambiar la contraseña de root de MariaDB? ingresa y para confirmar, ingresa la nueva contraseña para tu servidor MariaDB y repite la contraseña.
• ¿Deshabilitar el inicio de sesión remoto de root? ingresa y para confirmar - el usuario root no debe poder conectarse de forma remota.
• ¿Eliminar el usuario anónimo? ingresa y para confirmar.
• ¿Eliminar la base de datos predeterminada ‘test’? ingresa y para confirmar y eliminar la base de datos de prueba.
• Por último, ingresa y para recargar los privilegios de las tablas y aplicar los nuevos cambios.

Cuando la implementación de MariaDB haya terminado, estarás listo para crear una nueva base de datos y un usuario para la implementación de TYPO3 CMS.

Creando la base de datos y el usuario de MariaDB

En esta sección, crearás una nueva base de datos de MariaDB y un usuario que se utilizarán para la instalación de TYPO3 CMS.

Primero, inicia sesión en el shell de MariaDB a través del comando ‘mariadb‘ a continuación. Ingresa tu contraseña de root de MariaDB y presiona ENTER.

sudo mariadb -u root -p

Ahora ejecuta las siguientes consultas de MariaDB para crear una nueva base de datos y usuario. En este ejemplo, crearás una nueva base de datos ‘typo3db‘ con el usuario ‘typo3‘. Asegúrate de cambiar la contraseña en las siguientes consultas y asegúrate de usar ‘utf8mb4‘ como el conjunto de caracteres predeterminado para tu base de datos.

CREATE DATABASE typo3db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;  
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'typo3password';  
FLUSH PRIVILEGES;

A continuación, verifica la lista de usuarios disponibles en MariaDB usando la siguiente consulta. Deberías ver el nuevo usuario ‘typo3‘ agregado y disponible en tu servidor MariaDB.

SELECT USER,host FROM mysql.user;

Por último, verifica los privilegios para el usuario de MariaDB ‘typo3‘ usando la siguiente consulta. Deberías ver que el usuario ‘typo3‘ tiene todos los privilegios sobre la base de datos ‘typo3db‘.

SHOW GRANTS FOR typo3@localhost;

Ahora escribe quit para cerrar sesión en el shell de MariaDB.

Con esto, has terminado la configuración de la base de datos de MariaDB para la instalación de TYPO3 CMS. Pasa al siguiente paso para comenzar la instalación de PHP.

Instalando PHP 8.0

TYPO3 CMS está escrito principalmente en PHP, y en el momento de escribir esto, la última versión de TYPO3 CMS admite paquetes PHP 8.x. En esta sección, instalarás PHP 8.0, que está disponible por defecto en el repositorio de Rocky Linux 9.

Ingresa el siguiente comando dnf para instalar los paquetes de PHP 8.0. Cuando se te pida, ingresa y para confirmar y presiona ENTER para continuar.

sudo dnf install php php-common php-mysqlnd php-gd php-curl php-json php-intl php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap

Una vez que PHP esté instalado, abre el archivo de configuración ‘/etc/php.ini’ usando el siguiente comando del editor nano.

sudo nano /etc/php.ini

Cambia las configuraciones predeterminadas de php.ini con las siguientes líneas.

memory_limit = 512M  
max_execution_time = 300  
max_input_vars = 2000  
  
date.timezone = Europe/Stockholm  
  
post_max_size = 30M  
upload_max_filesize = 30M

Guarda y cierra el archivo ‘/etc/php.ini‘ cuando termines.

Ahora ejecuta el siguiente comando de utilidad systemctl para reiniciar el servicio httpd y aplicar los nuevos cambios que has realizado en el archivo ‘php.ini’.

sudo systemctl restart httpd

También puedes verificar la versión actual de PHP a través del comando ‘php’ a continuación. Deberías recibir una salida que confirme que PHP 8.0 está instalado en tu sistema.

php --version

Ahora has instalado los paquetes de PHP 8.0 y configurado el archivo php.ini. En el siguiente paso, instalarás Composer - gestor de dependencias para PHP - que se utilizará para instalar las dependencias de PHP de TYPO3 CMS.

Instalando Composer

Composer es un gestor de dependencias para PHP a nivel de aplicación. Se puede instalar manualmente a través del script de instalación oficial, o puedes instalarlo a través del repositorio EPEL.

Ingresa el siguiente comando dnf para instalar Composer desde el repositorio EPEL. Cuando se te pida, ingresa y para confirmar y presiona ENTER para continuar.

sudo dnf install composer

Una vez que Composer esté instalado, ingresa el siguiente comando para verificar la versión de Composer.

sudo -u apache composer -V

La salida a continuación confirma que Composer v2.5.1 está instalado en tu sistema Rocky Linux.

Con Composer instalado, el siguiente paso es instalar Certbot, que se utilizará para generar certificados SSL/TLS de Letsencrypt.

Instalando Certbot

Certbot es una herramienta de línea de comandos para generar certificados SSL/TLS de Letsencrypt. Para distribuciones basadas en RHEL, puedes instalar Certbot desde el repositorio EPEL.

Ingresa el siguiente comando dnf para instalar los paquetes ‘certbot‘ y ‘python3-certbot-apache‘ en tu sistema. Ingresa y cuando se te pida y presiona ENTER para continuar.

sudo dnf install certbot python3-certbot-apache

Una vez que la instalación haya finalizado, ejecuta el siguiente comando para verificar tu instalación.

which certbot  
certbot --version

La ruta binaria del comando ‘certbot‘ está disponible en ‘/bin/certbot‘. Y la versión de certbot que has instalado es v2.1.0.

Con Composer y Certbot instalados, estás listo para instalar TYPO3 CMS.

Descargando el código fuente de TYPO3 CMS

En esta sección, configurarás el directorio de instalación de destino y descargarás el código fuente de TYPO3 CMS.

Ingresa el siguiente comando para crear un nuevo directorio ‘/var/www/typo3‘. Este se utilizará como el directorio raíz de instalación de TYPO3 CMS.

mkdir -p /var/www/typo3

Cambia la propiedad del directorio ‘/var/www/typo3‘ al usuario y grupo ‘apache‘. Además, debes asegurarte de que el propietario de este directorio pueda leer y escribir en él. Con esto, darás acceso al código fuente de TYPO3 CMS al servidor web httpd que se ejecuta por defecto con un usuario ‘apache‘.

sudo chown -R apache:apache /var/www/typo3  
sudo chmod u+rw /var/www/typo3

Ahora ve al directorio ‘/var/www/typo3‘ y descarga el código fuente de TYPO3 CMS usando el siguiente comando de composer.

cd /var/www/typo3  
sudo -u apache composer create-project typo3/cms-base-distribution:^11 .

Salida:

Una vez que el código fuente de TYPO3 CMS esté descargado, ingresa el siguiente comando para verificar la lista de archivos y directorios en el directorio ‘/var/www/typo3‘.

ls -lah /var/www/typo3

La salida a continuación confirma que el código fuente de TYPO3 CMS se ha descargado. Además, debes asegurarte de que la propiedad del código fuente de TYPO3 CMS sea el usuario y grupo ‘apache‘.

Ahora que has descargado el código fuente de TYPO3 CMS, a continuación crearás y configurarás la configuración del host virtual httpd que se utilizará para ejecutar TYPO3 CMS.

Configurar el host virtual httpd

En esta sección, crearás una nueva configuración de host virtual httpd que se utilizará para ejecutar TYPO3 CMS. También generarás certificados SSL/TLS de Letsencrypt a través del comando Certbot.

Antes de comenzar, asegúrate de que tienes el nombre de dominio apuntando a la dirección IP de tu servidor y una dirección de correo electrónico que se utilizará para registrarse en Letsencrypt.

Crea un nuevo archivo de configuración de host virtual httpd ‘/etc/httpd/conf.d/typo3.conf‘ usando el siguiente comando del editor nano.

sudo nano /etc/httpd/conf.d/typo3.conf

Agrega las siguientes líneas al archivo y asegúrate de cambiar el nombre de dominio de la instalación de TYPO3 CMS.

  
    ServerAdmin [email protected]  
    DocumentRoot /var/www/typo3/public  
    ServerName howtoforge.local  
  
    Protocols h2 http/1.1  
  
       
          Options FollowSymlinks  
          AllowOverride All  
          Require all granted  
       
  
     ErrorLog /var/log/httpd/typo3-error.log  
     CustomLog /var/log/httpd/typo3-access.log combined  
      
       
            RewriteEngine on  
            RewriteBase /  
            RewriteCond %{REQUEST_FILENAME} !-f  
            RewriteRule ^(.*) index.php [PT,L]  
      

Guarda y cierra el archivo ‘/etc/httpd/conf.d/typo3.conf‘ cuando termines.

A continuación, ejecuta el siguiente comando para verificar y asegurarte de que tienes configuraciones httpd adecuadas. Cuando sea exitoso, deberías recibir una salida como ‘syntax OK‘.

sudo apachectl configtest

Ahora ingresa el siguiente comando de utilidad systemctl para reiniciar el servicio httpd y aplicar los cambios.

sudo systemctl restart httpd

Con esto, has terminado la configuración del host virtual httpd para TYPO3 CMS.

Ahora ingresa el siguiente comando certbot para generar certificados SSL/TLS para tu nombre de dominio de TYPO3 CMS. Además, asegúrate de cambiar el nombre de dominio y la dirección de correo electrónico en el siguiente comando.

sudo certbot --apache --agree-tos --no-eff-email  --redirect --hsts --staple-ocsp --email [email protected] -d howtoforge.local

Cuando termines, tus certificados SSL/TLS estarán disponibles en el directorio ‘/etc/letsencrypt/live/yourdomain.com/‘. Además, tu configuración de host virtual httpd se configurará automáticamente con certificados SSL y la redirección automática de HTTP a HTTPS.

Con esto, has terminado la configuración del servidor web httpd para TYPO3 CMS. También has generado certificados SSL/TLS para tu nombre de dominio de TYPO3 CMS. Ahora puedes acceder a tu instalación de TYPO3 CMS.

Comenzar la instalación de TYPO3

Antes de comenzar la instalación de TYPO3 CMS, debes crear un nuevo archivo en blanco ‘FIRST_INSTALL‘ en el directorio ‘/var/www/typo3/public/‘. Esto indicará que estás instalando TYPO3 CMS por primera vez en este servidor.

Ingresa el siguiente comando para crear un nuevo archivo ‘FIRST_INSTALL‘ dentro del directorio ‘/var/www/typo3/public/‘.

sudo -u apache touch /var/www/typo3/public/FIRST_INSTALL

Ahora abre tu navegador web e ingresa el nombre de dominio de tu instalación de TYPO3 CMS (es decir: https://howtoforge.local/).

El instalador de TYPO3 CMS verificará y comprobará tu entorno del sistema en la primera página. Asegúrate de que obtienes el botón ‘No se detectaron problemas, continuar con la instalación‘, lo que confirma que tu sistema está listo para la instalación de TYPO3 CMS.

Ahora ingresa tus detalles del usuario de MariaDB que se utilizarán para la instalación de TYPO3 CMS.

Selecciona la opción ‘Usar una base de datos vacía existente‘ y selecciona la base de datos ‘typo3db‘ en el menú desplegable. Luego haz clic en Continuar.

Ahora ingresa el nombre de usuario, la dirección de correo electrónico y la contraseña para el usuario administrador de TYPO3 CMS. Asegúrate de usar una contraseña fuerte para esto.

Haz clic en Continuar para proceder.

Cuando termines, deberías recibir una salida como ‘Instalación Completa‘.

Ahora selecciona la opción ‘Llévame directamente al backend‘ y haz clic en el botón ‘Abrir el Backend de TYPO3‘ para continuar.

Y serás redirigido a la página de inicio de sesión de TYPO3 CMS. Ingresa tu usuario administrador y contraseña, luego haz clic en Iniciar sesión.

Si es exitoso, deberías ver el panel de administración de TYPO3 CMS.

Puedes verificar los detalles del software que estás utilizando para la instalación de TYPO3 CMS haciendo clic en el menú ‘Información de la Aplicación’ en el lado izquierdo del perfil de usuario.

Deberías ver detalles similares en la siguiente captura de pantalla - En el momento de escribir esto, has instalado TYPO3 CMS v11.5 con servidores web httpd/Apache, PHP 8.0 y el servidor de base de datos MariaDB.

Conclusión

En esta guía, has instalado un sistema de gestión de contenido de nivel empresarial TYPO3 CMS en un servidor Rocky Linux 9. Has instalado TYPO3 CMS con el servidor web httpd, el servidor de base de datos MariaDB y PHP 8.0.

Además de eso, también has instalado Certbot para generar certificados SSL de Letsencrypt. Y también aseguraste la instalación de TYPO3 CMS a través de certificados SSL/TLS y configuraste la redirección automática de HTTP a HTTPS a través de Certbot.

Con esto, puedes comenzar tu configuración de TYPO3 CMS creando un registro de sitio, agregando usuarios del backend y agregando un idioma del backend para habilitar el multilenguaje. Para aprender más sobre TYPO3 CMS, visita la documentación oficial de TYPO3.