Procedura guidata di configurazione del sito
Segui i quattro passaggi della procedura guidata per collegare un repository Git, compilare .env, creare un database ed eseguire il primo deploy.
Per le applicazioni supportate, Siti → App → Installazione rapida è l’opzione più veloce. Usa la procedura guidata se colleghi un tuo repository e vuoi controllare manualmente distribuzione, ambiente, database e primo deploy.
Esempio del sito Laravel
Se vuoi creare un sito e distribuire un repository Laravel come git@github.com:example/example.com.git, la procedura guidata è il metodo più veloce.
Prima di iniziare
- Creare il sito prima da Siti → Nuovo Sito.
- Per Laravel, mantenere la radice del documento iniziale come
web_root/public. - Scegliere il dominio corretto e la versione PHP prima di aprire la procedura guidata.
- Se il dominio è un dominio apex, è possibile abilitare facoltativamente l'alias
wwwdurante la creazione del sito.
Fase 1 — Disoccupazione
Compila le impostazioni del repository e della distribuzione:
- URL del repository:
git@github.com:example/example.com.git - Branch: di solito
main, a meno che il repository non ne usi un altro - Percorso di deploy: lascia vuoto il suffisso per clonare il progetto direttamente in
web_root.
Opzioni di costruzione consigliate per un progetto Laravel:
composer install: attivonpm build: abilitalo solo se il progetto richiede una compilazione del frontend con Node. Herne Panel non richiede npm.php artisan migrate: abilitalo se crei il database al passaggio 3 e scrivi le stesse credenziali in.env.optimize / cache clear: attivo
Il repository SSH URLs attiva automaticamente la generazione di chiavi quando possibile. È inoltre possibile generare la chiave in seguito dalla pagina Deploy.
Passaggio 2 — .env
Incolla o modifica i valori di produzione di .env per l’applicazione. Controlla almeno le voci qui sotto.
APP_NAMEAPP_ENV=productionAPP_URL=https://your-domainDB_DATABASE,DB_USERNAME,DB_PASSWORD- Mail, coda, cache e tutte le impostazioni API di terze parti richieste dall'app
Se l'applicazione utilizza Redis per cache, sessioni o code, utilizzare l'azione Applica le impostazioni Redis predefinite integrata prima di salvare.
In un sito appena creato il repository non è ancora stato clonato. .env.example potrebbe non essere disponibile in questa fase. Tieni pronti i valori da incollare manualmente.
Passaggio 3 — Database
Crea un database MySQL se l’applicazione Laravel ne ha bisogno.
- Inserisci il nome del database.
- Inserisci il nome utente del database.
- Imposta una password robusta.
- Verifica che gli stessi valori siano riportati in
.env.
Se il progetto non usa un database, puoi saltare questo passaggio.
Se il database esiste già sul server, è possibile terminare la procedura guidata prima e poi utilizzare Siti → Databases → Attach Existing per collegarlo al sito.
Fase 4 — Prima distribuzione
Se il repository è privato e la procedura guidata mostra una chiave di distribuzione pubblica:
- Copia la chiave pubblica mostrata nella procedura guidata.
- Apri il repository su GitHub.
- Vai su Settings → Deploy keys → Add deploy key.
- Incolla la chiave e lasciala in sola lettura, salvo che ti serva l’accesso in scrittura.
Dopo di che, fare clic su Distribuisci ora per clonare il repository ed eseguire i passaggi selezionati.
Dopo il Primo Discorso
I progetti Laravel hanno spesso bisogno di alcuni controlli di follow-up dopo l'implementazione iniziale:
- Esegui
php artisan key:generateseAPP_KEYè vuota. - Esegui
php artisan storage:linkse il progetto richiede il collegamento simbolico allo storage pubblico. - Controlla Siti → Log se il deploy segnala errori.
- Controlla Siti → Log → Log del server se dopo il deploy compaiono errori Nginx o PHP-FPM.
- Controlla Siti → Ambiente e Siti → Artisan se il sito si avvia con problemi di configurazione.
Installazione rapida alternativa
Usa Siti → Apps → Installazione rapida per WebBlocks CMS o una struttura Laravel App pulita. WebBlocks CMS genera le credenziali del database e configura il CMS; Laravel App installa solo la struttura Laravel, così pacchetti come QuizTem possono essere installati in seguito tramite Composer o Terminale. Entrambe le procedure scrivono valori sicuri in .env, proteggono APP_KEY, verificano la scrivibilità durante l’esecuzione e permettono di riprovare un’installazione fallita dopo una pulizia parziale.