Pesquisa de site

Como instalar o WonderCMS no Debian 12


Este tutorial existe para estas versões de sistema operacional

  • Debian 12 (Bookworm)
  • Debian 9 (esticar)

Nesta página

  1. Pré-requisitos
  2. Instalando Dependências
  3. Configurando PHP
  4. Configurando Firewall
  5. Baixando o código-fonte do WonderCMS
  6. Configurando o host virtual Apache
  7. Protegendo WonderCMS com Letsencrypt
  8. Acessando a instalação do WonderCMS
  9. Conclusão

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 CMS que requerem configuração extensa ou recursos pesados, o WonderCMS opera em um único banco de dados de arquivo simples, 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 apenas o upload dos arquivos CMS para um servidor. Apesar de seu pequeno tamanho, 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 simples e minimalista 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 de servidor.

Instalando Dependências

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

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

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

sudo apt update

Depois de atualizado, instale as dependências do WonderCMS executando o comando abaixo. WonderCMS é um CMS simples, não requer banco de dados. Portanto, você instalará apenas o servidor web Apache e 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 último, 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 PHP

Após instalar as dependências, você precisa configurar o PHP para o WonderCMS. Você precisará modificar a configuração do 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 do arquivo de upload.

Abra a configuração do 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 seguir - Certifique-se de ajustar o fuso horário e o limite de memória com o ambiente do seu 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 Firewall

Neste guia, você executará o WonderCMS com um firewall habilitado. Neste exemplo, você usará o UFW. Então agora você precisa instalar o UFW e abrir portas para 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

Assim que a instalação for concluída, 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 o UFW deverá estar em execução e ativado.

sudo ufw enable

Por último, verifique o status do UFW usando o comando abaixo. 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ê baixará o código-fonte do WonderCMS e configurará o diretório raiz do documento com permissão e propriedade adequadas. Antes de começar, certifique-se de visitar a página WonderCMS GitHub e obter 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

Depois de 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 último, altere a propriedade do diretório /var/www/wondercms para o usuário www-data. Com isso, você permite que o Apache leia, grave e execute no diretório raiz do documento WonderCMS.

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

Configurando o host virtual Apache

Neste exemplo, você executará o WonderCMS com Apache, portanto, será necessário 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. WonderCMS exigia que mod_rewrite fosse habilitado.

sudo a2enmod rewrite

Uma vez ativado, 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 de domínio, o caminho do diretório raiz do documento e os arquivos de log com suas informações.

<VirtualHost *:80>
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
<Directory /var/www/wondercms>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
</VirtualHost>

Salve e saia do arquivo quando terminar.

Em seguida, execute o seguinte comando para habilitar o arquivo host virtual Wondercms.conf. Em seguida, verifique o Apache e certifique-se de ter a sintaxe adequada.

sudo a2ensite wondercms.conf
sudo apachectl configtest

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

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

sudo systemctl restart apache2

Protegendo WonderCMS com Letsencrypt

Depois de configurar o host virtual Apache, proteja a instalação do WonderCMS com HTTPS. Neste caso, você usará Certbot e 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

Assim que a instalação for concluída, gere certificados SSL para o seu nome de domínio 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  -d cms.howtoforge.local

Assim que o processo for concluído, seu certificado deverá estar disponível no diretório /etc/letsencrypt/live/howtoforge.local. A instalação do WonderCMS deve ser automaticamente protegida com HTTPS.

Acessando a instalação do WonderCMS

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

Conclusão

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

Artigos relacionados: