Como Instalar TYPO3 CMS no Ubuntu 24.04

TYPO3 é um sistema de gerenciamento de conteúdo de nível empresarial, gratuito e de código aberto. Ele fornece recursos de nível empresarial, como um CMS escalável com suporte a 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 que você construa sites flexíveis e confiáveis. O TYPO3 CMS é apoiado por uma comunidade profissional vibrante. 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 no servidor Ubuntu 24.04. Você instalará o TYPO3 com a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), Composer e GraphicsMagick.

Pré-requisitos

Para começar com este guia, certifique-se de ter o seguinte:

• Um servidor Ubuntu 24.04.
• Um usuário não-root com privilégios de administrador.
• Um nome de domínio apontado para um endereço IP do servidor.

Instalando dependências

TYPO3 é um sistema de gerenciamento de conteúdo de código aberto escrito em PHP e suporta bancos de dados como MySQL/MariaDB e PostgreSQL. Nesta seção, você instalará as dependências para o TYPO3, que incluem a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), Composer como gerenciamento de dependências PHP e GraphicsMagick para processamento de imagens.

Antes de começar, atualize o índice de pacotes do Ubuntu com o comando abaixo.

sudo apt update

Agora instale as dependências de pacote para o TYPO3 CMS com o seguinte comando ‘apt install’. Com este comando, você instalará dependências como a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), Composer como gerenciador de pacotes PHP, Git e GraphicsMagick para processamento automático de imagens.

sudo apt install apache2 mariadb-server composer graphicsmagick php php-common php-mysql libapache2-mod-php php-gd php-curl php-json php-xmlrpc php-intl php-gmagick php-bcmath php-zip php-apcu php-mbstring php-fileinfo php-xml php-soap

Digite Y para prosseguir com a instalação.

Quando a instalação estiver completa, verifique o status dos serviços Apache e MariaDB, e depois verifique as versões do PHP, Composer e GraphicsMagick.

Verifique o status do serviço Apache com o comando abaixo. Você deve obter a saída do serviço Apache como ‘habilitado‘ e ‘ativo (em execução)’.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Em seguida, verifique o status do serviço MariaDB usando o seguinte comando. A saída deve ser semelhante à do Apache, você verá que o servidor MariaDB está ‘habilitado‘ e ‘ativo (em execução)‘.

sudo systemctl is-enabled mariadb  
sudo systemctl status mariadb

Agora execute o comando abaixo para verificar as versões do PHP e do Composer. No Ubuntu 24.04, a versão padrão do PHP é 8.3, e o Composer é 2.7.1.

php -v  
sudo -u www-data composer --version

Por último, verifique a versão do GraphicsMagick usando o comando abaixo. Você deve ver o GraphicsMagick 1.3 instalado em seu sistema Ubuntu.

gm version

Configurando PHP

Para instalar o TYPO3, você deve alterar o arquivo de configuração PHP padrão ‘php.ini’. Você precisa editar o arquivo ‘php.ini’ tanto para o Apache quanto para o PHP CLI, e então mudar algumas configurações padrão para a instalação do TYPO3.

Edite o arquivo ‘php.ini’ para Apache e PHP CLI com o seguinte comando do editor nano.

sudo nano /etc/php/8.3/apache2/php.ini  
sudo nano /etc/php/8.3/cli/php.ini

Altere a configuração padrão com o seguinte. Certifique-se de ajustar as opções ‘memory_limit‘ e ‘date.timezone‘ de acordo com o ambiente do seu servidor.

date.timezone = Europe/Amsterdam  
memory_limit = 512M  
max_execution_time = 240  
max_input_vars = 1500  
post_max_size = 50M  
upload_max_filesize = 50M

Salve o arquivo e saia.

Agora execute o comando abaixo para reiniciar o serviço Apache e aplicar suas alterações no PHP.

sudo systemctl restart apache2

Depois disso, execute o seguinte comando para criar um novo arquivo ‘info.php’ no diretório ‘/var/www/html‘.

echo "" > /var/www/html/info.php

Por último, visite http://192.168.5.30/info.php usando seu navegador web preferido. Você verá detalhes das suas configurações PHP, certifique-se de que tudo o que você configurou via ‘php.ini‘ foi aplicado.

Vá verificar a seção ‘Core’ para ver o ‘memory_limit‘, ‘post_max_size‘, ‘max_execution_time‘ e outros da sua instalação PHP.

Configurando o servidor MariaDB

Agora que você configurou o PHP, precisa proteger o servidor MariaDB e, em seguida, criar um novo banco de dados e usuário para o TYPO3. Nesta seção, você protegerá o MariaDB usando a utilidade ‘mariadb-secure-installation‘ e criará um novo banco de dados e usuário a partir da linha de comando.

Proteja sua instalação do servidor MariaDB executando o comando ‘mariadb-secure-installation‘ abaixo.

sudo mariadb-secure-installation

Agora, você será solicitado a configurar o servidor MariaDB. Digite Y para aceitar a configuração padrão ou n para rejeitá-la.

• A instalação padrão do MariaDB vem sem senha, pressione ENTER quando solicitado pela senha.
• Agora insira Y para configurar a senha do root do MariaDB. Em seguida, digite a nova senha para o MariaDB e repita a senha.
• Insira Y para remover o usuário anônimo da sua instalação do MariaDB.
• Insira Y novamente quando solicitado para desabilitar o login remoto para o usuário root do MariaDB.
• Insira Y para remover o banco de dados padrão de teste do seu MariaDB.
• Por último, insira Y para recarregar os privilégios da tabela e aplicar novas alterações.

Depois de configurar o servidor MariaDB, faça login no MariaDB com o seguinte comando. Insira sua senha de root do MariaDB quando solicitado.

sudo mariadb -u root -p

Agora execute as seguintes consultas para criar um novo banco de dados, ‘typo3db’, e um novo usuário, ‘typo3’, com a senha ‘Typo3Password’. Altere as informações do banco de dados conforme necessário.

CREATE DATABASE typo3db;  
GRANT ALL PRIVILEGES ON typo3db.* to typo3@localhost IDENTIFIED BY 'Typo3Password';  
FLUSH PRIVILEGES;

Em seguida, execute a consulta abaixo para verificar os privilégios do usuário ‘typo3‘. Isso garantirá que o usuário ‘typo3‘ possa acessar o banco de dados ‘typo3db‘ para sua instalação do TYPO3 CMS.

SHOW GRANTS FOR typo3@localhost;

A saída abaixo mostra que o usuário ‘typo3‘ pode acessar o banco de dados ‘typo3db‘.

Por último, digite quit para sair do servidor MariaDB.

Baixando TYPO3 via Composer

Existem várias maneiras de instalar e baixar o código-fonte do TYPO3. Agora você configurará o diretório de instalação do TYPO3 e, em seguida, baixará o TYPO3 usando o Composer (gerenciamento de dependências PHP).

Primeiro, execute o seguinte comando para criar novos diretórios para cache e configuração do Composer, e o diretório de instalação do TYPO3 ‘/var/www/typo3‘.

sudo mkdir -p /var/www/{.cache,.config,typo3}

Agora execute o comando abaixo para mudar a propriedade dos diretórios acima para o usuário ‘www-data‘, e então habilitar o acesso de leitura e gravação ao diretório ‘/var/www/typo3‘.

sudo chown -R www-data:www-data /var/www/{.cache,.config,typo3}  
sudo chmod u+rw /var/www/typo3

Em seguida, vá para o diretório ‘/var/www/typo3‘ e instale o TYPO3 CMS com o comando ‘composer‘ abaixo. Neste exemplo, você instalará a versão mais recente do TYPO3 CMS v12 em seu servidor Ubuntu.

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

Você pode ver abaixo o processo de download e instalação do TYPO3 CMS:

Configurando TYPO3 via linha de comando

Após baixar o código-fonte do TYPO3 CMS, você configurará a instalação do TYPO3 usando a linha de comando. Você também pode configurar a instalação do TYPO3 usando um navegador web, mas agora você configurará a instalação do TYPO3 CMS a partir do seu terminal.

Para configurar a instalação do TYPO3 CMS via comando, execute o seguinte:

./vendor/bin/typo3 setup

Você será solicitado com as seguintes configurações:

• Digite apache como o servidor web.
• Digite mysqli como o driver do banco de dados.
• Insira os detalhes do seu usuário MariaDB, senha, porta e host que serão usados para o TYPO3 CMS.
• Digite typo3db como o nome do banco de dados.
• Digite seu usuário administrador, senha e endereço de e-mail para o TYPO3 CMS. Sua senha deve conter pelo menos um caractere especial.
• Para o nome do projeto, deixe como padrão.
• Pressione ENTER quando solicitado para criar o site básico.

Se sua instalação for bem-sucedida, você verá uma saída ‘Parabéns - a configuração do TYPO3 está concluída‘.

Por último, execute novamente o seguinte comando para mudar a propriedade do diretório ‘/var/www/typo3‘ para o usuário ‘www-data‘.

sudo chown -R www-data:www-data /var/www/typo3

Configurando o host virtual do Apache

Agora que você configurou o TYPO3 a partir do terminal, vamos passar para a configuração do host virtual do Apache para sua instalação do TYPO3. Portanto, certifique-se de que você preparou seu nome de domínio.

Primeiro, ative o módulo ‘rewrite‘ do Apache com o seguinte comando.

sudo a2enmod rewrite

Em seguida, crie um novo arquivo de host virtual ‘/etc/apache2/sites-available/typo3.conf‘ usando o seguinte comando do editor nano.

sudo nano /etc/apache2/sites-available/typo3.conf

Insira a seguinte configuração e certifique-se de alterar a opção ServerName com o seu nome de domínio do TYPO3 CMS. Neste exemplo, o TYPO3 CMS será executado no domínio ‘howtoforge.local‘.

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

Agora execute o comando abaixo para ativar o arquivo de host virtual ‘typo3.conf’ e verificar sua sintaxe do Apache. A saída ‘Sintaxe OK‘ será exibida, se você tiver uma sintaxe do Apache adequada.

sudo a2ensite typo3.conf  
sudo apachectl configtest

Por último, reinicie o serviço Apache com o comando abaixo para aplicar seu host virtual do TYPO3 CMS. Quando executado, sua instalação do TYPO3 CMS estará pronta.

sudo systemctl restart apache2

Protegendo o TYPO3 CMS com HTTPS

Nesta seção, você protegerá o TYPO3 CMS com HTTPS usando Certbot e Letsencrypt. O Certbot será usado para gerar certificados SSL/TLS do Letsencrypt. Além disso, você usará o plugin Certbot Apache para configurar HTTPS automático em seus hosts virtuais.

Instale o Certbot e o plugin Certbot Apache com o comando abaixo. Digite Y para prosseguir com a instalação.

sudo apt install certbot python3-certbot-apache

Após a instalação, execute o comando ‘certbot’ abaixo para gerar certificados SSL/TLS para o seu nome de domínio do TYPO3 CMS. Portanto, certifique-se de alterar o nome de domínio e o endereço de e-mail com suas informações.

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

Quando o processo terminar, seu TYPO3 CMS estará protegido com HTTPS automaticamente. Seus certificados SSL/TLS estão disponíveis no diretório ‘/etc/letsencrypt/live/domain.com‘.

Acessando o TYPO3

Visite a página de login do TYPO3 CMS em https://howtoforge.local/typo3 usando seu navegador web preferido. Se sua instalação for bem-sucedida, você deve obter a página de login do TYPO3 CMS.

Insira seu usuário administrador e senha, e clique em Login para confirmar.

Após fazer login, você verá o painel de administração do TYPO3 CMS como o seguinte:

No menu superior direito, clique no ícone de informação para obter detalhes sobre sua pilha do TYPO3 CMS. Como você pode ver abaixo, o TYPO3 CMS 12.4 está instalado com Apache 2.4.58, servidor MariaDB 10.11, PHP 8.3, e o modo Composer está habilitado.

Conclusão

Parabéns! Você instalou o TYPO3 CMS no servidor Ubuntu 24.04. Você tem o TYPO3 CMS em execução com a pilha LAMP (Linux, Apache, MySQL/MariaDB e PHP), processamento de imagens GraphicsMagick e o modo Composer habilitado. Você também protegeu o TYPO3 CMS com HTTPS usando Certbot e Letsencrypt.