Craft CMS Installeren en Configureren in de ServBay-omgeving

Overzicht

Craft CMS is een krachtig contentmanagementsysteem (CMS), geliefd bij ontwikkelaars vanwege zijn flexibele contentmodellering, intuïtieve gebruikersinterface en ontwikkelaarsvriendelijke eigenschappen. Het is uitermate geschikt voor het bouwen van complexe en op maat gemaakte websites.

Het gebruiken van ServBay als lokale ontwikkelomgeving voor Craft CMS heeft vele voordelen. Denk aan vooraf geconfigureerde PHP, databases (zoals MySQL of PostgreSQL) en webservers (Caddy of Nginx), plus een ingebouwde Composer en commandoregeltools, waarmee het installatie- en configuratieproces flink wordt vereenvoudigd.

In deze handleiding leggen we stap voor stap uit hoe je een Craft CMS-project in ServBay installeert en configureert.

Vereisten

Zorg ervoor dat je over het volgende beschikt voordat je begint:

1. ServBay is geïnstalleerd en actief: Zorg dat je ServBay succesvol op macOS hebt geïnstalleerd met de benodigde PHP-versie (raadpleeg de officiële documentatie van Craft CMS voor de juiste versies) en databasesoftware (meestal MySQL of PostgreSQL). ServBay ondersteunt meerdere PHP-versies en databases; je kunt eenvoudig wisselen en configureren wat nodig is.
2. Basiskennis van de commandoregel: Je zult opdrachten in de terminal moeten uitvoeren, zoals het aanmaken van mappen en het werken met Composer.
3. Kennis van Composer: Craft CMS beheert afhankelijkheden via Composer. ServBay heeft Composer ingebouwd—je moet weten hoe je het composer create-project-commando gebruikt.

Stappen voor het Installeren van Craft CMS

Hieronder vind je de specifieke stappen om Craft CMS te installeren en te configureren binnen ServBay.

Stap 1: Maak een Projectmap aan

Maak eerst een nieuwe projectmap aan in de standaard website-rootdirectory van ServBay: /Applications/ServBay/www. ServBay configureert deze map standaard als de hoofdservice-map voor de webserver, zodat je hier direct projecten kunt benaderen.

Open de terminal en voer de volgende commando’s uit:

cd /Applications/ServBay/www
mkdir servbay-craft-app
cd servbay-craft-app

Dit maakt een nieuwe map servbay-craft-app aan binnen /Applications/ServBay/www en navigeert ernaartoe.

Stap 2: Maak een Craft CMS-project aan met Composer

Omdat ServBay Composer ingebouwd heeft, kun je direct in je projectmap Composer gebruiken om een Craft CMS-project aan te maken. De officiële documentatie raadt installatie via Composer aan.

Voer in de map servbay-craft-app dit commando uit:

composer create-project craftcms/craft .

Dit downloadt de nieuwste versie van Craft CMS en alle bijbehorende afhankelijkheden in de huidige map (.). Wacht tot Composer het downloaden en installeren heeft afgerond.

Stap 3: Maak een database en gebruiker aan

Craft CMS heeft een database nodig voor content en configuratie. Gebruik de ingebouwde tools phpMyAdmin of Adminer in ServBay om een database en gebruiker aan te maken. In dit voorbeeld gebruiken we phpMyAdmin.

1. Open de ServBay databasebeheer-tool (phpMyAdmin):

   Start je browser en ga naar het lokale ServBay-paneel via https://servbay.host/. Klik op de link "phpMyAdmin" om het databasebeheerpaneel te openen.

   Tip: De standaard phpMyAdmin-gebruiker in ServBay is gewoonlijk root met het standaardwachtwoord ServBay.dev. Voor de zekerheid kun je na het inloggen het root-wachtwoord wijzigen of een nieuwe beheerder aanmaken.

2. Maak een databasegebruiker aan:

   Hoewel je met de root-gebruiker kunt verbinden, is het uit oogpunt van veiligheid en machtigingen het beste om per applicatie een aparte gebruiker aan te maken.

   1. Navigeer naar Gebruikersaccounts

      Klik op het tabblad "Gebruikersaccounts" bovenaan op het hoofdscherm van phpMyAdmin.

   2. Voeg een nieuw gebruikersaccount toe

      Klik op "Gebruikersaccount toevoegen" en vul het volgende in:

      • Gebruikersnaam: kies bijvoorbeeld craft_user voor je Craft CMS databaseverbinding.
      • Hostnaam: selecteer localhost of Local, zodat deze gebruiker alleen lokaal verbinding kan maken.
      • Wachtwoord: kies een veilig wachtwoord. Gebruik nooit het voorbeeld password123, zeker niet in productie! Voor lokaal testen kun je een eenvoudiger wachtwoord gebruiken, maar houd altijd rekening met veiligheid.
      • Opnieuw invoeren: vul het wachtwoord ter bevestiging nogmaals in.
      • In het gedeelte "Database voor gebruiker aanmaken" kun je "Maak een database met dezelfde naam en geef alle rechten" selecteren. Hiermee wordt automatisch een database craft_user aangemaakt met volledige rechten voor de gebruiker craft_user.
      • Vink "Geef alle rechten" aan.
      • Klik onderaan op "Uitvoeren".

   Nu is er een databasegebruiker craft_user met een bijbehorende database craft_user en de juiste machtigingen.

Stap 4: Webserver configureren (Maak een website aan in ServBay)

Om de ServBay-webserver (Caddy of Nginx) jouw Craft CMS-project te laten bedienen, moet je een nieuwe website configureren in ServBay.

1. Open de ServBay-app

   Start ServBay op.

2. Voeg een nieuwe website toe

   Klik op het tabblad "Website" in de navigatiekolom links (let op: in oudere versies staat hier mogelijk "Host"). Voeg een nieuwe site toe door op het "+"-icoon te klikken of de knop "Website toevoegen" aan de rechterzijde.

   Vul het volgende in:

   • Naam: Geef je site een herkenbare naam, zoals My Craft Site.
   • Domeinen: Geef het domein waarmee je lokaal wilt testen, bijvoorbeeld servbay-craft.local. ServBay regelt automatisch de lokale DNS-instelling voor dit domein.
   • Type: Kies PHP.
   • PHP-versie: Selecteer de versie die je bij de voorbereiding gecontroleerd hebt en die door Craft CMS wordt ondersteund. ServBay ondersteunt meerdere PHP-versies tegelijkertijd.
   • Website root: Cruciaal, want de publiek toegankelijke bestanden (zoals index.php) van Craft CMS staan in de submap web van je project. Voor de veiligheid wijst de root van de webserver altijd naar deze web-map, niet naar de projectroot. Vul dus in: /Applications/ServBay/www/servbay-craft-app/web Zorg dat het pad klopt en verwijst naar de juiste map die je bij stap 1 hebt aangemaakt.

3. Configuratie opslaan

   Na het invullen, klik op "Opslaan". ServBay laadt nu de webserverconfiguratie opnieuw zodat je nieuwe instellingen actief zijn. In de site-lijst van ServBay zie je nu de net toegevoegde servbay-craft.local-website.

Stap 5: Start de Craft CMS Installatiewizard

Je kunt nu via de browser de installatiewizard van Craft CMS starten via het gekozen domein.

1. Bezoek de installatiepagina

   Ga in je browser naar https://servbay-craft.local/. Craft CMS merkt dat het nog niet is geïnstalleerd en zal je automatisch doorsturen naar de installatiepagina, meestal https://servbay-craft.local/index.php?p=admin/install.

2. Vul de databasegegevens in

   Op het Craft CMS-installatieformulier, bij het databasegedeelte, voer je de gegevens in die je bij stap 3 hebt aangemaakt:

   • Database server: localhost
   • Database naam: craft_user (of de naam die je gekozen hebt)
   • Gebruikersnaam: craft_user (of jouw gekozen gebruikersnaam)
   • Wachtwoord: Het wachtwoord dat je voor craft_user hebt ingesteld

   Klik op "Doorgaan". Craft CMS probeert nu te verbinden; lukt dat, dan ga je door naar de volgende stap.

3. Maak een beheerdersaccount aan

   Volg de instructies om een Craft CMS-beheerdersaccount aan te maken. Kies je gebruikersnaam, wachtwoord en e-mailadres. Gebruik een sterk wachtwoord.

   Klik op "Doorgaan".

4. Website-instellingen

   Vul de naam van je website en eventuele basisinformatie in.

   Klik tot slot op "Installatie afronden (Finish Up)". Craft CMS rondt nu de installatie af, maakt de benodigde database-tabellen aan en genereert de configuratiebestanden.

   Na voltooiing word je doorgestuurd naar het Craft CMS-beheerpaneel.

Stap 6: Eerste configuratie & verkenning

Log in op het Craft CMS-beheerpaneel en verken of stel het volgende in:

1. Controleer het .env-bestand: Craft CMS gebruikt .env voor het beheer van omgevingsvariabelen, inclusief databasegegevens. Dit bestand wordt automatisch aangemaakt en je vindt het in de projectroot (servbay-craft-app/). Je kunt hier bijvoorbeeld CRAFT_ENVIRONMENT op dev zetten.
2. Plugins installeren: Ga in het beheerpaneel naar "Plugins" om beschikbare Craft CMS-plugins te zoeken, installeren of te beheren.
3. Contentstructuur opzetten: Verken het "Instellingen" gedeelte om je eigen velden, secties, categorieën en tags aan te maken en zo de gewenste contentstructuur te ontwerpen.
4. E-mail instellen: Wil je e-mails vanuit je lokale Craft CMS testen? Configureer in het .env-bestand of bij "Instellingen > E-mail" SMTP als mailmethode. Gebruik als serveradres localhost en de SMTP-poort van Mailpit/Mailhog (zoals vermeld in de ServBay-interface).

Veelgestelde vragen (FAQ)

• Vraag: Ik krijg een databasefout tijdens de installatie, wat nu?
  • Antwoord: Controleer zorgvuldig of je bij de Craft CMS installatiewizard exact dezelfde database-instellingen gebruikt (server, databasenaam, gebruikersnaam, wachtwoord) als eerder aangemaakt in phpMyAdmin. Controleer ook of de database (MySQL of PostgreSQL) daadwerkelijk draait in ServBay.
• Vraag: servbay-craft.local geeft een 404 of witte pagina?
  • Antwoord:
    • Controleer of de "website root" bij het aanmaken van de website in ServBay precies verwijst naar /Applications/ServBay/www/servbay-craft-app/web. Dit is een veelvoorkomende fout.
    • Kijk of de webserver (Caddy of Nginx) en PHP-diensten in ServBay actief zijn.
    • Controleer of de websiteconfiguratie voor servbay-craft.local in de ServBay-website-lijst is ingeschakeld.
• Vraag: Composer is traag of faalt tijdens het installeren van Craft CMS?
  • Antwoord: Mogelijk is er sprake van netwerkproblemen of een niet optimale Composer-mirror. Je kunt proberen een Nederlandse of Chinese Composer-mirror toe te voegen, zoals die van Aliyun of Packagist China.
• Vraag: Na installatie ontbreken stijlbestanden of werken afbeeldingen niet in het beheerpaneel of de frontend?
  • Antwoord: Dit is vaak een rechtenprobleem. Zorg dat de gebruiker waarmee ServBay werkt schrijfrechten heeft in mappen als storage en web/cpresources. Meestal regelt ServBay dit automatisch, maar als het nodig is kun je de rechten handmatig controleren of resetten.

Samenvatting

Als je bovenstaande stappen volgt, heb je Craft CMS succesvol geïnstalleerd én geconfigureerd in je lokale ServBay-ontwikkelomgeving. Dankzij de integratie van ServBay wordt het beheer van PHP-versies, database-instellingen en webserverconfiguratie een stuk eenvoudiger, zodat jij je volledig kunt richten op je Craft CMS-project. Nu kun je gebruikmaken van de krachtige contentmodellering van Craft CMS om direct aan je website of applicatie te bouwen.