Een Laravel-project implementeren op een VPS (handleiding voor beginners)

Heb je je Laravel-project al afgerond en vraag je je nu af: "Mijn applicatie werkt perfect op mijn computer, maar hoe krijg ik hem nu live voor echte gebruikers?" Dit is vaak het punt waar veel beginners vastlopen, omdat lokaal ontwikkelen en live implementatie totaal verschillend aanvoelen.

Zodra je de implementatie in gang zet, begin je ineens dingen te zien... SSH toegang, Componist, PHP versies, databases, Nginx Configuratie, machtigingen en serverinstellingen. Als je denkt: "Moet ik dit echt allemaal eerst begrijpen?", dan ben je niet de enige.

Het goede nieuws is dat de implementatie van Laravel veel eenvoudiger wordt zodra je begrijpt wat elke stap precies doet. Na het lezen van dit artikel weet je hoe je je Laravel-project op een VPS implementeert, veelgemaakte fouten vermijdt en een stabiele productieomgeving opzet.

Wat is Laravel-implementatie op een VPS?

Het implementeren van Laravel op een VPS betekent dat je je Laravel-project verplaatst van een lokale ontwikkelomgeving naar een live server waar gebruikers via internet toegang hebben tot je applicatie. Dit proces bereidt het project voor op gebruik in een echte productieomgeving in plaats van alleen op je eigen computer.

Tijdens de implementatie worden belangrijke componenten correct geconfigureerd, waaronder projectbestanden, afhankelijkheden, databaseverbindingen, omgevingsinstellingen en webserverconfiguraties. Deze configuraties zorgen ervoor dat uw Laravel-applicatie soepel draait, verzoeken correct afhandelt en stabiele prestaties levert voor bezoekers.

Een VPS biedt dedicated resources en meer controle over uw hostingomgeving. U kunt compatibele software installeren. PHP versies, manage Serverinstellingen aanpassen, wachtrijwerkers uitvoeren, de beveiliging verbeteren en de prestaties optimaliseren op basis van de vereisten van uw Laravel-project en toekomstige groei.

Wat je nodig hebt voordat je een Laravel-project implementeert

Voordat je daadwerkelijk met de implementatie begint, neem even de tijd om jezelf af te vragen: heb je alles al klaar?

Veel beginners beginnen meteen met installatiecommando's en lopen later vast omdat een vereiste tool, pakket of serverinformatie ontbreekt. Door eerst een paar minuten te besteden aan de voorbereiding, kunt u later veel tijd en frustratie besparen.

Voordat je verdergaat, zorg ervoor dat je de volgende zaken klaar hebt liggen:

• VPS-server: Dit is de plek waar je Laravel-applicatie daadwerkelijk zal draaien. Als je nog geen VPS hebt, YouStable VPS hosting Dit kan een praktische optie zijn, omdat het root-toegang, schaalbare resources en een omgeving biedt die geschikt is voor Laravel-projecten.
• SSH Geloofsbrieven: U gebruikt deze gegevens om veilig verbinding te maken en manage uw server op afstand.
• Laravel-projectbestanden: Zorg dat uw applicatiecode, assets en configuratiebestanden gereed zijn vóór de implementatie.
• Domeinnaam: Een domein helpt bij het creëren van een professioneel websiteadres en vereenvoudigt de HTTPS-configuratie.
• PHP Compatibele versie: Laravel vereist ondersteuning PHP versies voor stabiele prestaties en pakketcompatibiliteit.
• Componist: Laravel is afhankelijk van Composer voor het automatisch installeren en beheren van projectpakketten.
• Toegang tot de database: Databasegegevens zijn vereist omdat Laravel applicatie-informatie en gebruikersgegevens opslaat.
• Basiskennis van terminals: Je hebt geen geavanceerde Linux-vaardigheden nodig, maar het kennen van basiscommando's is wel erg handig.

Nog een belangrijk punt om te controleren voordat we verdergaan, is Laravel en PHP compatibiliteit. Het gebruik van niet-ondersteunde versies kan leiden tot afhankelijkheidsconflicten, installatieproblemen en onverwachte toepassingsfouten.

Zodra deze zaken gereed zijn, verloopt het daadwerkelijke implementatieproces van Laravel veel soepeler en kunt u zich concentreren op het bouwen en lanceren van uw applicatie in plaats van op het oplossen van vermijdbare installatieproblemen.

Laravel en PHP Versiecompatibiliteit

Voordat je verdergaat met het implementatieproces, is er één belangrijk ding dat je zorgvuldig moet controleren: zijn je Laravel- en PHP Zijn de versies compatibel met elkaar? Het gebruik van niet-ondersteunde versies kan leiden tot pakketconflicten, installatieproblemen en onverwachte toepassingsfouten.

Laravel is afhankelijk van ondersteunde PHP Versies zijn belangrijk omdat functies, pakketvereisten, prestatieverbeteringen en beveiligingsupdates vaak veranderen tussen releases. Het kiezen van de juiste combinatie zorgt ervoor dat je Laravel-project soepeler draait en vermindert compatibiliteitsproblemen tijdens de implementatie.

Een Laravel-project implementeren op een VPS (stapsgewijze handleiding)

Nu begint het eigenlijke implementatieproces. In deze fase bereid je de server voor, installeer je de benodigde software, upload je je Laravel-applicatie, configureer je de omgeving en optimaliseer je alles voor productiegebruik. 

Als je je eerste Laravel-applicatie implementeert, volg dan de stappen in dezelfde volgorde, want het overslaan van configuraties kan later fouten veroorzaken met betrekking tot machtigingen, afhankelijkheden, databaseverbindingen of applicatieprestaties.

Stap 1: Maak verbinding met uw VPS via SSH

De eerste stap is het veilig verbinden met uw VPS-server via SSH (Secure Shell). SSH geeft u toegang tot en manage Je kunt je server op afstand benaderen via terminalopdrachten.

De meeste VPS-providers bieden het volgende:

• Server IP adres
• Gebruikersnaam
• Wachtwoord
• SSH sleutel (optioneel)

Basic SSH opdracht:

ssh root@your-server-ip

Voorbeeld:

ssh [email protected]

Als uw server gebruik maakt van SSH sleutelverificatie:

ssh -i private-key.pem root@your-server-ip

In productieomgevingen vermijden veel ontwikkelaars het continu gebruiken van het root-account, omdat root onbeperkte toegang heeft.

Maak een aparte gebruiker aan:

adduser laraveluser
usermod -aG sudo laraveluser

Dit verbetert:

• Security
• Gebruiker management
• Toegangscontrole

Je kunt dan van gebruiker wisselen:

su - laraveluser

Stap 2: Serverpakketten bijwerken

Voordat u software installeert, dient u eerst uw serverpakketten bij te werken. Dit vermindert compatibiliteitsproblemen en zorgt ervoor dat de nieuwste beveiligingsupdates worden geïnstalleerd.

Run:

sudo apt update
sudo apt upgrade -y

U kunt ook onnodige pakketten verwijderen:

sudo apt autoremove -y

Het bijwerken van de server helpt:

• Los beveiligingsproblemen op
• Verbeter de pakketcompatibiliteit.
• Installeer de nieuwste bugfixes.
• Verminder afhankelijkheidsproblemen

Het negeren van updates kan later pakketconflicten veroorzaken tijdens de installatie van Laravel.

Stap 3: installeer de vereiste software

Laravel is afhankelijk van verschillende services en pakketten voordat het goed kan functioneren.

De belangrijkste onderdelen zijn:

• PHP
• PHP extensies
• Componist
• Database
• Nginx
• Git
• Unzip

Install PHP en vereiste uitbreidingen

Laravel vereist PHP en diverse uitbreidingen voor de functionaliteit van de applicatie.

Install PHP:

sudo apt install php php-fpm php-cli php-mysql php-curl php-xml php-mbstring php-bcmath php-zip php-gd php-intl unzip -y

Enkele veelgebruikte Laravel-functies PHP De uitbreidingen omvatten:

Check PHP versie:

php -v

Zorg ervoor dat de geïnstalleerde versie overeenkomt met de vereisten van uw Laravel-release.

Composer installeren

Componist manageLaravel-pakketten en -afhankelijkheden.

Composer installeren:

curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

Controleer de installatie:

composer --version

Composer-handles:

• Pakketinstallatie
• Afhankelijkheid management
• Laravel pakketupdates
• Autoload-generatie

Install MySQL Database

De meeste Laravel-applicaties gebruiken MySQL of MariaDB.

Install MySQL:

sudo apt install mysql-server -y

Beveilig MySQL installatie:

sudo mysql_secure_installation

Database aanmaken:

CREATE DATABASE laravelapp;

Gebruiker aanmaken:

CREATE USER 'laraveluser'@'localhost' IDENTIFIED BY 'StrongPassword';

Verlenen van privileges:

GRANT ALL PRIVILEGES ON laravelapp.* TO 'laraveluser'@'localhost';
FLUSH PRIVILEGES;

Het gebruik van aparte databasegebruikers verbetert de beveiliging in vergelijking met het gebruik van het root-databaseaccount.

Installeer Git

Git vereenvoudigt de implementatie en toekomstige updates.

Git installeren:

sudo apt install git -y

Installatie controleren:

git --version

Install Nginx

Nginx wordt vaak gebruikt met Laravel omdat het efficiënt werkt met PHP-FPM.

Install Nginx:

sudo apt install nginx -y

Start service:

sudo systemctl start nginx

Opstarten inschakelen:

sudo systemctl enable nginx

Status verifiëren:

sudo systemctl status nginx

Stap 4: Upload je Laravel-project naar de VPS

Upload nu de bestanden van je Laravel-applicatie naar de server.

Veelgebruikte uploadmethoden:

Voorbeeld van een Git-implementatie:

git clone https://github.com/username/project.git

Verhuisproject:

sudo mv project /var/www/

Navigeren:

cd /var/www/project

Git-implementatie heeft doorgaans de voorkeur omdat toekomstige updates daardoor eenvoudiger worden.

Stap 5: Installeer de Laravel-afhankelijkheden

Installeer de projectafhankelijkheden:

composer install --optimize-autoloader --no-dev

Deze opdracht:

• Verwijdert ontwikkelingspakketten
• Optimaliseert automatisch geladen bestanden
• Verbetert de productieprestaties
• Vermindert onnodige afhankelijkheden

Stap 6: Configureer het Laravel-omgevingsbestand

Laravel gebruikt een omgevingsbestand voor configuratie.

Maken:

cp .env.example .env

Openen:

nano .env

Voorbeeld:

APP_NAME=LaravelApp
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravelapp
DB_USERNAME=laraveluser
DB_PASSWORD=StrongPassword

Voor productie:

• Stel APP_ENV in op production
• Stel APP_DEBUG=false in

Het ingeschakeld laten van de debugmodus in een productieomgeving kan gevoelige applicatie-informatie blootleggen.

Stap 7: Genereer een applicatiesleutel en voer databasemigraties uit.

Genereer een Laravel-applicatiesleutel:

php artisan key:generate

Voer de databasemigratie uit:

php artisan migrate

Optionele database-initialisatie:

php artisan db:seed

Als uw project gebruikmaakt van uploads:

php artisan storage:link

Dit creëert een symbolische link tussen opslag en openbare mappen.

Stap 8: Configureer Nginx voor Laravel

Configuratie maken:

sudo nano /etc/nginx/sites-available/laravel

Voeg toe:

server {
   listen 80;
   server_name yourdomain.com;
   root /var/www/project/public;
   index index.php;
   location / {
       try_files $uri $uri/ /index.php?$query_string;
   }
   location ~ \.php$ {
       include snippets/fastcgi-php.conf;
       fastcgi_pass unix:/run/php/php8.2-fpm.sock;
   }
}

Configuratie inschakelen:

sudo ln -s /etc/nginx/sites-available/laravel /etc/nginx/sites-enabled/

Controleer de configuratie:

sudo nginx -t
Restart:
sudo systemctl restart nginx

Stap 9: Stel de juiste bestandsrechten in.

Laravel vereist schrijfrechten voor specifieke mappen.

Run:

sudo chown -R www-data:www-data /var/www/project
sudo chmod -R 775 storage
sudo chmod -R 775 bootstrap/cache

Correcte machtigingen helpen het volgende te voorkomen:

• Fouten met toestemming geweigerd
• Cachefouten
• Uploadproblemen
• Fouten bij het schrijven van logbestanden

Stap 10: inschakelen SSL Certificaat

HTTPS-verbeteringen:

• Security
• SEO-prestaties
• Browservertrouwen
• Data encryptie

Certbot installeren:

sudo apt install certbot python3-certbot-nginx -y

Genereer een SSL:

sudo certbot --nginx

Certbot configureert automatisch HTTPS en kan omleidingsregels aanmaken.

Stap 11: Laravel optimaliseren voor productie

Laravel bevat ingebouwde optimalisatiecommando's.

Run:

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan optimize

Voordelen:

• Sneller laden van pagina's
• Verminderde serververwerking
• Betere applicatieprestaties
• Lager hulpbronnengebruik

Voor wachtrijmedewerkers:

php artisan queue:work

Voor productieomgevingen gebruiken veel ontwikkelaars later Supervisor om de wachtrijwerkers continu te laten draaien.

Veelvoorkomende Laravel-implementatiefouten en oplossingen

Zelfs na het correct volgen van het implementatieproces kunnen Laravel-applicaties soms fouten vertonen tijdens de configuratie of na de livegang.

De meeste implementatieproblemen ontstaan ​​meestal door onjuiste machtigingen, ontbrekende pakketten, fouten in de serverconfiguratie of problemen met de databaseverbinding. Het goede nieuws is dat de meeste van deze problemen eenvoudig op te lossen zijn zodra de oorzaak is vastgesteld.

1. 403 Verboden fout

Een 403 Forbidden- foutmelding verschijnt meestal wanneer de server geen toestemming heeft om de Laravel-bestanden correct te benaderen of wanneer de webserver naar de verkeerde map verwijst.

Veelvoorkomende oorzaken zijn:

• Onjuiste bestandsrechten
• Verkeerd Nginx hoofdpad
• Ontbrekende toegangsrechten
• Onjuiste eigendomsinstellingen

Zorg ervoor dat de hoofdmap van Laravel naar de public- map verwijst:

root /var/www/project/public;

Machtigingen bijwerken:

sudo chown -R www-data:www-data /var/www/project
sudo chmod -R 775 storage
sudo chmod -R 775 bootstrap/cache

Herstart Nginx:

sudo systemctl restart nginx

2. 500 Interne serverfout

De 500 Internal Server Error is een van de meest voorkomende problemen bij de implementatie van Laravel. Dit duidt meestal op een configuratieprobleem aan de serverzijde.

Mogelijke oorzaken zijn:

• Onjuiste .env-configuratie
• Vermist PHP extensies
• Ongeldige bestandsrechten
• Syntaxisfouten
• Afhankelijkheidsproblemen
• PHP versie-incompatibiliteit

Controleer de Laravel-logbestanden:

tail -f storage/logs/laravel.log

Check Nginx stammen:

sudo tail -f /var/log/nginx/error.log

Check PHP stammen:

sudo tail -f /var/log/php8.2-fpm.log

Door logbestanden te lezen, wordt het exacte probleem meestal veel sneller vastgesteld dan door te gissen.

3. Databaseverbindingsfout

Laravel kan mogelijk geen verbinding maken als de database-instellingen in het .env-bestand onjuist zijn.

Controleer het volgende zorgvuldig:

• Database naam
• Gebruikersnaam database
• Database wachtwoord
• Databasehost
• Databasepoort
• MySQL service status

Controleer de databaseservice:

sudo systemctl status mysql

Herstart MySQL:

sudo systemctl restart mysql

Voorbeeld van een databaseconfiguratie:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravelapp
DB_USERNAME=laraveluser
DB_PASSWORD=StrongPassword

4. Composer-afhankelijkheidsfout

Composer-fouten treden meestal op wanneer afhankelijkheden ontbreken of PHP De versies voldoen niet aan de pakketvereisten.

Mogelijke oorzaken:

• Ontbrekende Composer-pakketten
• niet gesteund PHP versie
• Beschadigde leveranciersbestanden
• Afhankelijkheidsconflicten

Probeer de afhankelijkheden opnieuw te installeren:

composer install

Of wis de Composer-cache:

composer clear-cache

5. Route niet gevonden-fout

Soms werken routes lokaal wel, maar niet meer na de implementatie.

Mogelijke oorzaken:

• Route cache probleem
• Ontbrekende routebestanden
• Onjuiste implementatie-updates

Routecache wissen:

php artisan route:clear
php artisan route:cache

6. Foutmelding 'Toegang geweigerd'

Laravel vereist schrijftoegang tot specifieke mappen.

Mappen die doorgaans worden beïnvloed:

• mediaopslag
• bootstrap/cache

Machtigingen herstellen:

sudo chown -R www-data:www-data /var/www/project
sudo chmod -R 775 storage
sudo chmod -R 775 bootstrap/cache

Door stap voor stap de logbestanden te controleren en configuratieproblemen op te lossen, worden de meeste problemen met de implementatie van Laravel op een VPS doorgaans snel verholpen.

Beveiligingsrichtlijnen voor Laravel VPS

Het succesvol implementeren van Laravel is slechts een deel van het proces. Het beveiligen van je applicatie na de implementatie is net zo belangrijk, omdat productieservers continu worden blootgesteld aan internetverkeer, geautomatiseerde bots, inlogpogingen en potentiële beveiligingsrisico's. Een kleine configuratiefout kan soms later tot ernstige kwetsbaarheden leiden.

Door een paar belangrijke beveiligingsmaatregelen te volgen, bescherm je je Laravel-applicatie, serverbronnen en gevoelige gebruikersgegevens.

1. Root uitschakelen SSH Inloggen

Het root-account gebruiken voor de dagelijkse server. manageDit verhoogt de beveiligingsrisico's omdat root onbeperkte toegang heeft tot de hele server.

In plaats daarvan:

• Maak een aparte sudo-gebruiker aan.
• Directe root-aanmelding uitschakelen
• Gebruik accounts met beperkte toegang

Edit SSH configuratie:

sudo nano /etc/ssh/sshd_config

Zoek:

PermitRootLogin yes

Wijzigen naar:

PermitRootLogin no

Herstart SSH:

sudo systemctl restart ssh

2. Gebruiken SSH Inloggen met sleutels in plaats van wachtwoorden

SSH Sleutels zijn over het algemeen veiliger dan wachtwoorden, omdat ze het risico op brute-force-aanvallen verkleinen.

Genereer een SSH sleutel lokaal:

ssh-keygen

Kopieer de sleutel naar de server:

ssh-copy-id username@server-ip

Voordelen zijn onder andere:

• Betere beveiliging
• Snellere authenticatie
• Minder wachtwoordaanvallen

3. Firewallbeveiliging configureren

Een firewall helpt bij het controleren van inkomend en uitgaand serververkeer.

Ubuntu maakt doorgaans gebruik van UFW (Uncomplicated Firewall).

Schakel de vereiste services in:

sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable

Status controleren:

sudo ufw status

Dit helpt onnodige verbindingen te blokkeren en het risico op aanvallen te verminderen.

4. Zorg ervoor dat de serverpakketten up-to-date zijn.

Verouderde software bevat vaak beveiligingslekken en bugs.

Regelmatig bijwerken:

• Ubuntu-pakketten
• PHP
• Componist
• Laravel-afhankelijkheden
• Database-diensten

Run:

sudo apt update
sudo apt upgrade -y

Door software up-to-date te houden, worden zowel de beveiliging als de serverstabiliteit verbeterd.

5. Bescherm uw .env-bestand

Laravel slaat gevoelige informatie op in het .env-bestand, waaronder:

• Database-inloggegevens
• API-sleutels
• E-mailinstellingen
• Applicatiegeheimen

Het .env-bestand mag nooit publiekelijk toegankelijk zijn.

Stel de juiste machtigingen in:

sudo chmod 600 .env

Zorg er ook voor dat uw Nginx configuratie wijst alleen op:

root /var/www/project/public;

Dit voorkomt directe toegang tot gevoelige projectbestanden.

6. Automatische back-ups inschakelen

Backups helpen bij het herstellen van applicaties tijdens:

• Serverstoringen
• Configuratiefouten
• Database corruptie
• Per ongeluk verwijderen van bestanden

Belangrijke zaken om een ​​back-up van te maken:

• Laravel-projectbestanden
• Database
• Omgevingsbestanden
• Geüploade media

Regelmatige back-ups verminderen de uitvaltijd en vereenvoudigen het herstel.

7. Gebruik altijd HTTPS

HTTPS versleutelt de communicatie tussen uw website en gebruikers.

Voordelen zijn onder andere:

• Betere beveiliging
• Gebruikersvertrouwen
• Verbeterde SEO
• Beveiligde inloggegevens

Install SSL:

sudo certbot --nginx

8. Controleer de serverlogboeken regelmatig.

Serverlogboeken helpen bij het detecteren van ongebruikelijke activiteiten en het snel oplossen van problemen.

Nuttige logboeken zijn onder andere:

• Laravel-logboeken
• Nginx logs
• PHP logs
• Authenticatielogboeken

Controleer de Laravel-logbestanden:

tail -f storage/logs/laravel.log

Check Nginx stammen:

sudo tail -f /var/log/nginx/error.log

Een goede beveiliging van Laravel komt meestal voort uit consistente monitoring, een juiste serverconfiguratie, beperkte toegangsrechten en het regelmatig bijwerken van de software.

Veelgestelde vragen

Conclusie

Het implementeren van een Laravel-applicatie op een VPS kan in eerste instantie technisch lijken, vooral als je dingen ziet zoals SSH Toegang, serverconfiguraties, machtigingen en beveiligingsinstellingen worden gecombineerd. Zodra u het doel van elke stap begrijpt, wordt het proces veel eenvoudiger en efficiënter. managekunnen.

Een succesvolle Laravel-implementatie draait niet alleen om het live zetten van je applicatie. Het omvat ook het creëren van een veilige, geoptimaliseerde en schaalbare omgeving die toekomstige updates, verkeersgroei en prestatie-eisen op de lange termijn probleemloos aankan.

Na de implementatie is het belangrijk om je server te blijven monitoren, pakketten regelmatig bij te werken, de beveiligingsinstellingen te verbeteren en back-ups paraat te houden. Een correct geconfigureerde Laravel VPS-omgeving kan alles ondersteunen, van kleine projecten tot grote productieapplicaties met een groeiend aantal gebruikers en verkeer.