Questo è un esempio di come configurare un’applicazione Laravel da distribuire sui servizi di Hosting di Applicazioni di Kinsta da un repository GitHub.

Laravel è una normale applicazione basata su PHP, quindi, durante il processo di distribuzione, Kinsta installa automaticamente le dipendenze definite nel file composer.json.

  1. Accedere a GitHub e creare un nuovo repository da questo template (Usa questo template > Crea un nuovo repository): Kinsta – Hello World – Laravel.
  2. Laravel richiede l’impostazione della variabile d’ambiente APP_KEY. Potete generare voi stessi una chiave per l’applicazione in locale oppure utilizzare questo generatore di chiavi Laravel online.
  3. In MyKinsta, aggiungete un’applicazione con il repository Hello World Laravel. In Variabili d’ambiente, in Key 1, inserite APP_KEY, e in Value 1, incollate la chiave generata al punto 2, selezionate Disponibile durante il runtime e Disponibile durante il processo di build.
  4. Il comando Start può essere lasciato vuoto per il processo web perché Kinsta rileva automaticamente il comando richiesto durante la prima distribuzione.
    Nota: La prima distribuzione potrebbe fallire perché è necessario aggiungere i Buildpack necessari.
  5. Affinché l’applicazione possa creare i file CSS/JS, è necessario aggiungere due buildpack: Node.js e PHP. Fare clic su Impostazioni > Aggiungi buildpack, selezionare Node.js > Aggiungi buildpack. Ripetere l’operazione per PHP.
    Il buildpack che contiene il linguaggio principale dell’applicazione deve essere l’ultimo nell’elenco dei buildpack. In questo esempio, PHP è il linguaggio principale e deve essere l’ultimo buildpack dell’elenco.
  6. Fare clic su Distribuzioni > Distribuisci adesso > scegli il ramo desiderato > Distribuisci applicazione.

L’applicazione è disponibile non appena la compilazione è terminata e la pagina di benvenuto di Kinsta viene caricata all’URL dell’applicazione.

Pagina di benvenuto di Kinsta dopo l'implementazione di Laravel.
Pagina di benvenuto di Kinsta dopo l’implementazione di Laravel.

Preferisci guardare la versione video?

Collegare un database

Se si desidera collegare l’applicazione a un database, iniziare creando un database nello stesso data center in cui si trova l’applicazione.

  1. Aggiungere un database.
  2. Collegare il database all’applicazione aggiungendo una connessione interna e selezionare la casella Aggiungere le variabili d’ambiente… Questo popolerà automaticamente le variabili d’ambiente dal database.
  3. Alcuni dei nomi delle variabili (chiavi) utilizzati da Laravel sono diversi da quelli creati automaticamente in MyKinsta. Modificare le chiavi variabili come necessario per far corrispondere i nomi delle variabili definiti nel file database.php di Laravel. Di seguito sono riportati i nomi delle variabili (chiavi) corrispondenti ai tipi di database supportati da Laravel.

Variabili d’ambiente

MySQL e PostgreSQL

Chiave generata automaticamente Chiave Laravel
DB_HOST DB_HOST
DB_PORT DB_PORT
DB_NAME DB_DATABASE
DB_USER DB_USERNAME
DB_PASSWORD DB_PASSWORD
DB_CONNECTION_URL DB_URL


Redis

Chiave generata automaticamente Chiave Laravel
DB_HOST REDIS_HOST
DB_PORT REDIS_PORT
DB_NAME REDIS_DB
DB_USER REDIS_USERNAME
DB_PASSWORD REDIS_PASSWORD
DB_CONNECTION_URL REDIS_URL

Laravel APP_KEY

Laravel richiede l’impostazione della variabile d’ambiente APP_KEY. Se questa chiave non è impostata, si vedrà una pagina di errore 500 servita da Laravel. Potete generare voi stessi una chiave per l’applicazione in locale, oppure utilizzare il generatore di chiavi Laravel online. Una volta ottenuta la chiave, potrete aggiungerla come variabile d’ambiente.

Buildpack

Nella maggior parte dei casi, si vorrà che l’applicazione crei i file CSS/JS, quindi sarà necessario aggiungere questi due Buildpack:

  • Node.js
  • PHP

Il buildpack che contiene il linguaggio principale dell’applicazione deve essere l’ultimo nell’elenco dei buildpack. In questo esempio, PHP è il linguaggio principale e deve essere l’ultimo buildpack dell’elenco.

Configurazione del Server Web

Comando di Avvio

Il processo web predefinito è heroku-php-apache2. Questo esempio include un file .htaccess che reindirizza tutte le richieste a public/index.php per Laravel. Se necessario, è possibile modificare questo comando quando si aggiunge l’applicazione (Imposta i processi) o nella pagina Processi dell’applicazione dopo la distribuzione. Potete utilizzare:

  • heroku-php-apache2 /public
  • php artisan serve --host 0.0.0.0 --port 8080

Documentazione correlata