Differenze tra le versioni di "Configurazione personalizzata (.htaccess)"

Da Altervista Wiki.
(→‎Creare un file .htaccess)
 
Riga 2: Riga 2:
  
 
Apache gestisce tali configurazioni cartella per cartella grazie ad appositi file <code>.htaccess</code> che affiancano o modificano la configurazione base.
 
Apache gestisce tali configurazioni cartella per cartella grazie ad appositi file <code>.htaccess</code> 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.
+
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 <code>.htaccess</code> è 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 <code>.htaccess</code> che contiene gli errori.
  
 
== Gestire i file <code>.htaccess</code> ==
 
== Gestire i file <code>.htaccess</code> ==
Riga 15: Riga 17:
 
# seleziona la scheda ''avanzato'' per poter modificare manualmente il contenuto del file di configurazione.
 
# seleziona la scheda ''avanzato'' per poter modificare manualmente il contenuto del file di configurazione.
  
−
== Creare un file <code>.htaccess</code> ==
+
== Direttive disponibili nei file <code>.htaccess</code> ==
−
 
 
−
Creare un file <code>.htaccess</code> è 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 <code>.htaccess</code> che contiene gli errori.
 
  
−
Con i file <code>.htaccess</code> si possono impostare molti parametri di configurazione del tuo spazio web (trovi una lista completa nella [http://httpd.apache.org/docs/2.2/howto/htaccess.html#related documentazione ufficiale]), comprese le impostazioni del motore PHP usando la direttiva <code>php_value</code>.
+
Con i file <code>.htaccess</code> si possono impostare molti parametri di configurazione del tuo spazio web.
  
−
I parametri attualmente modificabili sono:
+
Le direttive attualmente disponibili su Altervista sono:
  
−
{| border="1" cellpadding="4"
+
{|class="wikitable"
−
! Parametro
+
! Direttiva
−
! Valori ammessi (separati da virgola)
+
! Descrizione
 +
! Note
 
|-
 
|-
−
|<code>upload_max_filesize</code>
+
|<code>ErrorDocument</code>
−
|<code>15M</code>, <code>20M</code>
+
|Personalizza le pagine di errore
 +
|
 
|-
 
|-
−
|<code>post_max_size</code>
+
|<code>DirectoryIndex</code>
−
|<code>15M</code>, <code>20M</code>
+
|Imposta file da servire per richieste di cartelle
 +
|Default Altervista: <code>index.php index.html index.htm</code>
 
|-
 
|-
−
|<code>max_input_time</code>
+
|<code>RewriteEngine</code>
−
|<code>300</code>
+
|rowspan=5|Riscrive gli URL al volo per servire risorse differenti
 +
|rowspan=5|
 
|-
 
|-
−
|<code>max_execution_time</code>
+
|<code>RewriteBase</code>
−
|<code>30</code>, <code>60</code>
 
 
|-
 
|-
−
|<code>max_input_vars</code>
+
|<code>RewriteRule</code>
−
|<code>10000</code>
 
 
|-
 
|-
−
|<code>memory_limit</code>
+
|<code>RewriteCond</code>
−
|<code>128M</code>, <code>256M</code>
 
 
|-
 
|-
−
|<code>output_buffering</code>
+
|<code>RewriteOptions</code>
−
|<code>0</code>, <code>1</code>
 
 
|-
 
|-
−
|<code>session.auto_start</code>
+
|<code>Redirect</code>
−
|<code>0</code>, <code>1</code>
+
|rowspan=4|Imposta redirect HTTP
 +
|rowspan=4|
 
|-
 
|-
−
|<code>mbstring.http_input</code>
+
|<code>RedirectMatch</code>
−
|<code>pass</code>
 
 
|-
 
|-
−
|<code>mbstring.http_output</code>
+
|<code>RedirectPermanent</code>
−
|<code>pass</code>
 
 
|-
 
|-
−
|mbstring.encoding_translation
+
|<code>RedirectTemp</code>
−
|<code>0</code>, <code>1</code>
 
 
|-
 
|-
−
|<code>av.mysql_die_on_maxqueries_err</code>
+
|<code>AddHandler</code>
−
|<code>0</code>, <code>1</code>
+
|Imposta la versione dell'interprete PHP
 +
|Valori ammessi: <code>av-php56 .php</code> <code>av-php7 .php</code> <code>av-php73 .php</code> <code>av-php8 .php</code>
 
|}
 
|}
  
−
L'elenco delle direttive '''si aggiorna nel tempo''', consulta sempre il forum di AlterVista per ulteriori informazioni.
+
Nella [https://httpd.apache.org/docs/2.4/howto/htaccess.html documentazione ufficiale] puoi trovare più dettagli riguardo i file <code>.htaccess</code> e su come usare le varie direttive.
−
 
 
−
=== Esempio ===
 
−
 
 
−
<syntaxhighlight lang="apache">
 
−
php_value upload_max_filesize 20M
 
−
</syntaxhighlight>
 
−
 
 
−
{{Avviso|testo=Prima che l'impostazione di una direttiva relativa al motore PHP abbia effetto '''potrebbero passare alcuni minuti'''.}}
 
  
 
== Errori comuni ==
 
== Errori comuni ==
Riga 91: Riga 82:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
È quindi consigliabile specificare sempre una direttiva <code>RewriteBase</code> che indichi la cartella in cui il nostro <code>.htaccess</code> è inserito. Per una più completa documentazione su questo potente strumento rimandiamo alla [http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html documentazione ufficiale].
+
È quindi consigliabile specificare sempre una direttiva <code>RewriteBase</code> che indichi la cartella in cui il nostro <code>.htaccess</code> è inserito. Per una più completa documentazione su questo potente strumento rimandiamo alla [http://httpd.apache.org/docs/2.4/mod/mod_rewrite.html documentazione ufficiale].
  
 
[[Categoria:Hosting]]
 
[[Categoria:Hosting]]
 
[[Categoria:Servizi]]
 
[[Categoria:Servizi]]

Versione attuale delle 09:18, 25 ott 2021

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.

Estratto da "http://it.help.altervista.org/index.php?title=Configurazione_personalizzata_(.htaccess)&oldid=373"