Errore 500 su applicazione PHP: cause e soluzione

In cosa consiste il problema

L'errore 500 è un messaggio generico: il server segnala che qualcosa è andato storto senza dire cosa. Per questo è importante non procedere per tentativi, ma partire dai log degli errori di PHP e del web server.

Spesso compare dopo un evento preciso: un aggiornamento della versione di PHP da parte dell'hosting, il caricamento di nuovi file, una modifica al file .htaccess o la crescita dei dati.

Cause frequenti

• Versione di PHP cambiata: funzioni rimosse in PHP 8 (es. mysql_*, each, create_function) o comportamenti più severi sui tipi.
• Errore nel file .htaccess: direttive non supportate dal server o moduli Apache mancanti.
• Limiti di memoria o tempo: script che superano memory_limit o max_execution_time con dati cresciuti.
• Permessi dei file: cartelle di cache o upload non scrivibili dopo un trasferimento.
• Dipendenze mancanti: estensioni PHP non installate (es. mbstring, intl, pdo) o librerie Composer non aggiornate.

Come si risolve

• Lettura dei log: abilitare temporaneamente il logging degli errori e individuare file e riga coinvolti.
• Correzione mirata: aggiornare il codice incompatibile senza riscrivere l'applicazione.
• Verifica configurazione: versione PHP, estensioni, limiti e permessi coerenti con l'applicazione.
• Prevenzione: ambiente di test con la stessa versione di produzione prima dei prossimi aggiornamenti.

Un esempio tipico

Quando serve uno sviluppatore

Se l'applicazione è usata per lavorare (ordini, clienti, fatture) ogni ora di fermo costa: un intervento professionale riduce il tempo di ripristino ed evita correzioni improvvisate che creano nuovi problemi.

Tecnologie coinvolte

• Apache
• Nginx
• PHP

Quanto tempo può richiedere e quanto può costare

Indicativamente 1–4 ore di lavoro tecnico, per una fascia di 80–250 €.

Le variabili che incidono di più:

• disponibilità dei log
• numero di file coinvolti
• accesso diretto al server
• presenza di librerie datate

Le fasce di prezzo e di tempo indicate sono orientative e dipendono da complessità, qualità del codice esistente, accessi disponibili, documentazione e requisiti effettivi. Non costituiscono preventivo.

Informazioni da preparare

• Indirizzo della pagina che dà errore
• Quando è iniziato e cosa è cambiato
• Accesso FTP/SSH o al pannello di hosting
• Versione di PHP attuale
• Log degli errori, se disponibili