Configurazione personalizzata (.htaccess)

Da Altervista Wiki.

Alcuni strumenti web avanzati necessitano di configurazioni specifiche del web server Apache o del motore PHP.

Apache gestisce tali configurazioni cartella per cartella grazie ad appositi file .htaccess che affiancano o modificano la configurazione base. Altervista mette a tua disposizione alcuni utili strumenti per aiutarti nel caso tu voglia scrivere o gestire personalmente questi file.

Creare o modificare il file .htaccess è un'operazione delicata e deve essere fatta con attenzione in quanto commettere errori di sintassi o usare direttive non supportate dal server può rendere il sito in parte o totalmente irraggiungibile, sebbene sia comunque sempre possibile rimediare semplicemente cancellando il file .htaccess che contiene gli errori.

Gestire i file .htaccess

arrow-blue3.png

Accesso rapido: usa questo collegamento per accedere direttamente alla sezione Editor .htaccess del pannello di controllo.

Puoi modificare manualmente il contenuto dei file .htaccess presenti nelle varie cartelle:

  1. Accedi alla sezione Gestione File del pannello di controllo (la trovi nel menù AlterSito),
  2. posizionati nella cartella in cui desideri modificare il file .htaccess
  3. clicca sull'icona dell'ingranaggio in alto a sinistra e
  4. seleziona la scheda avanzato per poter modificare manualmente il contenuto del file di configurazione.

Direttive disponibili nei file .htaccess

Con i file .htaccess si possono impostare molti parametri di configurazione del tuo spazio web.

Le direttive attualmente disponibili su Altervista sono:

Direttiva Descrizione Note
ErrorDocument Personalizza le pagine di errore
DirectoryIndex Imposta file da servire per richieste di cartelle Default Altervista: index.php index.html index.htm
RewriteEngine Riscrive gli URL al volo per servire risorse differenti
RewriteBase
RewriteRule
RewriteCond
RewriteOptions
Redirect Imposta redirect HTTP
RedirectMatch
RedirectPermanent
RedirectTemp
AddHandler Imposta la versione dell'interprete PHP Valori ammessi: av-php56 .php av-php7 .php av-php73 .php av-php8 .php

Nella documentazione ufficiale puoi trovare più dettagli riguardo i file .htaccess e su come usare le varie direttive.

Errori comuni

Ecco un esempio d'uso che illustra anche un comune errore di scrittura delle regole:

RewriteEngine On
RewriteRule (.*)\.htm$ $1.php

Questa sintassi è corretta ma imprecisa e quindi anziché produrre una riscrittura dei file .htm in .php genera un errore 404. La versione corretta (per un file .htaccess collocato alla radice del proprio spazio, quindi su /) è la seguente:

RewriteEngine On
RewriteBase /
RewriteRule (.*)\.htm$ $1.php

È quindi consigliabile specificare sempre una direttiva RewriteBase che indichi la cartella in cui il nostro .htaccess è inserito. Per una più completa documentazione su questo potente strumento rimandiamo alla documentazione ufficiale.