Como Instalar TYPO3 CMS no Rocky Linux 9

TYPO3 é um sistema de gerenciamento de conteúdo de nível empresarial, gratuito e de código aberto. Ele fornece múltiplos recursos de nível empresarial, como CMS escalável com suporte a múltiplos sites, instalações multilíngues, forte implementação de segurança, extremamente rápido e pode ser executado em qualquer lugar.

Usar o TYPO3 CMS permite que você construa sites flexíveis e confiáveis. O TYPO3 CMS é suportado por uma vibrante comunidade profissional. E por design, o TYPO3 CMS é um sistema de gerenciamento de conteúdo plugável com arquitetura adaptável e desacoplada.

Neste guia, você instalará o TYPO3 CMS - Sistema de Gerenciamento de Conteúdo de Nível Empresarial - no servidor Rocky Linux 9. Você configurará o TYPO3 CMS com o servidor web httpd, banco de dados MariaDB e a versão mais recente do PHP 8.0. Este guia inclui a implementação de HTTPS via Certbot e Letsencrypt, que serão usados para proteger a implantação do TYPO3.

Pré-requisitos

Primeiro, você deve ter os seguintes requisitos para concluir este guia:

• Um servidor Rocky Linux 9 - Este exemplo usa um Rocky Linux com o nome do host ‘TYPO3-Roc k’.
• Um usuário não-root com privilégios sudo/root.
• Um SELinux em modo permissivo.
• Um nome de domínio apontado para um endereço IP do servidor - Este exemplo usa o domínio ‘howtoforge.local‘.

É isso. Quando todos os requisitos estiverem prontos, você pode começar a instalação.

Instalando o Servidor Web httpd

TYPO3 é um CMS (Sistema de Gerenciamento de Conteúdo) de nível empresarial e uma aplicação web escrita em PHP. Ele pode ser executado com vários tipos de servidores web. Neste exemplo, você instalará e executará o TYPO3 CMS com o servidor web httpd.

Antes de instalar qualquer pacote, insira o seguinte comando dnf para adicionar o repositório EPEL (Extra Package for Enterprise Linux) ao seu sistema. Este repositório será necessário mais tarde para instalar pacotes adicionais.

sudo dnf install epel-release

Agora execute o seguinte comando dnf para instalar o servidor web httpd. Quando solicitado, insira y para confirmar e pressione ENTER para prosseguir.

sudo dnf install httpd

Uma vez que o httpd esteja instalado, insira o seguinte comando systemctl para iniciar e habilitar o servidor web httpd. Isso fará com que o servidor web httpd seja executado e habilitado para iniciar automaticamente na inicialização do sistema.

sudo systemctl start httpd  
sudo systemctl enable httpd

Verifique o status do servidor web httpd usando o comando systemctl abaixo. Você deve receber uma saída como ‘enabled‘, que confirma que o serviço httpd será executado automaticamente na inicialização. E o status do servidor web httpd está em execução.

sudo systemctl is-enabled httpd  
sudo systemctl status httpd

Antes de acessar sua instalação do httpd, você deve abrir os protocolos HTTP e HTTPS em seu sistema Rocky Linux via firewalld.

Insira o seguinte comando firewall-cmd para adicionar as portas HTTP e HTTPS ao firewalld. Em seguida, recarregue o firewalld para aplicar as alterações.

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

A saída ‘success‘ confirma o sucesso da operação. Agora você pode verificar a lista de regras do firewalld via o seguinte comando.

sudo firewall-cmd --list-all

Na seção ‘services’, você deve ver ambos os protocolos HTTP e HTTPS adicionados ao firewalld.

Agora que você instalou o servidor web httpd e configurou o firewalld. Em seguida, você iniciará a instalação do servidor de banco de dados MariaDB.

Instalando o Servidor MariaDB

Nesta seção, você instalará o servidor de banco de dados MariaDB e protegerá a implantação automaticamente usando o comando ‘mariadb-secure-installation’.

Para começar, insira o seguinte comando dnf para instalar o servidor de banco de dados MariaDB.

sudo dnf install mariadb-server

Insira y quando solicitado e pressione ENTER para prosseguir.

Agora inicie e habilite o serviço MariaDB usando o seguinte comando systemctl. O serviço MariaDB deve agora estar em execução e também habilitado, o que significa que o serviço MariaDB será iniciado automaticamente na inicialização.

sudo systemctl start mariadb  
sudo systemctl enable mariadb

Insira o seguinte comando systemctl para verificar o serviço MariaDB e garantir que o serviço esteja em execução e habilitado.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Uma saída ‘enabled‘ confirma que o servidor MariaDB está habilitado e será executado automaticamente na inicialização do sistema. A saída ‘active (running)‘ confirma que o servidor MariaDB está em execução.

Por fim, execute o seguinte comando ‘mariadb-secure-installation’ para proteger a implantação do MariaDB.

sudo mariadb-secure-installation

Agora você será solicitado com as seguintes configurações - Você pode inserir y para confirmar ou n para não.

• Alterar a autenticação para unix_socket? insira n.
• Alterar a senha do root do MariaDB? insira y para confirmar, insira a nova senha para seu servidor MariaDB e repita a senha.
• Desabilitar login remoto do root? insira y para confirmar - o usuário root não deve ser permitido conectar-se remotamente.
• Remover usuário anônimo? insira y para confirmar.
• Remover o banco de dados padrão ‘test’? insira y para confirmar e remover o banco de dados de teste.
• Por fim, insira y para recarregar privilégios de tabelas e aplicar novas alterações.

Quando a implantação do MariaDB estiver concluída, você estará pronto para criar um novo banco de dados e usuário para a implantação do TYPO3 CMS.

Criando Banco de Dados e Usuário MariaDB

Nesta seção, você criará um novo banco de dados MariaDB e um usuário que serão usados para a instalação do TYPO3 CMS.

Primeiro, faça login no shell do MariaDB via o comando ‘mariadb‘ abaixo. Insira sua senha de root do MariaDB e pressione ENTER.

sudo mariadb -u root -p

Agora execute as seguintes consultas MariaDB para criar um novo banco de dados e usuário. Neste exemplo, você criará um novo banco de dados ‘typo3db‘ com o usuário ‘typo3‘. Certifique-se de alterar a senha nas seguintes consultas e use ‘utf8mb4‘ como o conjunto de caracteres padrão para seu banco de dados.

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

Em seguida, verifique a lista de usuários disponíveis no MariaDB usando a seguinte consulta. Você deve ver o novo usuário ‘typo3‘ adicionado e disponível em seu servidor MariaDB.

SELECT USER,host FROM mysql.user;

Por fim, verifique os privilégios para o usuário MariaDB ‘typo3‘ usando a seguinte consulta. Você deve ver que o usuário ‘typo3‘ tem todos os privilégios para o banco de dados ‘typo3db‘.

SHOW GRANTS FOR typo3@localhost;

Agora digite quit para sair do shell do MariaDB.

Com isso, você agora terminou a configuração do banco de dados MariaDB para a instalação do TYPO3 CMS. Passe para a próxima etapa para iniciar a instalação do PHP.

Instalando PHP 8.0

O TYPO3 CMS é principalmente escrito em PHP, e no momento da redação deste documento, a versão mais recente do TYPO3 CMS suporta pacotes PHP 8.x. Nesta seção, você instalará o PHP 8.0, que está disponível por padrão no repositório Rocky Linux 9.

Insira o seguinte comando dnf para instalar os pacotes PHP 8.0. Quando solicitado, insira y para confirmar e pressione ENTER para prosseguir.

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

Uma vez que o PHP esteja instalado, abra o arquivo de configuração ‘/etc/php.ini’ usando o seguinte comando do editor nano.

sudo nano /etc/php.ini

Altere as configurações padrão do php.ini com as seguintes linhas.

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

Salve e saia do arquivo ‘/etc/php.ini‘ quando terminar.

Agora execute o seguinte comando systemctl para reiniciar o serviço httpd e aplicar as novas alterações que você fez no arquivo ‘php.ini’.

sudo systemctl restart httpd

Você também pode verificar a versão atual do PHP via o comando ‘php’ abaixo. Você deve receber uma saída que o PHP 8.0 está instalado em seu sistema.

php --version

Agora você instalou os pacotes PHP 8.0 e configurou o arquivo php.ini. Na próxima etapa, você instalará o Composer - gerenciador de dependências para PHP - que será usado para instalar as dependências PHP do TYPO3 CMS.

Instalando o Composer

O Composer é um gerenciador de dependências de nível de aplicativo PHP. Ele pode ser instalado manualmente via o script de instalador oficial, ou você pode instalá-lo via o repositório EPEL.

Insira o seguinte comando dnf para instalar o Composer do repositório EPEL. Quando solicitado, insira y para confirmar e pressione ENTER para prosseguir.

sudo dnf install composer

Uma vez que o Composer esteja instalado, insira o seguinte comando para verificar a versão do Composer.

sudo -u apache composer -V

A saída abaixo confirma que o Composer v2.5.1 está instalado em seu sistema Rocky Linux.

Com o Composer instalado, o próximo passo é instalar o Certbot, que será usado para gerar certificados SSL/TLS do Letsencrypt.

Instalando o Certbot

O Certbot é uma ferramenta de linha de comando para gerar certificados SSL/TLS do Letsencrypt. Para distribuições baseadas em RHEL, você pode instalar o Certbot do repositório EPEL.

Insira o seguinte comando dnf para instalar os pacotes ‘certbot‘ e ‘python3-certbot-apache‘ em seu sistema. Insira y quando solicitado e pressione ENTER para prosseguir.

sudo dnf install certbot python3-certbot-apache

Uma vez que a instalação esteja concluída, execute o seguinte comando para verificar sua instalação.

which certbot  
certbot --version

O caminho binário do comando ‘certbot‘ está disponível em ‘/bin/certbot‘. E a versão do certbot que você instalou é v2.1.0.

Com o Composer e o Certbot instalados, você está pronto para instalar o TYPO3 CMS.

Baixando o Código Fonte do TYPO3 CMS

Nesta seção, você configurará o diretório de instalação de destino e fará o download do código fonte do TYPO3 CMS.

Insira o seguinte comando para criar um novo diretório ‘/var/www/typo3‘. Este será usado como o diretório raiz de instalação do TYPO3 CMS.

mkdir -p /var/www/typo3

Altere a propriedade do diretório ‘/var/www/typo3’ para o usuário e grupo ‘apache‘. Além disso, você deve garantir que o proprietário deste diretório possa ler e escrever nele. Com isso, você dará acesso ao código fonte do TYPO3 CMS ao servidor web httpd que é executado por padrão com um usuário ‘apache‘.

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

Agora vá para o diretório ‘/var/www/typo3‘ e baixe o código fonte do TYPO3 CMS usando o seguinte comando do composer.

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

Saída:

Uma vez que o código fonte do TYPO3 CMS esteja baixado, insira o seguinte comando para verificar a lista de arquivos e diretórios no diretório ‘/var/www/typo3’.

ls -lah /var/www/typo3

A saída abaixo confirma que o código fonte do TYPO3 CMS foi baixado. Além disso, você deve garantir que a propriedade do código fonte do TYPO3 CMS seja do usuário e grupo ‘apache‘.

Agora que você baixou o código fonte do TYPO3 CMS, você criará e configurará a configuração do host virtual httpd que será usada para executar o TYPO3 CMS.

Configurando o Host Virtual httpd

Nesta seção, você criará uma nova configuração de host virtual httpd que será usada para executar o TYPO3 CMS. Você também gerará certificados SSL/TLS do Letsencrypt via o comando Certbot.

Antes de começar, certifique-se de que você tenha o nome de domínio apontado para o endereço IP do seu servidor e um endereço de e-mail que será usado para se registrar no Letsencrypt.

Crie um novo arquivo de configuração de host virtual httpd ‘/etc/httpd/conf.d/typo3.conf’ usando o seguinte comando do editor nano.

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

Adicione as seguintes linhas ao arquivo e certifique-se de alterar o nome de domínio da instalação do 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]  
      

Salve e saia do arquivo ‘/etc/httpd/conf.d/typo3.conf’ quando terminar.

Em seguida, execute o seguinte comando para verificar e garantir que você tenha as configurações httpd adequadas. Quando bem-sucedido, você deve receber uma saída como ‘syntax OK‘.

sudo apachectl configtest

Agora insira o seguinte comando systemctl para reiniciar o serviço httpd e aplicar as alterações.

sudo systemctl restart httpd

Com isso, você agora terminou a configuração do host virtual httpd para o TYPO3 CMS.

Agora insira o seguinte comando certbot para gerar certificados SSL/TLS para o nome de domínio do seu TYPO3 CMS. Além disso, certifique-se de alterar o nome de domínio e endereço de e-mail no seguinte comando.

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

Quando terminar, seus certificados SSL/TLS estarão disponíveis no diretório ‘/etc/letsencrypt/live/yourdomain.com/‘. Além disso, sua configuração de host virtual httpd será automaticamente configurada com certificados SSL e o redirecionamento automático de HTTP para HTTPS.

Com isso, você agora terminou a configuração do servidor web httpd para o TYPO3 CMS. Você também gerou certificados SSL/TLS para o nome de domínio do seu TYPO3 CMS. Agora você pode acessar sua instalação do TYPO3 CMS.

Iniciar Instalação do TYPO3

Antes de começar a instalação do TYPO3 CMS, você deve criar um novo arquivo em branco ‘FIRST_INSTALL‘ no diretório ‘/var/www/typo3/public/‘. Isso indicará que você está instalando o TYPO3 CMS pela primeira vez neste servidor.

Insira o seguinte comando para criar um novo arquivo ‘FIRST_INSTALL‘ dentro do diretório ‘/var/www/typo3/public/‘.

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

Agora abra seu navegador web e insira o nome de domínio da sua instalação do TYPO3 CMS (ou seja: https://howtoforge.local/).

O instalador do TYPO3 CMS verificará e confirmará seu ambiente de sistema na primeira página. Certifique-se de que você obtenha o botão ‘No problems detected, continue with installation‘, que confirma que seu sistema está pronto para a instalação do TYPO3 CMS.

Agora insira seus detalhes do usuário MariaDB que serão usados para a instalação do TYPO3 CMS.

Selecione a opção ‘Use an existing empty database‘ e selecione o banco de dados ‘typo3db‘ no menu suspenso. Em seguida, clique em Continue.

Agora insira o nome de usuário, endereço de e-mail e senha para o usuário administrador do TYPO3 CMS. Certifique-se de usar uma senha forte para isso.

Clique em Continue para prosseguir.

Quando terminar, você deve receber uma saída como ‘Installation Complete‘.

Agora selecione a opção ‘Take me straight to the backend‘ e clique no botão ‘Open the TYPO3 Backend‘ para continuar.

E você será redirecionado para a página de login do TYPO3 CMS. Insira seu usuário administrador e senha, em seguida, clique em Login.

Se bem-sucedido, você deve ver o painel de administração do TYPO3 CMS.

Você pode verificar os detalhes do software que está usando para a instalação do TYPO3 CMS clicando no menu ‘Application Information’ no lado esquerdo do perfil do usuário.

Você deve ver detalhes semelhantes na captura de tela a seguir - No momento da redação deste documento, você instalou o TYPO3 CMS v11.5 com servidores web httpd/Apache, PHP 8.0 e o servidor de banco de dados MariaDB.

Conclusão

Neste guia, você instalou um sistema de gerenciamento de conteúdo de nível empresarial TYPO3 CMS em um servidor Rocky Linux 9. Você instalou o TYPO3 CMS com o servidor web httpd, servidor de banco de dados MariaDB e PHP 8.0.

Além disso, você também instalou o Certbot para gerar certificados SSL do Letsencrypt. E também protegeu a instalação do TYPO3 CMS via certificados SSL/TLS e configurou o redirecionamento automático de HTTP para HTTPS via Certbot.

Com isso, você pode começar sua configuração do TYPO3 CMS criando um registro de site, adicionando usuários do backend e adicionando idioma do backend para habilitar multilíngue. Para saber mais sobre o TYPO3 CMS, visite a documentação oficial do TYPO3.