Como instalar o CMS TYPO3 no Rocky Linux 9

TYPO3 é um sistema de gerenciamento de conteúdo de nível empresarial gratuito e de código aberto. Ele fornece vários recursos de nível empresarial, como CMS escalonável com suporte multisite, 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 construir sites flexíveis e confiáveis. O TYPO3 CMS é o backend de uma comunidade profissional vibrante. E por design, o TYPO3 CMS é um sistema de gerenciamento de conteúdo conectável com arquitetura adaptável e desacoplada.

Neste guia, você instalará o TYPO3 CMS - Enterprise-grade Content Management System - 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á usado para proteger a implantação do TYPE3.

Pré-requisitos

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

Servidor Once Rocky Linux 9 - Este exemplo usa um Rocky Linux com o nome de host 'TYPO3-Rock'.
Um usuário não root com privilégios sudo/root.
Um SELinux rodando em modo permissivo.
Um nome de domínio apontado para um endereço IP de servidor - Este exemplo usa o domínio 'hwdomain.io'.

É isso. Quando todos os requisitos estiverem prontos, você poderá iniciar a instalação.

Instalando o servidor web httpd

TYPO3 é um CMS (Content Management System) de nível empresarial e um aplicativo da web escrito em PHP. Ele pode ser executado com vários tipos de servidor web. Neste exemplo, você instalará e executará o CMS TYPE3 com o servidor web httpd.

Antes de instalar qualquer pacote, digite o seguinte comando dnf para adicionar o repositório EPEL (Pacote Extra para Enterprise Linux) ao seu sistema. Este repositório será necessário posteriormente 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 continuar.

sudo dnf install httpd

Depois de instalar o httpd, insira o seguinte utilitário de comando systemctl para iniciar e ativar o servidor web httpd. Isso executará o servidor web httpd e permitirá que ele seja iniciado 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ê deverá 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 a 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 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 'sucesso' confirma o sucesso da operação. Agora você pode verificar a lista de regras do firewalld por meio do seguinte comando.

sudo firewall-cmd --list-all

Na seção 'serviços', você deverá ver os protocolos HTTP e HTTPS adicionados ao firewalld.

Agora que você instalou o servidor web httpd e configurou o firewalld. A seguir, 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, digite 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 continuar.

Agora inicie e habilite o serviço MariaDB usando o seguinte utilitário de comando systemctl. O serviço MariaDB agora deve 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 'ativo (em execução)' confirma que o servidor MariaDB está em execução.

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

sudo mariadb-secure-installation

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

Alterar autenticação para unix_socket? entrada
Alterar a senha root do MariaDB? insira y para confirmar, insira a nova senha do seu servidor MariaDB e repita a senha.
Desativar login root remoto? insira y para confirmar - o usuário root não deve ter permissão para se conectar remotamente.
Remover usuário anônimo? insira y para confirmar.
Remover o 'teste' do banco de dados padrão? insira y para confirmar e remover o banco de dados de teste.
Por último, insira y para recarregar os privilégios das tabelas e aplicar novas alterações.

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

Criando banco de dados e usuário MariaDB

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

Primeiro, faça login no shell MariaDB por meio do comando 'mariadb' abaixo. Insira sua senha 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 consultas a seguir e de usar '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;

A seguir, verifique a lista de usuários disponíveis no MariaDB usando a seguinte consulta. Você deverá ver o novo usuário 'typo3' adicionado e disponível em seu servidor MariaDB.

SELECT USER,host FROM mysql.user;

Por último, verifique os privilégios do usuário MariaDB 'typo3' usando a consulta a seguir. Você deverá 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 MariaDB.

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

Instalando o PHP 8.0

O TYPO3 CMS é escrito principalmente em PHP e, no momento em que este livro foi escrito, a versão mais recente do TYPO3 CMS suportava 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.

Digite o seguinte comando dnf para instalar pacotes PHP 8.0. Quando solicitado, insira y para confirmar e pressione 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

Depois que o PHP estiver 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 utilitário de comando systemctl para reiniciar o serviço httpd e aplicar as novas alterações feitas no arquivo 'php.ini'.

sudo systemctl restart httpd

Você também pode verificar a versão atual do PHP através do comando ‘php’ abaixo. Você deverá receber uma mensagem informando 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 Compositor

Composer é um gerenciador de dependências PHP em nível de aplicativo. Ele pode ser instalado manualmente por meio do script de instalação oficial ou por meio do repositório EPEL.

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

sudo dnf install composer

Depois que o Composer estiver instalado, digite 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á utilizado para gerar certificados SSL/TLS do Letsencrypt.

Instalando Certbot

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.

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

sudo dnf install certbot python3-certbot-apache

Assim que a instalação for 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 compositor 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 o download do código-fonte do TYPO3 CMS.

Digite 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 CMS TYPO3 ao servidor web httpd que roda 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 compositor.

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

Saída :

Depois que o código-fonte do TYPO3 CMS for baixado, digite 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, em seguida você criará e definirá a configuração do host virtual httpd que será usada para executar o TYPO3 CMS.

Configurar 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 por meio do comando Certbot.

Antes de começar, certifique-se de ter 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 registrar-se no Letsencrypt.

Crie um novo arquivo de configuração do 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.

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

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 configurações httpd adequadas. Quando for bem-sucedido, você deverá receber uma saída como 'sintaxe OK'.

sudo apachectl configtest

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

sudo systemctl restart httpd

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

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

sudo certbot --apache --agree-tos --no-eff-email  --redirect --hsts --staple-ocsp --email [email  -d hwdomain.io

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

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

Inicie a instalação do TYPO3

Antes de iniciar 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.

Digite 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 e insira o nome de domínio da instalação do TYPO3 CMS (ou seja: https://hwdomain.io/).

O instalador TYPO3 CMS irá verificar e verificar o ambiente do seu sistema na primeira página. Certifique-se de obter o botão 'Nenhum problema detectado, continue com a instalação', que confirma que seu sistema está pronto para a instalação do TYPO3 CMS.

Agora insira seus dados do usuário MariaDB que será usado para instalação do TYPO3 CMS.

Selecione a opção 'Usar um banco de dados vazio existente' e selecione o banco de dados 'typo3db' no menu suspenso. Em seguida, clique em Continuar.

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

Clique em Continuar para prosseguir.

Ao terminar, você deverá receber uma saída como 'Instalação concluída'.

Agora selecione a opção 'Leve-me direto para o backend' e clique no botão 'Abrir o backend TYPO3' para continuar.

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

Se for bem-sucedido, você deverá 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 'Informações do aplicativo' no lado esquerdo do perfil do usuário.

Você deve ver detalhes semelhantes na captura de tela a seguir - No momento em que este artigo foi escrito, 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 instalação segura do TYPO3 CMS por meio de certificados SSL/TLS e redirecionamento automático configurado de HTTP para HTTPS via Certbot.

Com isso, você pode iniciar a configuração do TYPO3 CMS criando um registro de site, adicionando usuários de back-end e adicionando idioma de back-end para habilitar vários idiomas. Para saber mais sobre o TYPO3 CMS, visite a documentação oficial do TYPO3.