Como instalar o CMS TYPO3 no Debian 11

TYPO3 é um sistema de gerenciamento de conteúdo de nível empresarial gratuito e de código aberto. Ele fornece muitos recursos para uso em 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 uma arquitetura adaptável e desacoplada.

Neste guia, vou mostrar como instalar o TYPO3 CMS com o LAMP Stack no Debian 11 Bullseye mais recente. Além disso, abordaremos a instalação básica típica do TYPO3 CMS.

Pré-requisitos

Um servidor Linux Debian 11.
Um usuário root ou não root com privilégios root.
Um nome de domínio apontado para o endereço IP do servidor.

Instalando a pilha LAMP

O CMS TYPO3 é escrito em PHP, então você precisará instalar o LAMP ou LEMP Stack para a instalação. este guia mostrará como configurar LAMP Stack para o TYPO3 CMS.

Antes de instalar alguns pacotes, execute o comando apt abaixo para atualizar seu repositório e atualizar o índice de pacotes em seu sistema Debian.

sudo apt update

Em seguida, instale os pacotes básicos do LAMP Stack usando o seguinte comando.

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

Digite Y para confirmar a instalação e pressione ENTER para continuar.

Após a conclusão da instalação de todos os pacotes, edite a configuração /etc/php/7.4/apache2/php.ini usando o editor nano.

sudo nano /etc/php/7.4/apache2/php.ini

Altere a configuração padrão do PHP usando a configuração a seguir.

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

Salve o arquivo quando terminar.

Por último, reinicie o serviço Apache2 para aplicar novas alterações na configuração do PHP e verifique o serviço Apache2.

sudo systemctl restart apache2
sudo systemctl status apache2

Abaixo você verá que o serviço Apache2 está ativo (em execução).

Configurando a implantação do MariaDB

Você instalou os pacotes do servidor MariaDB em seu servidor, mas ainda está com as configurações padrão. E agora mostraremos como implantar a segurança do servidor MariaDB usando a ferramenta de linha de comando mysql_secure_installation.

O comando mysql_secure_installation está incluído no pacote MariaDB. isso o ajudará a configurar a segurança básica para o servidor MariaDB, por exemplo, configurando a senha root, removendo o acesso anônimo padrão, removendo o banco de dados de teste e desabilitando o login remoto para o usuário root MariaDB.

Execute o comando mysql_secure_installation abaixo para começar a configurar a implantação do MariaDB.

sudo mysql_secure_installation

Pressione ENTER quando for solicitada a senha root atual.

Enter current password for root (enter for none):
OK, successfully used password, moving on...

Agora digite Y para confirmar e mudar a autenticação local para unix_socket.

Switch to unix_socket authentication [Y/n] Y
Enabled successfully!
Reloading privilege tables..
 ... Success!

Agora digite Y para confirmar e configurar uma nova senha root para o servidor MariaDB. Em seguida, insira a nova senha e repita-a. Certifique-se de ter uma senha forte para o usuário root do MariaDB.

Change the root password? [Y/n] Y
New password:
Re-enter new password:
Password updated successfully!
Reloading privilege tables..
 ... Success!

Agora digite Y para remover o acesso anônimo padrão ao servidor de banco de dados MariaDB.

Remove anonymous users? [Y/n] Y
 ... Success!

Digite Y para desabilitar o login remoto para o usuário root do MariaDB. Para conexões remotas ao servidor MariaDB, você precisará criar outro usuário.

Disallow root login remotely? [Y/n] Y
 ... Success!

Agora digite Y novamente para remover o teste de banco de dados padrão do seu servidor MariaDB.

Remove test database and access to it? [Y/n] Y
 - Dropping test database...
 ... Success!
 - Removing privileges on test database...
 ... Success!

Por último, digite Y novamente para confirmar e recarregar todos os privilégios de tabelas em seu servidor MariaDB e aplicar novas alterações.

Reload privilege tables now? [Y/n] Y
 ... Success!

Agora você concluiu a configuração básica do servidor de banco de dados MariaDB.

Para garantir que todas as alterações sejam aplicadas ao servidor MariaDB, execute o comando abaixo para reiniciar o serviço MariaDB e verificar o status do serviço.

sudo systemctl restart mariadb
sudo systemctl status mariadb

Agora você verá que o servidor MariaDB está ativo (em execução).

Criando novo banco de dados e usuário para TYPO3 CMS

Neste ponto, você concluiu a instalação básica do LAMP Stack para a instalação do TYPO3 CMS. Agora você criará um novo banco de dados MariaDB e usuário para o TYPO3 CMS.

Faça login no shell MariaDB usando o comando mysql abaixo. Você será solicitado a inserir a senha root do MariaDB.

mysql -u root -p

Agora execute as seguintes consultas MariaDB para criar um novo banco de dados typo3db com o usuário typo3 e a senha é typo3password.

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

Agora digite EXIT para sair do shell MariaDB e continuar com a instalação do TYPO3 CMS.

Instalando o Compositor

O TYPO3 CMS pode ser instalado de diferentes maneiras. Neste guia, você instalará o TYPO3 CMS usando o Composer. Então agora você instalará o COmposer em seu servidor Debian 11.

Primeiro, execute o comando abaixo para baixar o instalador do PHP Composer e verificar o arquivo do instalador.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === '906a84df04cea2aa72f40b5f787e49f22d4c2f19492ac310e8cba5b96ac8b64115ac402c8cd292b8a03482574915d1a8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Certifique-se de receber a mensagem de saída "Instalador verificado", o que significa que o arquivo do instalador é o correto.

Em seguida, execute o script de instalação do Composer para fazer download do Composer. Se o download for concluído, remova o script do instalador.

php composer-setup.php
php -r "unlink('composer-setup.php');"

Agora mova o arquivo composer.phar para o diretório /usr/local/bin para permitir que usuários no sistema Debian executem o Composer.

sudo mv composer.phar /usr/local/bin/composer

Por último, verifique a instalação do Composer usando o seguinte comando.

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

Você verá o PHP Composer v2.3.3 instalado em seu sistema Debian 11 e estará pronto para instalar o CMS TYPO3.

Baixando TYPO3 CMS com Composer

Para iniciar a instalação do TYPO3 CMS, crie um novo diretório /var/www/typo3 usando o seguinte comando.

mkdir -p /var/www/typo3

Altere a propriedade do diretório /var/www/typo3 para o usuário www-data e permita que o usuário www-data escreva nesse diretório.

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

Em seguida, vá para o diretório /var/www/typo3 e execute o comando Composer abaixo para instalar o TYPO3 CMS em seu servidor.

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

O Composer fará o download das dependências TYPO3 CMS e PHP.

Assim que a instalação for concluída, execute o comando ls para verificar todos os arquivos e diretórios disponíveis em /var/www/typo3.

ls

Você verá o diretório chamado public, que é a fonte real padrão para o CMS TYPO3 e será usado como DocuemtRoot para a configuração do host virtual.

Configurando o host virtual Apache

Depois de fazer download do TYPO3 CMS usando o Composer, você criará uma nova configuração de host virtual para a instalação do TYPO3 CMS.

Vá para o diretório /etc/apache2/sites-available e crie uma nova configuração de host virtual typo3.conf usando o editor nano.

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

Adicione a seguinte configuração ao novo host virtual typo3.conf. Certifique-se de alterar o nome de domínio e o caminho dos certificados SSL.

<VirtualHost *:80>
    ServerName example.io
    Redirect permanent / https://example.io/
</VirtualHost>
<VirtualHost *:443>
    ServerAdmin [email 
    DocumentRoot /var/www/typo3/public
    ServerName example.io
    Protocols h2 http/1.1
    SSLEngine On
    SSLCertificateFile /etc/letsencrypt/live/example.io/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.io/privkey.pem
     <Directory /var/www/typo3/public/>
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     </Directory>
     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined
    
     <Directory /var/www/typo3/public/>
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^(.*) index.php [PT,L]
    </Directory>
</VirtualHost>

Salve o arquivo quando terminar.

A seguir, ative alguns módulos do Apache2 usando o comando abaixo.

sudo a2enmod ssl rewrite headers

Depois disso, ative a configuração do host virtual typo3.conf e verifique todas as configurações do Apache2.

sudo a2ensite typo3.conf
sudo apachectl configtest

Certifique-se de receber a mensagem Sintaxe OK, o que significa que a configuração do Apache está correta.

Por último, execute o seguinte comando para reiniciar e verificar o serviço Apache2. E certifique-se de que o status do serviço Apache2 seja ativo (em execução).

sudo systemctl restart apache2
sudo systemctl status apache2

Agora você concluiu a configuração do host virtual Apache2 para a instalação do TYPO3 CMS.

Instalando CMS TYPO3

Antes de iniciar a instalação do TYPO3 CMS, você precisará criar um novo arquivo em branco FIRST_INSTALL dentro do diretório public. Isso indicará que você está instalando o TYPO3 CMS pela primeira vez neste servidor.

Crie um novo arquivo FIRST_INSTALL no diretório public usando o seguinte comando.

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

Em seguida, abra seu navegador e digite o nome de domínio da instalação do TYPO3 CMS.

https://example.io/

Agora você verá a primeira página de instalação do TYPO3 CMS. Certifique-se de que seu ambiente de instalação não tenha problemas. Em seguida, clique no botão verde para continuar.

Para a configuração do banco de dados, insira o nome de usuário e a senha do banco de dados e clique em Continuar.

Agora selecione a opção Usar um banco de dados vazio existente e selecione o banco de dados typo3db, depois clique em Continuar.

Agora você precisará criar um usuário administrador e uma senha para o CMS YUPO3 e clicar em Continuar para concluir a instalação.

A instalação do TYPO3 CMS está concluída, clique no botão Abrir o backend do TYPO3.

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

Assim que o nome de usuário e a senha estiverem corretos, você verá o painel de administração do TYPO3 CMS.

Dentro do ícone do usuário Admin, você verá o menu retangular. Clique nele e você verá o ambiente detalhado da instalação do seu TYPO3 CMS.

Conclusão

Parabéns! Agora você instalou com sucesso o TYPO3 CMS com o LAMP Stack no Debian 11 Bullseye mais recente. Agora você pode criar um índice personalizado para seu CMS TYPO3 e explorar algumas extensões para estender o uso do CMS TYPO3 em seu ambiente.