IT

Hosting web

Ospita un sito Laravel su Plesk

Pubblica un'applicazione Laravel su Plesk, con o senza Laravel Toolkit: versione di PHP, database, file .env, migrazioni, attività pianificate ed errori più comuni.

10 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Questa guida spiega come pubblicare un'applicazione Laravel sul tuo hosting Plesk. Vengono descritti due metodi: con Laravel Toolkit, lo strumento di Plesk dedicato a Laravel, oppure manualmente se questo strumento non è disponibile.

Prerequisiti

  • Un accesso al tuo pannello Plesk (vedi Connetti all'interfaccia Plesk).
  • Un dominio collegato al tuo hosting e che punti a quest'ultimo.
  • Una versione di PHP compatibile con la tua applicazione. Laravel 13 richiede PHP 8.3 o superiore. Per un'altra versione di Laravel, controlla la riga php del file composer.json.
  • Le estensioni PHP richieste da Laravel: Ctype, cURL, DOM, Fileinfo, Filter, Hash, Mbstring, OpenSSL, PCRE, PDO, Session, Tokenizer e XML, oltre a pdo_mysql per MySQL o MariaDB.
  • Il tuo progetto, in un repository Git o sul tuo computer.

Questa guida usa httpdocs, la cartella abituale del dominio principale. Per un dominio aggiuntivo la cartella può essere diversa: controlla la Root del documento in Hosting e DNS > Hosting.

Un punto essenziale: la cartella public

Solo la cartella public di Laravel deve essere accessibile dal web. Il resto del progetto contiene, tra l'altro, il file .env con le tue password e la tua chiave di cifratura. Non spostare mai index.php nella radice del progetto: la root del documento del dominio deve puntare a public.

Con un progetto collocato in httpdocs, il valore da usare è /httpdocs/public.

Passaggio 1: scegli la versione di PHP

  1. Vai su Siti web e domini e individua il tuo dominio.
  2. Apri PHP (o Impostazioni PHP, a seconda della tua versione di Plesk).
  3. Seleziona una versione compatibile, poi salva.

Passaggio 2: crea il database

Crea un database e un utente dedicato seguendo la guida Crea un database. Annota il nome del database, l'utente, la password e l'host indicato da Plesk nelle informazioni di connessione del database.

Metodo 1: con Laravel Toolkit

Installa l'applicazione

In Siti web e domini, sul tuo dominio, clicca su Crea sito web > Laravel, poi scegli:

  • Installa da repository remoto: inserisci l'URL del tuo repository. Se è privato, aggiungi al repository la chiave pubblica mostrata da Plesk (la procedura è descritta in Esegui il deploy da GitHub o GitLab). Clicca poi su Installa applicazione.
  • Installa scheletro: Plesk installa un'applicazione Laravel vuota. Clicca su Installa applicazione, poi, se hai già un progetto, sostituisci i file con i tuoi via FTP o con il gestore di file.

Se la tua applicazione è già presente sull'hosting:

  1. In Hosting e DNS > Hosting, imposta Root del documento su /httpdocs/public, poi clicca su Salva.
  2. Torna alla scheda Dashboard, clicca su Crea sito web > Laravel, poi su Annulla.
  3. Clicca su Analizza affinché Plesk rilevi l'applicazione.

Configura il file .env

Apri Laravel dal tuo dominio. In Variabili d'ambiente (.env), clicca su Modifica, adatta i valori seguenti, poi clicca su Aggiorna:

Configurazione
APP_NAME="La mia applicazione"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://tuo-dominio.com

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=nome_database
DB_USERNAME=utente_database
DB_PASSWORD=password_database

Esegui i comandi Artisan

Nella scheda Artisan, inserisci ogni comando senza il prefisso php artisan, poi eseguilo:

Testo
key:generate --force
migrate --force
storage:link
optimize
  • key:generate --force crea la chiave APP_KEY. Eseguilo solo se questo valore è vuoto: cambiare la chiave di un sito in produzione rende illeggibili i dati cifrati e disconnette gli utenti.
  • migrate --force crea le tabelle. Per impostazione predefinita, Laravel vi memorizza anche le sessioni, la cache e le code.
  • storage:link rende accessibili i file del disco public.
  • optimize mette in cache la configurazione, le route, gli eventi e le viste.

Esegui il deploy degli aggiornamenti

Nella scheda Implementazione:

  1. Scegli la Modalità d'implementazione: Manuale o Automatico.
  2. In Scenario dell'implementazione, deseleziona i passaggi non necessari.
  3. Clicca su Implementa.

Il pulsante Modifica script consente di personalizzare il deploy, a condizione che l'accesso SSH sia autorizzato per il dominio.

Attiva le attività pianificate

Le attività si definiscono nel codice dell'applicazione, in genere in routes/console.php. Non possono essere create da Plesk. Quando esiste almeno un'attività, compare la scheda Attività pianificate: imposta il relativo interruttore su Abilitato.

Attiva le code

Il funzionamento delle code in Laravel Toolkit si basa sul database e sulle attività pianificate, che devono quindi essere attive.

  1. Aggiungi il pacchetto di integrazione di Plesk alla sezione require di composer.json, verificandone la compatibilità con la tua versione di Laravel:

    JSON
    "plesk/ext-laravel-integration": "^7.0"
  2. Esegui il deploy, poi fai il commit del file composer.lock aggiornato ed esegui di nuovo il deploy.

  3. Verifica che nel file .env sia presente QUEUE_CONNECTION=database.

  4. Attiva la Modalità di manutenzione.

  5. In Artisan, esegui migrate --force. Se il tuo progetto non contiene una migrazione per la tabella jobs, esegui prima queue:table.

  6. Disattiva la Modalità di manutenzione, poi imposta l'interruttore Coda su Abilitato.

Metodo 2: senza Laravel Toolkit

Prepara il progetto sul tuo computer

Dalla cartella del progetto, installa le dipendenze di produzione e compila i file front-end:

Terminale
composer install --no-dev --optimize-autoloader
npm ci
npm run build
php artisan key:generate --show

Conserva la chiave mostrata dall'ultimo comando: inizia con base64:. Se il tuo sito è già in produzione, riutilizza invece la sua chiave attuale.

Carica i file

  1. Crea un archivio .zip del progetto, con le cartelle vendor e public/build, ma senza node_modules né il tuo file .env locale.

  2. In File, apri httpdocs, carica l'archivio, selezionalo, clicca su Estrai file, poi eliminalo.

  3. Crea in httpdocs un file .env riprendendo l'esempio del metodo 1 e aggiungi la tua chiave:

    Configurazione
    APP_KEY=base64:TUA_CHIAVE_GENERATA

Puoi anche usare un account FTP per caricare i file.

Imposta la root del documento

  1. In Siti web e domini, apri Hosting e DNS > Hosting per il tuo dominio.
  2. Imposta Root del documento su /httpdocs/public.
  3. Clicca su Salva.

Esegui i comandi Artisan

Con un accesso SSH, usa il binario PHP corrispondente alla versione scelta per il sito. Il solo comando php può puntare a un'altra versione:

Terminale
cd httpdocs
/opt/plesk/php/8.3/bin/php artisan migrate --force
/opt/plesk/php/8.3/bin/php artisan storage:link
/opt/plesk/php/8.3/bin/php artisan optimize

Senza accesso SSH, passa dalle attività pianificate:

  1. Apri Attività pianificate, poi clicca su Aggiungi attività.
  2. Scegli Eseguire uno script PHP.
  3. Seleziona il file httpdocs/artisan con l'icona della cartella.
  4. Nel campo degli argomenti (with arguments), inserisci migrate --force.
  5. Seleziona la versione di PHP usata dal sito.
  6. Clicca su Esegui adesso e attendi il risultato.

Ripeti l'operazione con storage:link, poi con optimize. Al termine puoi annullare senza salvare l'attività.

Pianifica le attività Laravel

Se la tua applicazione usa lo scheduler, crea un'attività Eseguire uno script PHP come sopra, con l'argomento schedule:run e la frequenza seguente, in stile Cron:

Testo
* * * * *

Verifica il risultato

  1. Apri https://tuo-dominio.com/: deve comparire la tua applicazione.

  2. Prova la route di controllo di Laravel, presente per impostazione predefinita nei progetti recenti:

    Terminale
    curl -i https://tuo-dominio.com/up

    Il codice 200 significa che l'applicazione si è avviata senza errori.

  3. Verifica che un file sensibile non sia esposto: https://tuo-dominio.com/.env non deve mai mostrare la tua configurazione.

  4. Prova una pagina che usa il database, ad esempio quella di accesso.

Risoluzione dei problemi

Errore 500 senza dettagli

Consulta storage/logs/laravel.log dal gestore di file, oppure usa il pulsante Registri di Laravel Toolkit. Attiva APP_DEBUG=true solo per poco tempo se il log non basta.

No application encryption key has been specified.

La variabile APP_KEY è vuota o assente. Generala con key:generate --force, oppure incolla la chiave creata sul tuo computer, poi esegui config:clear.

Le modifiche al file .env vengono ignorate

La configurazione è in cache. Esegui optimize:clear, poi optimize una volta risolto il problema.

Errore 403, 404 o elenco di file sulla home page

Probabilmente la root del documento non punta a public. Verifica che il suo valore sia /httpdocs/public. Se solo le pagine interne restituiscono un errore 404, verifica che il file public/.htaccess sia stato caricato.

Vite manifest not found at: .../public/build/manifest.json

I file front-end non sono stati compilati o caricati. Esegui npm run build, poi carica la cartella public/build.

SQLSTATE[HY000] [1045] Access denied

L'utente o la password del database non sono corretti, oppure l'utente non è associato a questo database. Correggi il file .env, poi esegui config:clear. Se la password contiene spazi o il carattere #, racchiudila tra virgolette.

SQLSTATE[HY000] [2002]

Laravel non riesce a raggiungere il server del database. Verifica DB_HOST e DB_PORT nelle informazioni di connessione del database. Se il messaggio indica No such file or directory con localhost, prova DB_HOST=127.0.0.1.

SQLSTATE[42S02]: tabella sessions o cache non trovata

Le migrazioni non sono state eseguite su questo database. Esegui migrate --force.

Failed to open stream: Permission denied in storage

Laravel deve poter scrivere in storage e bootstrap/cache. Verifica i permessi di queste cartelle nel gestore di file. Se non riesci a correggerli, contatta il supporto.

Your Composer dependencies require a PHP version ">= 8.3.0"

Il sito o la riga di comando usa una versione di PHP troppo vecchia. Seleziona la versione corretta in Plesk e, via SSH, richiama il binario completo, ad esempio /opt/plesk/php/8.3/bin/php.

Le immagini caricate restituiscono un errore 404

Il collegamento allo storage pubblico manca o è andato perso durante un deploy. Esegui di nuovo storage:link.

La scheda Attività pianificate non compare

Viene visualizzata solo se l'applicazione definisce almeno un'attività. Controlla routes/console.php, poi esegui di nuovo il deploy.