Gestione del file .htaccess nel passaggio da Apache ad Nginx

Il webserver Nginx non interpreta il
file .htaccess.
Questo file è specifico per Apache e viene utilizzato per
configurare dinamicamente alcune impostazioni a livello di directory.
Nginx, invece, segue un approccio diverso alla configurazione.

Differenze tra Apache e Nginx

1. Apache:

   • Supporta il file .htaccess
     per permettere configurazioni specifiche a livello di directory.

   • Questo approccio consente agli
     utenti di modificare le impostazioni senza dover accedere ai file
     di configurazione principali (es. httpd.conf).

2. Nginx:

   • Non supporta .htaccess
     per motivi di prestazioni.

   • Le configurazioni vengono definite globalmente nel file
     principale (nginx.conf) o nei file di
     configurazione dei singoli siti (di solito in
     /etc/nginx/sites-available/).

   ---

   La scelta di non supportare .htaccess
   è intenzionale per garantire prestazioni migliori, evitando che il
   server debba leggere e interpretare file di configurazione in ogni
   directory durante una richiesta.

---

Come Tradurre .htaccess
in Configurazioni per Nginx

Le funzionalità che si trovano comunemente in un file .htaccess
possono essere replicate nella configurazione di Nginx. Ecco alcuni
esempi:

1. Redirect 301 (Permanent Redirect)

In .htaccess:

Redirect 301 /old-page.html /new-page.html

In Nginx (nginx.conf o il file del
sito):

server {
    location = /old-page.html {
        return 301 /new-page.html;
    }
}

2. Riscrittura URL (mod_rewrite)

In .htaccess:

RewriteEngine On
RewriteRule ^product/([0-9]+)$ /product.php?id=$1 [L]

In Nginx:

server {
    location / {
        rewrite ^/product/([0-9]+)$ /product.php?id=$1 last;
    }
}

3. Protezione Directory con Password

In .htaccess:

AuthType Basic
AuthName "Restricted Area"
AuthUserFile /path/to/.htpasswd
Require valid-user

In Nginx:

server {
    location / {
        auth_basic "Restricted Area";
        auth_basic_user_file /path/to/.htpasswd;
    }
}

---

Risorse Utili per Configurare Nginx

• Documentazione ufficiale di
  Nginx:
  https://nginx.org/en/docs/
  Include una
  sezione dettagliata su redirect, rewrite
  e altre funzionalità configurabili.

• Guida alla conversione da .htaccess
  a
  Nginx:
  https://www.nginx.com/resources/wiki/start/topics/examples/likeapache-htaccess/

• Tool di conversione online (non sempre
  perfetto, ma utile come punto di
  partenza):
  https://winginx.com/htaccess

---

Nginx non ha un file di configurazione equivalente a
.htaccess. A
differenza di Apache, Nginx non supporta configurazioni a livello di
directory che sovrascrivano quelle globali. L’intera configurazione
di Nginx deve essere definita nei file principali, come:

• nginx.conf
  (file di configurazione principale).

• File specifici dei virtual host (tipicamente
  in /etc/nginx/sites-available/ e
  /etc/nginx/sites-enabled/ o percorsi
  equivalenti).

Perché Nginx Non Supporta un Equivalente
di .htaccess?

La mancanza di un file simile a .htaccess
in Nginx è una scelta progettuale per garantire prestazioni elevate.
Nginx carica la configurazione una volta sola all’avvio (o al reload)
e non legge dinamicamente i file di configurazione per ogni
richiesta, come invece fa Apache con .htaccess.
Questo elimina il sovraccarico di lettura e interpretazione dei file
durante l’elaborazione delle richieste.

---

Alternative in Nginx per
Personalizzazioni a Livello di Directory

Anche se non esiste un file come .htaccess,
è possibile ottenere un comportamento simile configurando sezioni
specifiche nel file di configurazione del server. Alcune alternative
includono:

1. Configurazione per una Directory
Specifica

Puoi definire regole specifiche per una directory nel file del
virtual host o in un blocco location. Ad
esempio:

server {
    root /var/www/miosito;

    # Configurazione per tutte le richieste
    location / {
        index index.html index.php;
    }

    # Regole specifiche per la directory /uploads
    location /uploads/ {
        autoindex on;
        deny all;
    }
}

2. Inclusione di File Locali

Puoi usare la direttiva include per
caricare file di configurazione aggiuntivi che risiedono nella
webroot del sito. Questo approccio consente di simulare il
comportamento di .htaccess (con alcune
limitazioni). Ad esempio:

Struttura dei file:

/var/www/miosito/nginx-custom-rules.conf

Configurazione del virtual host:

server {
    root /var/www/miosito;

    location / {
        include /var/www/miosito/nginx-custom-rules.conf;
    }
}

Con questo approccio, puoi modificare il file nginx-custom-rules.conf
senza toccare i file globali di configurazione di Nginx, ma sarà
comunque necessario eseguire un reload di Nginx per applicare le
modifiche:

sudo systemctl reload nginx

3. Configurazioni Specifiche per Virtual Host

Se hai più siti sullo stesso server, puoi definire configurazioni
uniche per ciascun virtual host. Ad esempio:

server {
    server_name esempio.com;
    root /var/www/esempio;

    # Configurazioni personalizzate
    location / {
        rewrite ^/vecchio-url$ /nuovo-url permanent;
    }
}

---

In conclusione non esiste un file dinamico come .htaccess
per Nginx, ma puoi ottenere un comportamento simile organizzando la
configurazione globale o per singolo sito con strumenti come:

• Blocchi location.

• File di configurazione inclusi con
  include.

• Configurazioni specifiche per i virtual host.