Il file .htaccess può contenere impostazioni importanti per un sito web. Viene utilizzata su server web basati su Apache configurati di conseguenza per definire determinate regole direttamente a livello di directory o di sito web.
Ciò può includere, ad esempio, reindirizzamenti, riscritture di URL, restrizioni di accesso o regole specifiche per l'applicazione.
In WordPress si gioca .htaccess spesso un ruolo importante per la struttura dei permalink.
In questa guida ti mostriamo come puoi una esistente .htaccess-file nel cPanel di CURIAWEB, lo salvi, lo modifichi e lo verifichi dopo le modifiche. Inoltre, ti spieghiamo come procedere se si verifica un errore dopo una modifica.
Importante: Anche una sola riga errata in
.htaccesspuò fare sì che un sito Web non sia più raggiungibile correttamente. Crea pertanto una copia di backup del file esistente prima di ogni modifica.
Che cos'è .htaccess? #
.htaccess è un file di configurazione che, con un'opportuna configurazione di Apache, può contenere istruzioni per una determinata directory e i suoi sottodirectory.
Il nome inizia con un punto:
.htaccess
Ciò rende il file nei sistemi basati su Linux un file nascosto o File nascosto trattato.
Se non le vedi nel file manager, potresti dover prima abilitare la visualizzazione dei file nascosti.
La procedura esatta si trova all'indirizzo Visualizzare i file nascosti come .htaccess in cPanel.
A cosa serve il file .htaccess? #
A seconda del sito web e della configurazione del server, .htaccess svolgere compiti diversi.
I campi di impiego tipici sono:
- Riscritture URL
- Reindirizzamenti
- Limitazioni di accesso
- Regole per determinati tipi di file
- configurazioni specifiche per l'applicazione
- Regole dei permalink in WordPress
Non ogni sito web ha bisogno delle stesse regole e non ogni .htaccessIl file sembra uguale.
Importante: Non copiare mai l'intero
.htaccessdi un sito web estraneo alla tua installazione, solo perché lì viene utilizzata un'applicazione simile.
1. Aprire il File Manager di cPanel #
Accedi al tuo cPanel di CURIAWEB e apri:
File → Gestione file
Se non hai ancora familiarità con il file manager, puoi trovare un'introduzione dettagliata su Utilizzare il File Manager di cPanel.
2. Mostrare i file nascosti #
Da .htaccess comincia con un punto, potrebbe essere nascosta nel file manager.
Apri in alto a destra il Impostazioni e attiva:
Mostra file nascosti (dotfiles)
Salva quindi l'impostazione.
3. Aprire la directory del sito web corretta #
Naviga alla radice del documento del sito Web, il cui .htaccess che vuoi modificare.
Per il dominio principale, questo è spesso il caso in una tipica configurazione cPanel:
public_html
Per domini o sottodomini aggiuntivi è tuttavia possibile utilizzare una radice del documento diversa.
Attenzione: Su più siti web è possibile più
.htaccess-i file devono essere presenti. Controlla quindi sempre se ti trovi nella directory corretta.
4. Cerca il file .htaccess #
Cerca nella directory desiderata:
.htaccess
In un'installazione di WordPress, ad esempio, può trovarsi insieme a file e cartelle come:
.htaccess
index.php
wp-admin/
wp-content/
wp-includes/
wp-config.php
si trovano nella directory principale dell'installazione.
Se non è presente alcun file .htaccess #
Se il file non esiste nonostante la visualizzazione dei file nascosti sia attivata, non dovresti creare automaticamente un nuovo file.
Verifica prima:
- se ti trovi nella radice del documento corretta
- se il sito web sia effettivamente
.htaccessnecessario - se l'applicazione utilizzata crei normalmente il file da sola
- se sia stata eventualmente rinominata
Non ogni sito web e non ogni configurazione di server necessita necessariamente di una .htaccess-File.
5. Eseguire il backup di .htaccess prima della modifica #
Prima di apportare modifiche, dovresti creare una copia di backup del file esistente.
Segna:
.htaccess
e scaricali sul tuo computer.
In alternativa, puoi crearne temporaneamente una copia, ad esempio:
.htaccess-backup
Consiglio pratico: Il modo di lavorare più sicuro è: scaricare l'originale, effettuare la modifica, testare il sito web e, in caso di errore, ripristinare immediatamente la versione precedente.
Ti mostriamo in dettaglio come scaricare e modificare i file su Caricare, scaricare e modificare file in cPanel.
6. Aprire .htaccess nell'editor #
Contrassegna il file .htaccess e scegli Modifica.
Successivamente cPanel apre il contenuto nell'editor integrato.
Controlla prima il contenuto esistente prima di modificare qualsiasi cosa.
Rilevare i commenti in .htaccess #
Le righe che iniziano con un doppio cancello sono solitamente usate come commenti.
Per esempio:
# Reindirizzamenti personalizzati
# Non modificare le regole di WordPress
I commenti sono utili per documentare le proprie aree o modifiche.
Ciò può facilitare la successiva ricerca di errori, in particolare con file più grandi.
7. Eseguire solo la modifica necessaria #
Modifica, se possibile, solo la regola specifica che deve essere effettivamente adattata.
Se inserisci contemporaneamente più modifiche indipendenti, la ricerca degli errori diventa notevolmente più difficile.
Regola fondamentale: Apportare una modifica, salvare, testare – solo dopo effettuare la modifica successiva.
L'ordine delle regole può essere importante #
Nei reindirizzamenti e nelle regole di rewrite, l'ordine delle singole istruzioni può avere importanza.
Una regola formulata in termini generali può, ad esempio, influenzare una regola successiva più specifica.
Pertanto, non inserire nuove regole a caso in un punto qualsiasi.
Reindirizzamenti tramite .htaccess #
.htaccess può essere utilizzato per reindirizzare i visitatori da un URL a un altro.
Con un'appropriata configurazione di Apache, un semplice reindirizzamento permanente può ad esempio essere implementato fondamentalmente con un'istruzione come questa:
Redirect 301 /alte-seite/ https://example.com/neue-seite/
Ciò comporta un reindirizzamento HTTP permanente con codice di stato 301 utilizzato.
Importante: Non utilizzare un dominio di esempio di questa guida in un sito web di produzione. Adatta sempre le regole esattamente al tuo dominio reale e alla struttura degli URL.
Non confondere il 301 e il 302 #
Un' Reindirizzamento 301 segnala fondamentalmente uno spostamento permanente.
Un' Reindirizzamento 302 segnala fondamentalmente un reindirizzamento temporaneo.
Quale variante sia quella giusta dipende dallo scopo del reindirizzamento.
Quando un vecchio URL viene sostituito permanentemente da uno nuovo, spesso 301 la variante adatta.
Evitare i cicli di reindirizzamento #
Regole di reindirizzamento errate possono fare sì che un URL venga reindirizzato ripetutamente su se stesso o tra più URL.
Il browser segnala quindi, ad esempio, troppi reindirizzamenti.
Se un tale errore si verifica immediatamente dopo una nuova .htaccess-Se si verifica un errore, rimuovi o correggi prima l'ultima regola aggiunta.
Comprendere le regole di rewrite #
Le riscritture di URL più complesse vengono spesso eseguite tramite mod_rewrite implementato.
Tra queste vi possono essere direttive come:
RewriteEngine
RewriteCond
Regola di riscrittura
essere utilizzato.
Un tipico inizio di una tale area può essere, ad esempio:
RewriteEngine On
La logica specifica dipende tuttavia interamente dal comportamento desiderato.
Attenzione: Le regole di rewrite possono essere molto potenti. Non copiare una regola complessa da internet in un sito web di produzione se non comprendi le condizioni, l'obiettivo e i possibili effetti collaterali.
WordPress e .htaccess #
WordPress può, su configurazioni di server basate su Apache o compatibili .htaccess da utilizzare per i cosiddetti Pretty Permalinks.
Le relative regole consentono ad esempio URL come:
invece di indirizzi puramente basati su parametri.
Riconoscimento dell'area WordPress #
Un sito gestito da WordPress .htaccess può contenere un'area WordPress contrassegnata.
Di solito lo riconosci da commenti come:
# BEGIN WordPress
...
# END WordPress
Questa area può essere gestita o riscritta direttamente da WordPress.
Importante: Non dovresti inserire regole permanenti personali in modo avventato all'interno di un'area gestita automaticamente da WordPress. WordPress può rigenerare questa sezione in seguito a determinate modifiche.
I permalink di WordPress non funzionano #
Se la home page funziona ma le sottopagine mostrano un errore 404, le regole di rewrite o permalink potrebbero essere un possibile punto di verifica.
In WordPress può essere utile aprire le impostazioni dei permalink nel backend e salvarle nuovamente in modo corretto, a condizione che i permessi del server e dei file lo consentano.
Modifica .htaccess non d'ufficio, se la causa non è stata ancora accertata.
Inserire regole personalizzate in WordPress #
Se hai bisogno di regole tue, dovresti considerare quali aree di WordPress vengono gestite automaticamente.
Documenta le tue regole con commenti, ad esempio:
# CURIAWEB - reindirizzamento interno
Reindirizzamento 301 /alt/ https://example.com/neu/
Ciò renderà più facile capire in seguito quali regole sono state aggiunte manualmente.
Salva modifica #
Controlla attentamente il tuo adattamento.
Salva successivamente il file nell'editor di cPanel.
La modifica diventa effettiva direttamente sul server.
Testa subito il sito web #
Apri il sito web interessato immediatamente dopo il salvataggio.
Non testare solo la home page, ma specificamente la funzione che hai modificato.
Ad esempio, in caso di reindirizzamento, dovresti controllare sia la vecchia che la nuova URL.
Nelle regole dei permalink, dovresti poter visitare più sottoitanti.
Considerare la cache del browser nei reindirizzamenti #
I browser possono memorizzare nella cache i reindirizzamenti permanenti.
Se ti trovi a un 301-continui a lavorare sul reindirizzamento e il comportamento appare invariato nonostante la modifica, un reindirizzamento memorizzato nella cache potrebbe quindi giocare un ruolo.
Esegui il test, se necessario, in una finestra di navigazione privata o utilizzando un apposito strumento di ispezione HTTP.
Dopo la modifica compare un errore 500 Internal Server Error #
Uno degli indizi più comuni di un difettoso .htaccess- La modifica è un:
Errore interno del server
Se l'errore si verifica immediatamente dopo il salvataggio, l'ultima regola inserita o modificata è un'area di sospetto importante.
10. In caso di errore 500 ripristinare la versione precedente #
Apri il file manager e sostituisci quella difettosa .htaccess attraverso la tua versione precedentemente salvata.
Testa poi nuovamente il sito web.
Se poi funziona di nuovo, la causa molto probabilmente è da ricercare nella modifica apportata.
Trattiamo l'analisi completa degli errori alla voce Risolvere l'errore 500 Internal Server Error.
.Rinominare temporaneamente .htaccess per la diagnosi #
Se vuoi verificare se un esistente .htaccess ha causato un errore, il file può essere rinominato per un test.
Ad esempio da:
.htaccess
a
.test .htaccess
Il server web non le tratta più come normali sotto questo nome .htaccess-File.
Visita quindi nuovamente il sito web.
Attenzione: La rinominazione potrebbe eliminare temporaneamente reindirizzamenti, permalink, protezione degli accessi o altre regole. Utilizza questo metodo solo brevemente per la diagnosi.
Cosa indica il test? #
Se il sito web con rinominato .htaccess funziona di nuovo, il file o una regola in esso contenuta rappresenta una forte area di sospetto.
Se l'errore persiste, la causa è probabilmente altrove.
Tuttavia, il rinominare non dimostra automaticamente quale singola regola sia difettosa.
.ripristinare .htaccess in seguito #
Dopo il test dovresti rinominare il file con il suo nome originale:
.htaccess
o utilizzare una versione correttamente ripulita.
Non lasciare accidentalmente disabilitato in modo permanente un file rinominato a scopo diagnostico.
403 Forbidden dopo la modifica di .htaccess #
.htaccess può contenere anche regole che limitano l'accesso a determinate directory, file o visitatori.
Se dopo una modifica improvvisamente 403 Proibito appare, quindi controlla anche le regole di accesso modificate di recente.
Trattiamo la diagnosi completa sotto Risolvere l'errore 403 Forbidden.
Controllare i permessi dei file del file .htaccess #
Anche i permessi del file possono essere rilevanti.
Per molti normali file di siti web 644 un valore tipico, ma l'impostazione specifica dipende dalla configurazione del server.
Spieghiamo come funzionano le autorizzazioni e come modificarle su Impostare correttamente i permessi dei file 644 e 755 in cPanel.
.Non impostare .htaccess su 777 #
Se un'applicazione non può scrivere sul file, non dovresti semplicemente aprirlo su:
777
mettere.
Verifica invece permessi, proprietà e il messaggio di errore specifico.
Più file .htaccess possono agire contemporaneamente #
In una struttura di directory possono esserci più .htaccess-file devono essere presenti.
Un file nella directory superiore può preimpostare le impostazioni, mentre un altro file in una sottodirectory contiene regole aggiuntive.
Quando indaghi su un errore, quindi, non dovresti guardare automaticamente solo al primo file trovato.
Esempio di struttura di directory #
public_html/
.htaccess
index.php
shop/
.htaccess
index.php
In questo esempio per la directory negozio sia le regole sovraordinate che quelle ivi definite possono essere rilevanti.
Le regole possono influenzarsi a vicenda. #
In diversi .htaccessfile e complesse regole di riscrittura, il comportamento risultante può diventare difficile da comprendere.
Documenta quindi le tue personalizzazioni ed evita regole duplicate inutilmente.
Evitare i doppi reindirizzamenti #
Se un reindirizzamento è già stato implementato da WordPress, da un plugin, da cPanel o da un'altra configurazione del server, non dovresti duplicare la stessa logica senza un motivo in .htaccess registrare.
Più regole in conflitto possono causare catene di reindirizzamento o cicli.
Reindirizzamenti cPanel e .htaccess #
Se imposti un reindirizzamento tramite la relativa funzione di cPanel, questo può essere tecnicamente implementato anche tramite regole del server web.
Se in seguito anche manualmente .htaccess lavori, dovresti quindi verificare quali regole sono già presenti.
Trattare i reindirizzamenti HTTPS con cautela #
I reindirizzamenti da HTTP a HTTPS vengono spesso implementati tramite regole del server web.
Se il tuo sito web dispone già di un reindirizzamento HTTPS a un altro livello, una regola manuale aggiuntiva può causare reindirizzamenti duplicati o errati.
Verifica quindi prima la configurazione esistente.
non forzare contemporaneamente www e non-www in modo contraddittorio #
Una pagina web può ad esempio trovarsi su:
o:
essere canonizzato.
La situazione diventa problematica quando regole diverse impongono simultaneamente l'altra variante.
Questo può causare un ciclo di reindirizzamento.
Non usare regole prese da Internet senza prima averle verificate #
Molti vecchi manuali contengono regole scritte per una specifica configurazione del server, versione di Apache o applicazione.
Una regola può quindi essere superflua, inefficace o errata su un altro sistema.
Sicurezza: Adotta solo le regole di cui comprendi lo scopo e di cui puoi valutare la fonte. Soprattutto le regole di riscrittura e di accesso sconosciute non dovrebbero essere implementate senza verifica su un sito web di produzione.
Non salvare le credenziali nei commenti di .htaccess #
I commenti sono pratici per le note tecniche, ma non sono un luogo di archiviazione sicuro per informazioni riservate.
Non salvarci nessuno:
- Password
- Chiave API
- Accessi al database
- credenziali personali d'accesso
.Non rendere pubblica la file .htaccess #
Se hai bisogno di supporto, non dovresti pubblicare pubblicamente e senza verifica il contenuto di file di configurazione sensibili in forum o social network.
Rimuovi o anonimizza le informazioni riservate prima di condividere gli estratti.
Documentare le modifiche #
Su un sito web in produzione, vale la pena documentare in modo tracciabile le modifiche manuali importanti.
Puoi, ad esempio, aggiungere un commento:
# CURIAWEB - Reindirizzamento permanente dei vecchi URL
Reindirizzamento 301 /alt/ https://example.com/neu/
Inoltre, dovresti annotare al di fuori del file quando e perché è stata apportata la modifica.
Rimuovere nuovamente i file di backup temporanei #
Se tu copie come:
.htaccess-backup
.htaccess-old
.test .htaccess
una volta completati i lavori, dovresti verificare se sono ancora necessari.
Non lasciare copie di configurazione superflue permanentemente in directory accessibili pubblicamente.
Procedura consigliata per una modifica di .htaccess #
- Apri File → Gestione file.
- Attiva la visualizzazione dei file nascosti.
- Apri la radice dei documenti del sito web corretto.
- Cerca
.htaccess. - Scarica il file originale come backup.
- Apri
.htaccessSono un editor. - Modifica solo la regola necessaria.
- Salva il file.
- Testa immediatamente la funzione del sito web interessata.
- In caso di errore, ripristina la versione precedente.
Procedura consigliata in caso di errore #
- Verifica se l'errore si verifica subito dopo un
.htaccess-si è verificato un cambiamento. - Ripristina la versione salvata in precedenza.
- Testa nuovamente il sito web.
- Se non è presente alcun backup, nomina
.htaccessbrevemente per la diagnosi. - Verifica se il quadro degli errori cambia.
- Analizza successivamente le regole sospette una per una.
- Ripristina la configurazione corretta richiesta.
Regola fondamentale: Usa
.htaccessIn modo mirato. Proteggi il file da modifiche, cambia una sola cosa alla volta e testa immediatamente dopo.
Quando dovresti contattare il supporto? #
Se un sito Web chiede .htaccess-modifica non è più raggiungibile o una regola non funziona come previsto, dovresti documentare l'ultima modifica apportata.
Per un'analisi sono particolarmente utili le seguenti indicazioni:
- dominio interessato
- Elenco di
.htaccess - quale funzione dovrebbe essere implementata
- quale regola è stata modificata o integrata
- quale errore si verifica successivamente
- se il sito web con il precedente
.htaccessfunziona - se del caso il codice di errore HTTP
Non condividere password, chiavi API o altre credenziali riservate all'interno di una normale descrizione di un errore.
Riepilogo #
.htaccess è un importante file di configurazione per i siti Web su server Web basati su Apache configurati di conseguenza. Può contenere, tra le altre cose, reindirizzamenti, regole di rewrite, restrizioni di accesso e regole di permalink di WordPress.
Poiché il file inizia con un punto, nel Gestore File di cPanel potresti prima dover Mostra file nascosti (dotfiles) attivare.
Crea una copia di backup del file esistente prima di ogni modifica. Successivamente, modifica solo la regola strettamente necessaria e testa il sito web immediatamente dopo il salvataggio.
Se dopo una modifica compare un errore 500 o 403, ripristina prima la versione precedente oppure usa una rinomina temporanea solo per una diagnostica mirata.
Non copiare elementi sconosciuti .htaccess-Regole o file di configurazione completi di siti Web esterni senza controllo nella tua installazione. Soprattutto con le regole di riscrittura e reindirizzamento, piccole differenze possono avere grandi impatti.