Come installare WonderCMS su Debian 12

WonderCMS è un sistema di gestione dei contenuti (CMS) leggero e open-source progettato per la semplicità e la facilità d’uso. A differenza di molte altre piattaforme CMS che richiedono configurazioni estese o risorse pesanti, WonderCMS opera su un singolo database flat-file, il che significa che non ha bisogno di un sistema di database tradizionale come MySQL. Questo lo rende estremamente facile da installare e gestire, spesso richiedendo solo il caricamento dei file CMS su un server. Nonostante le sue piccole dimensioni, WonderCMS offre funzionalità essenziali come l’editing dei contenuti, opzioni SEO, personalizzazione dei temi e supporto per plugin, rendendolo un’opzione valida per gli utenti che desiderano una soluzione minimalista e diretta per costruire e gestire siti web.

In questo tutorial, ti mostreremo come installare WonderCMS su un server Debian 12 con server web Apache e PHP 8.x.

Prerequisiti

Assicurati di avere i seguenti requisiti prima di iniziare:

• Un server Debian 12.
• Un utente non root con privilegi di amministratore.
• Un nome di dominio puntato a un indirizzo IP del server.

Installazione delle dipendenze

WonderCMS è un sistema di gestione dei contenuti open-source scritto in PHP. È un CMS flat, il che significa che non richiede un database come MySQL/MariaDB per essere installato. Utilizza file di testo come database.

In questa guida, installerai WonderCMS con server web Apache e PHP 8.2.

Prima di installare i pacchetti, aggiorna e aggiorna il repository Debian utilizzando il comando sottostante.

sudo apt update

Una volta aggiornato, installa le dipendenze per WonderCMS eseguendo il comando sottostante. WonderCMS è un CMS flat, non richiede un database. Quindi installerai solo il server web Apache e i pacchetti PHP.

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

Digita y per confermare l’installazione.

Dopo che l’installazione è completata, verifica il servizio Apache con il comando sottostante. Apache dovrebbe essere in esecuzione e abilitato per impostazione predefinita.

sudo systemctl is-enabled apache2  
sudo systemctl status apache2

Di seguito puoi vedere il servizio Apache abilitato e in esecuzione.

Infine, verifica la versione di PHP e abilita le estensioni con il seguente comando.

php -m  
php -v

Nell’output sottostante, puoi vedere che PHP 8.2 è installato.

Configurazione di PHP

Dopo aver installato le dipendenze, è necessario configurare PHP per WonderCMS. Dovrai modificare la configurazione php.ini per il server web Apache e cambiare alcune delle impostazioni predefinite, come il fuso orario, il limite di memoria, il tempo di esecuzione e la dimensione massima del file di upload.

Apri la configurazione php.ini per il server web Apache utilizzando il seguente comando dell’editor nano.

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

Cambia la configurazione predefinita di PHP come segue - Assicurati di regolare il fuso orario e memory_limit in base all’ambiente attuale del tuo server.

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

Salva ed esci dal file quando hai finito.

Ora riavvia il servizio Apache per applicare la tua modifica su PHP.

sudo systemctl restart apache2

Configurazione del firewall

In questa guida, eseguirai WonderCMS con un firewall abilitato. In questo esempio, utilizzerai UFW. Quindi ora devi installare UFW e aprire le porte per i servizi SSH, HTTP e HTTPS.

Installa UFW sul tuo server Debian con il seguente comando. Digita y per confermare e procedere.

sudo apt install ufw

Una volta completata l’installazione, abilita il profilo OpenSSH per aprire la porta 22 e il profilo “WWW Full” per aprire sia le porte HTTP che HTTPS.

sudo ufw allow OpenSSH  
sudo ufw allow "WWW Full"

Ora esegui il seguente comando per avviare e abilitare UFW. Digita y per confermare, e poi UFW dovrebbe essere in esecuzione e abilitato.

sudo ufw enable

Infine, verifica lo stato di UFW utilizzando il comando sottostante. Entrambi i profili OpenSSH e “WWW Full” sono abilitati su UFW.

sudo ufw status

Download del codice sorgente di WonderCMS

In questa sezione, scaricherai il codice sorgente di WonderCMS e configurerai la directory document-root con i permessi e la proprietà corretti. Prima di iniziare, assicurati di visitare la pagina GitHub di WonderCMS e ottenere il link di download più recente.

Vai alla directory /var/www e scarica il codice sorgente di WonderCMS utilizzando il comando wget sottostante.

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

Una volta scaricato, estrai il codice sorgente di WonderCMS nella directory /var/www/wondercms utilizzando il comando unzip.

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

Infine, cambia la proprietà della directory /var/www/wondercms all’utente www-data. Con questo, consenti ad Apache di leggere, scrivere ed eseguire nella directory document root di WonderCMS.

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

Configurazione dell’host virtuale Apache

In questo esempio, eseguirai WonderCMS con Apache, quindi devi creare la configurazione dell’host virtuale per questo. Assicurati che il tuo nome di dominio punti all’indirizzo IP del tuo server Debian.

Per prima cosa, utilizza il comando sottostante per abilitare il modulo rewrite su Apache. WonderCMS richiede che mod_rewrite sia abilitato.

sudo a2enmod rewrite

Una volta abilitato, crea una nuova configurazione dell’host virtuale /etc/apache2/sites-available/wondercms.conf utilizzando il comando dell’editor nano.

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

Inserisci la seguente configurazione. Assicurati di cambiare il nome di dominio, il percorso della directory document root e i file di log con le tue informazioni.

  
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  
  
  

Salva ed esci dal file quando hai finito.

Successivamente, esegui il seguente comando per abilitare il file dell’host virtuale wondercms.conf. Poi, verifica Apache e assicurati di avere una sintassi corretta.

sudo a2ensite wondercms.conf  
sudo apachectl configtest

Dovresti ricevere un output Syntax OK se hai una sintassi Apache corretta.

Infine, esegui il comando sottostante per riavviare il servizio Apache e applicare le tue modifiche. Con questo, la tua installazione di WonderCMS dovrebbe essere pronta.

sudo systemctl restart apache2

Sicurezza di WonderCMS con Letsencrypt

Una volta configurato l’host virtuale Apache, proteggi la tua installazione di WonderCMS con HTTPS. In questo caso, utilizzerai Certbot e Letsencrypt.

Puoi generare certificati autofirmati per nomi di dominio locali o reti interne per proteggere la tua installazione di WonderCMS.

Installa Certbot e il plugin Certbot Apache utilizzando il comando sottostante. Digita y per confermare l’installazione.

sudo apt install certbot python3-certbot-apache

Una volta completata l’installazione, genera certificati SSL per il tuo nome di dominio WonderCMS. Assicurati anche di cambiare il nome di dominio e l’indirizzo email per corrispondere alle tue informazioni.

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

Una volta terminato il processo, il tuo certificato dovrebbe essere disponibile nella directory /etc/letsencrypt/live/howtoforge.local. La tua installazione di WonderCMS dovrebbe essere automaticamente protetta con HTTPS.

Accesso all’installazione di WonderCMS

Apri il browser web e visita il tuo nome di dominio WonderCMS, come https://howtoforge.local/. Nella homepage di WonderCMS, dovresti vedere la password generata. Copia la password e salvala in un luogo segreto.

Conclusione

Congratulazioni! Hai installato con successo WonderCMS sul server Debian 12, insieme a un server web Apache e PHP 8.2. Hai anche protetto WonderCMS con UFW e certificati SSL di Letsencrypt.