Como Instalar o WonderCMS no Debian 12

WonderCMS é um sistema de gerenciamento de conteúdo (CMS) leve e de código aberto, projetado para simplicidade e facilidade de uso. Ao contrário de muitas outras plataformas de CMS que exigem configurações extensas ou recursos pesados, o WonderCMS opera em um único banco de dados de arquivo plano, o que significa que não precisa de um sistema de banco de dados tradicional como o MySQL. Isso torna extremamente fácil de instalar e gerenciar, muitas vezes exigindo nada mais do que o upload dos arquivos do CMS para um servidor. Apesar de seu pequeno tamanho, o WonderCMS oferece recursos essenciais como edição de conteúdo, opções de SEO, personalização de temas e suporte a plugins, tornando-o uma opção viável para usuários que desejam uma solução minimalista e direta para construir e gerenciar sites.

Neste tutorial, mostraremos como instalar o WonderCMS em um servidor Debian 12 com servidor web Apache e PHP 8.x.

Pré-requisitos

Certifique-se de ter o seguinte antes de começar:

• Um servidor Debian 12.
• 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

WonderCMS é um sistema de gerenciamento de conteúdo de código aberto escrito em PHP. É um CMS plano, o que significa que não requer um banco de dados como MySQL/MariaDB para instalar. Ele usa arquivos de texto como banco de dados.

Neste guia, você instalará o WonderCMS com o servidor web Apache e PHP 8.2.

Antes de instalar pacotes, atualize e atualize o repositório Debian usando o comando abaixo.

sudo apt update

Uma vez atualizado, instale as dependências para o WonderCMS executando o comando abaixo. O WonderCMS é um CMS plano, não requer um banco de dados. Portanto, você instalará apenas o servidor web Apache e os pacotes PHP.

sudo apt install apache2 php php-common php-mbstring php-curl php-zip unzip

Digite y para confirmar a instalação.

Após a conclusão da instalação, verifique o serviço Apache com o comando abaixo. O Apache deve estar em execução e habilitado por padrão.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Abaixo você pode ver o serviço Apache habilitado e em execução.

Por fim, verifique a versão do PHP e habilite as extensões com o seguinte comando.

php -m  
php -v

Na saída abaixo, você pode ver que o PHP 8.2 está instalado.

Configurando o PHP

Após instalar as dependências, você precisa configurar o PHP para o WonderCMS. Você precisará modificar a configuração php.ini para o servidor web Apache e alterar algumas das configurações padrão, como fuso horário, limite de memória, tempo de execução e tamanho máximo de upload de arquivos.

Abra a configuração php.ini para o servidor web Apache usando o seguinte comando do editor nano.

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

Altere a configuração padrão do PHP como a seguinte - Certifique-se de ajustar o fuso horário e memory_limit com seu ambiente de servidor atual.

date.timezone = "Europe/Amsterdam"  
memory_limit = 512M  
  
upload_max_filesize = 128MB  
post_max_size = 128MB  
  
max_execution_time = 300  
max_input_vars = 5000

Salve e saia do arquivo quando terminar.

Agora reinicie o serviço Apache para aplicar sua modificação no PHP.

sudo systemctl restart apache2

Configurando o Firewall

Neste guia, você executará o WonderCMS com um firewall habilitado. Neste exemplo, você usará o UFW. Portanto, agora você precisa instalar o UFW e abrir portas para os serviços SSH, HTTP e HTTPS.

Instale o UFW em seu servidor Debian com o seguinte comando. Digite y para confirmar e prosseguir.

sudo apt install ufw

Uma vez que a instalação esteja completa, habilite o perfil OpenSSH para abrir a porta 22 e o perfil “WWW Full” para abrir as portas HTTP e HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow "WWW Full"

Agora execute o seguinte comando para iniciar e habilitar o UFW. Digite y para confirmar, e então o UFW deve estar em execução e habilitado.

sudo ufw enable

Por fim, verifique o status do UFW usando o comando abaixo. Ambos os perfis OpenSSH e “WWW Full” estão habilitados no UFW.

sudo ufw status

Baixando o Código Fonte do WonderCMS

Nesta seção, você fará o download do código fonte do WonderCMS e configurará o diretório document-root com as permissões e propriedade adequadas. Antes de começar, certifique-se de visitar a página do GitHub do WonderCMS e pegar o link de download mais recente.

Vá para o diretório /var/www e baixe o código fonte do WonderCMS usando o comando wget abaixo.

cd /var/www/  
wget https://github.com/WonderCMS/wondercms/releases/download/3.4.3/wondercms-343.zip

Uma vez baixado, extraia o código fonte do WonderCMS para o diretório /var/www/wondercms usando o comando unzip.

unzip wondercms-343.zip -d /var/www/wondercms

Por fim, altere a propriedade do diretório /var/www/wondercms para o usuário www-data. Com isso, você permite que o Apache leia, escreva e execute no diretório raiz do documento do WonderCMS.

sudo chown -R www-data:www-data /var/www/wondercms  
sudo chmod -R 755 /var/www/wondercms

Configurando o Host Virtual do Apache

Neste exemplo, você executará o WonderCMS com o Apache, então você precisa criar a configuração do host virtual para isso. Certifique-se de que seu nome de domínio aponte para o endereço IP do seu servidor Debian.

Primeiramente, use o comando abaixo para habilitar o módulo de reescrita no Apache. O WonderCMS requer que o mod_rewrite esteja habilitado.

sudo a2enmod rewrite

Uma vez habilitado, crie uma nova configuração de host virtual /etc/apache2/sites-available/wondercms.conf usando o comando do editor nano.

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

Insira a seguinte configuração. Certifique-se de alterar o nome do domínio, o caminho do diretório raiz do documento e os arquivos de log com suas informações.

  
ServerName cms.howtoforge.local  
DirectoryIndex index.php  
DocumentRoot /var/www/wondercms  
Redirect /wondercms/loginURL /loginURL  
  
ErrorLog /var/log/apache2/cms.howtoforge.local-error.log  
CustomLog /var/log/apache2/cms.howtoforge.local-access.log combined  
  
  
Options FollowSymLinks  
AllowOverride All  
Require all granted  
  
  

Salve e saia do arquivo quando terminar.

Em seguida, execute o seguinte comando para habilitar o arquivo de host virtual wondercms.conf. Depois, verifique o Apache e certifique-se de que você tenha a sintaxe correta.

sudo a2ensite wondercms.conf  
sudo apachectl configtest

Você deve obter uma saída Syntax OK se tiver a sintaxe correta do Apache.

Por fim, execute o comando abaixo para reiniciar o serviço Apache e aplicar suas alterações. Com isso, sua instalação do WonderCMS deve estar pronta.

sudo systemctl restart apache2

Protegendo o WonderCMS com Letsencrypt

Uma vez que você configure o host virtual do Apache, proteja sua instalação do WonderCMS com HTTPS. Neste caso, você usará o Certbot e o Letsencrypt.

Você pode gerar certificados autoassinados para nomes de domínio locais ou redes internas para proteger sua instalação do WonderCMS.

Instale o Certbot e o plugin Certbot Apache usando o comando abaixo. Digite y para confirmar a instalação.

sudo apt install certbot python3-certbot-apache

Uma vez que a instalação esteja completa, gere certificados SSL para o nome de domínio do seu WonderCMS. Além disso, certifique-se de alterar o nome de domínio e o endereço de e-mail para corresponder às suas informações.

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

Uma vez que o processo esteja concluído, seu certificado deve estar disponível no diretório /etc/letsencrypt/live/howtoforge.local. Sua instalação do WonderCMS deve estar automaticamente protegida com HTTPS.

Acessando a Instalação do WonderCMS

Abra o navegador da web e visite seu nome de domínio do WonderCMS, como https://howtoforge.local/. Na página inicial do WonderCMS, você deve ver a senha gerada. Copie a senha e salve-a em um lugar secreto.

Conclusão

Parabéns! Você instalou com sucesso o WonderCMS no servidor Debian 12, juntamente com um servidor web Apache e PHP 8.2. Você também protegeu o WonderCMS com UFW e certificados SSL do Letsencrypt.