Como Instalar o WonderCMS no AlmaLinux 9

WonderCMS é um sistema de gerenciamento de conteúdo (CMS) leve e de código aberto, projetado para ser simples e eficiente. Ao contrário de plataformas mais complexas, ele se concentra na facilidade de uso, tornando-se uma escolha ideal para usuários que desejam criar e gerenciar sites sem amplo conhecimento técnico. O WonderCMS opera sem um banco de dados, dependendo em vez disso do armazenamento em arquivos planos, o que simplifica a instalação e a manutenção. Todo o sistema pode ser configurado com um único arquivo, e seu design minimalista garante um desempenho rápido. Ele oferece recursos básicos como temas personalizáveis, plugins e configurações amigáveis ao SEO, permitindo que os usuários construam sites funcionais com o mínimo de complicação.

Neste tutorial, mostraremos como instalar o WonderCMS em um servidor AlmaLinux 9. Você executará o WonderCMS com o servidor web Httpd e PHP 8.x.

Pré-requisitos

Antes de começar, certifique-se de ter os seguintes requisitos:

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

Instalando Apache e PHP

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/httpd e PHP 8.x no servidor AlmaLinux 9.

Primeiro, execute o comando abaixo para instalar o servidor web httpd e os pacotes PHP no seu servidor AlmaLinux. Neste momento, você pode instalar o WonderCMS com PHP 8.x no seu sistema.

sudo dnf install httpd php php-common php-curl php-opcache php-xml php-gd php-mbstring php-zip php-json wget unzip git

Digite y para confirmar a instalação.

Uma vez que a instalação esteja completa, abra a configuração padrão do PHP /etc/php.ini usando o seguinte comando do editor nano.

sudo nano /etc/php.ini

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

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

Quando terminar, salve o arquivo e saia do editor.

Agora execute o seguinte comando para iniciar e habilitar o serviço httpd. Em seguida, verifique para garantir que o serviço esteja em execução.

sudo systemctl enable --now httpd  
sudo systemctl status httpd

Se o serviço httpd estiver em execução, você deve obter uma saída como a seguinte:

Configurando o Firewalld

Depois de instalar o Apache e o PHP, você precisa abrir portas para HTTP e HTTPS via firewalld. Isso permitirá o acesso à sua instalação do WonderCMS, tanto nos protocolos HTTP quanto HTTPS.

Abra os serviços HTTP e HTTPS no firewalld usando o comando abaixo. Você verá uma saída de sucesso.

sudo firewall-cmd --add-service={http,https} --permanent

Agora execute o comando abaixo para recarregar as regras do firewalld e aplicar as novas alterações.

sudo firewall-cmd --reload

Por último, verifique as regras do firewalld usando o comando abaixo. Certifique-se de que os serviços HTTP e HTTPS foram adicionados ao firewalld.

sudo firewall-cmd --list-all

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. Portanto, certifique-se de visitar a página do GitHub do WonderCMS e pegar o link de download mais recente.

Mova-se para o diretório /var/www e baixe a versão mais recente do WonderCMS usando o comando wget abaixo. Certifique-se de visitar a página do GitHub do WonderCMS para pegar a versão mais recente.

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

Uma vez baixado, execute o comando unzip abaixo para extrair o código-fonte do WonderCMS para /var/www/wondercms. Este diretório será o DocumentRoot para o WonderCMS.

unzip wondercms-343.zip -d .

Agora execute o seguinte comando para mudar a propriedade do diretório /var/www/wondercms para o usuário ‘apache‘ e a permissão padrão para 755.

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

Configurando o host virtual httpd

Depois de baixar e configurar o Document-Root para o WonderCMS, você criará uma nova configuração de host virtual do Apache/httpd que será usada para executar a instalação do WonderCMS. Certifique-se de que você tenha um nome de domínio apontado para seu endereço IP. Além disso, você deve garantir que o módulo mod_rewrite no httpd esteja habilitado.

Crie uma nova configuração de host virtual httpd /etc/httpd/conf.d/wondercms.conf usando o seguinte comando do editor nano.

sudo nano /etc/httpd/conf.d/wondercms.conf

Insira a configuração abaixo no arquivo e certifique-se de alterar a opção ServerName para o seu nome de domínio alvo.

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

Salve o arquivo e saia do editor.

Agora execute o comando abaixo para verificar sua sintaxe httpd para garantir que não haja erro. Você verá uma saída Syntax OK se você tiver uma sintaxe httpd adequada.

sudo apachectl configtest

Por último, reinicie o servidor web httpd para aplicar o novo arquivo de host virtual para o WonderCMS. Após a execução do comando, sua instalação do WonderCMS deve estar acessível.

sudo systemctl restart httpd

Protegendo o WonderCMS com HTTPS via Certbot

Agora que você criou o host virtual do Apache/httpd, o próximo passo é proteger o WonderCMS com HTTPS via Certbot e Letsencrypt. Você deve garantir que o repositório EPEL esteja adicionado ao seu sistema, o pacote Certbot esteja disponível no repositório EPEL.

Instale o repositório EPEL no seu servidor AlmaLinux com o comando abaixo.

sudo dnf install epel-release

Uma vez que o repositório EPEL esteja adicionado, instale o certbot e o plugin python3-certbot-apache usando o comando dnf abaixo. Digite y para confirmar a instalação.

sudo dnf install certbot python3-certbot-apache

Após a instalação ser concluída, execute o comando certbot abaixo para gerar certificados SSL/TLS para sua instalação do WonderCMS. 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 --no-eff-email --redirect --hsts --staple-oscp --email [email protected] -d cms.howtoforge.local

Acessando o WonderCMS

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

Cole sua senha gerada e clique em LOGIN.

Se for bem-sucedido, você deve obter a página de administração do WonderCMS como a seguinte:

Conclusão

Parabéns! Você completou a instalação do WonderCMS no servidor AlmaLinux 9. Sua instalação do WonderCMS está rodando com o servidor web Httpd e PHP 8.x. Também está protegida com firewalld e HTTPS via certbot. A partir daqui, você pode fazer upload de arquivos de texto e instalar novos temas ou plugins.