Dit is een voorbeeld van hoe je een Laravel applicatie instelt om te deployen op Kinsta’s Applicatie Hosting diensten vanuit een GitHub repository.

Laravel is een gewone op PHP gebaseerde applicatie, dus tijdens het deployment-proces installeert Kinsta automatisch de dependencies die in je composer.json bestand zijn gedefinieerd.

  1. Log in op GitHub en maak een nieuwe repository aan vanuit deze template (gebruik deze template > maak een nieuwe repository): Kinsta – Hello World – Laravel.
  2. Laravel vereist dat de APP_KEY omgevingsvariabele is ingesteld. Je kunt zelf lokaal een app key genereren, of je kunt deze online Laravel key generator gebruiken.
  3. Voeg in MyKinsta een applicatie toe met de Hello World Laravel repository. Vul bij Omgevingsvariabelen, bij Sleutel 1, APP_KEY in, en plak bij Waarde 1 de sleutel gegenereerd uit Stap 2, selecteer Beschikbaar tijdens runtime en Beschikbaar tijdens bouwproces.
  4. Het Start commando kan voor het webproces leeg gelaten worden, omdat Kinsta automatisch het vereiste commando detecteert tijdens de eerste deployment.
    Opmerking: De eerste keer deployen kan mislukken omdat je de nodige Buildpacks moet toevoegen.
  5. Zodat de applicatie de CSS/JS bestanden kan bouwen, moet je twee buildpacks toevoegen: Node.js en PHP. Klik op Settings > Add buildpack, selecteer Node.js > Add buildpack. Herhaal dit voor PHP.
    Het buildpack dat de primaire taal van je applicatie bevat, moet de laatste zijn in de lijst met buildpacks. In dit voorbeeld is PHP de primaire taal en moet het de laatste buildpack in de lijst zijn.
  6. Klik op Deployments > Deploy now > kies de gewenste branch > Deploy application.

De app is beschikbaar zodra de build is voltooid en de Kinsta welkomstpagina wordt geladen op de URL van je applicatie.

Kinsta welkomstpagina na succesvol deployen van Laravel.
Kinsta welkomstpagina na succesvol deployen van Laravel.

Kijk je liever de videoversie?

Een database verbinden

Als je je applicatie aan een database wilt koppelen, begin dan met het maken van een database in hetzelfde datacenter als waar je applicatie staat.

  1. Een database toevoegen.
  2. Verbind de database met de applicatie door een interne verbinding toe te voegen en het selectievakje Omgevingsvariabelen toevoegen… te selecteren. Hierdoor worden de omgevingsvariabelen automatisch ingevuld vanuit de database.
  3. Sommige van de variabelenamen (sleutels) die Laravel gebruikt verschillen van de namen die automatisch worden aangemaakt in MyKinsta. Bewerk de variabele sleutels indien nodig zodat ze overeenkomen met de variabele namen die zijn gedefinieerd in Laravel’s database.php bestand. Hieronder staan de bijbehorende variabele namen (sleutels) voor de databasetypen die Laravel ondersteunt.

Omgevingsvariabelen

MySQL en PostgreSQL

Automatisch gegenereerde sleutel Laravel sleutel
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

Automatisch gegenereerde sleutel Laravel sleutel
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 vereist dat de APP_KEY omgevingsvariabele is ingesteld. Als deze sleutel niet is ingesteld, krijg je een 500 foutpagina te zien die door Laravel wordt geleverd. Je kunt zelf lokaal een app key genereren, of je kunt de online Laravel key generator gebruiken. Als je eenmaal een sleutel hebt, kun je die als omgevingsvariabele toevoegen.

Buildpacks

In de meeste gevallen zul je willen dat de applicatie de CSS/JS bestanden bouwt, dus moet je deze twee Buildpacks toevoegen:

  1. Node.js
  2. PHP

Het buildpack dat de primaire taal van je applicatie bevat moet de laatste zijn in de lijst met buildpacks. In dit voorbeeld is PHP de primaire taal en moet het de laatste buildpack in de lijst zijn.

Webserver instellen

Start commando

Het standaard webproces is heroku-php-apache2. Dit voorbeeld bevat een .htaccess bestand dat alle verzoeken omleidt naar public/index.php voor Laravel. Indien nodig kun je dit commando wijzigen bij het toevoegen van je applicatie (Processen instellen) of op de pagina Processen van de applicatie na de deployment. Je kunt gebruiken:

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