Guida al deploy di Laravel e PHP

# Come eseguire il deploy di Laravel e PHP su Cloud Noce?

Guida pratica al deploy di Laravel, PHP e Artisan su PaaS Cloud Noce da Git o Gerdoo CLI, con comandi di build e avvio, variabili, domini e indicazioni per la produzione.

risposta breve

Collega il repository del progetto**Laravel e PHP**  a[Cloud Noce PaaS](/products/paas)  oppure, dalla cartella del progetto, esegui`gerdoo deploy` . Cloud Noce compila il progetto, avvia il servizio in un ambiente isolato e fornisce un dominio temporaneo, SSL, log e gestione delle versioni.

Ultima revisione:6 settembre 2026

## Prepara il progetto per il deploy

Aggiungi al repository i file delle dipendenze, come**composer.json e composer.lock** . Ecco i valori tipici dei campi «Comando di build» e «Comando di avvio» per questo stack:

```
# Comando di build
composer install --no-dev --optimize-autoloader && php artisan config:cache

# Comando di avvio
php artisan serve --host=0.0.0.0 --port=$PORT
```

Imposta APP_KEY, APP_ENV, APP_URL e i dati del database come variabili d'ambiente.

## Esegui il deploy da Git

- Crea un progetto e un ambiente nel pannello Cloud Noce.

- Collega il nuovo servizio al repository GitHub o GitLab e al branch desiderato.

- Adatta i campi «Comando di build» e «Comando di avvio» alla struttura effettiva del progetto.

- Inserisci i valori necessari nella sezione «Variabili» e specifica se servono durante la build o in fase di esecuzione.

- Esegui il deploy e segui i log di build e di esecuzione finché il controllo dello stato non ha esito positivo.

- Nella sezione Domini, collega il dominio personalizzato e testa la risposta HTTPS.

## Distribuisci dalla cartella locale con Gerdoo CLI

```
curl -fsSL https://get.gerdoo.cloud/install.sh | sh
gerdoo login
cd your-project
gerdoo deploy
gerdoo logs
```

La CLI pubblica la cartella locale senza collegarsi a Git. Per CI, puoi leggere il token dalle variabili d'ambiente e controllare lo stato del servizio tramite output JSON. La guida completa è nella[Documentazione CLI](/support/docs/cli) .

## Checklist per portare Laravel e PHP in produzione

- Esegui le migrazioni con attenzione e solo dopo aver creato un backup.

- Esegui il queue worker e lo scheduler come servizi separati o tramite cron.

- Per i file caricati, usa un disco persistente o MinIO.

- Prima di ricevere traffico reale, prova il percorso di health check, i timeout e il comportamento in caso di riavvio.

- Conserva i dati in modo persistente, al di fuori del filesystem della versione in esecuzione, usando gli add-on o lo storage.

- Dalla sezione «Deploy», prova a ripristinare la versione precedente per verificare che il team conosca la procedura di recupero.

## Gestire i servizi con Gerdoo Agents

Dopo aver collegato Gerdoo MCP, agenti compatibili come Claude Code, Cursor e Codex possono individuare il servizio, eseguire deploy, leggere build e log, gestire variabili e domini e controllare lo stato del servizio. Le operazioni distruttive richiedono comunque una conferma esplicita.[Consulta la guida per collegare gli agenti](/support/docs/cli/agents) per i dettagli.

## Domande frequenti

### È possibile eseguire Laravel e PHP su Cloud Noce senza Dockerfile?

Sì. Se nel repository sono presenti file di progetto standard come composer.json e composer.lock, Cloud Noce può rilevare il processo di build. Per avere il pieno controllo, puoi anche usare un Dockerfile.

### È possibile eseguire il deploy del progetto Laravel e PHP con la CLI?

Sì. Esegui gerdoo deploy nella cartella del progetto. La prima esecuzione crea il servizio; quelle successive aggiornano lo stesso servizio.

### Come si attivano dominio e SSL?

Dopo il deploy hai un dominio temporaneo. Aggiungi il dominio personalizzato nelle impostazioni del servizio per ottenere automaticamente il certificato SSL.

### Dove si configurano le variabili segrete?

Imposta i valori segreti nella sezione «Variabili» del servizio o dell'ambiente. Non inserirli in Git, nel Dockerfile o nel codice del browser.