OctoberCMS installeren en configureren in de ServBay-omgeving

Overzicht

OctoberCMS is een open-source contentmanagementsysteem (CMS) dat gebouwd is op het krachtige Laravel-framework. Dankzij zijn eenvoud, flexibiliteit en ontwikkelaarsvriendelijke eigenschappen is het zeer geliefd. Dit document begeleidt je bij het succesvol installeren en configureren van OctoberCMS binnen ServBay — een alles-in-één lokale webontwikkelomgeving voor macOS — zodat je snel kunt starten met het bouwen van projecten op basis van OctoberCMS.

Wat is OctoberCMS?

OctoberCMS biedt een intuïtieve backend-interface en krachtige frontend-features, waarmee ontwikkelaars met bekende Laravel-concepten (zoals Eloquent ORM en de Blade template engine) uiteenlopende websites kunnen bouwen — van simpele blogs tot complexe bedrijfsapplicaties.

Vereisten

Voordat je begint met de installatie van OctoberCMS, controleer of je aan deze voorwaarden voldoet:

1. ServBay is geïnstalleerd en actief op je macOS-systeem.
2. De pakketten PHP (aanbevolen: 7.4 of nieuwer) en MySQL/MariaDB zijn in ServBay ingeschakeld en draaien.
3. Het Composer-pakket is in ServBay ingeschakeld.
4. Je beschikt over basiskennis van werken met de commandoregel.

Stappen om OctoberCMS te installeren

Hieronder vind je de gedetailleerde stappen voor het installeren en configureren van OctoberCMS binnen ServBay:

Stap 1: Maak een projectmap aan

Navigeer eerst naar de aanbevolen webroot van ServBay: /Applications/ServBay/www en maak hier een nieuwe map aan voor je OctoberCMS-project.

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

Stap 2: Installeer OctoberCMS met Composer

Composer is reeds geïnstalleerd en geconfigureerd binnen ServBay. Controleer of Composer is ingeschakeld via het ServBay-configuratiescherm. Voer vervolgens in je nieuw aangemaakte projectmap het volgende Composer-commando uit om de kernbestanden van OctoberCMS te downloaden en installeren:

composer create-project october/october .

Dit commando downloadt de laatste versie van OctoberCMS vanuit de officiële repository naar de huidige map (.).

Stap 3: Maak een database en gebruiker aan

OctoberCMS heeft een database nodig om content, gebruikers en configuraties op te slaan. Gebruik phpMyAdmin, dat standaard bij ServBay inbegrepen is, om de database en gebruiker aan te maken.

1. Ga naar de ingebouwde phpMyAdmin-databasebeheerder van ServBay

   Open je browser en ga naar het lokale ontwikkelportaal van ServBay: https://servbay.host/. Klik op of navigeer naar de phpMyAdmin-link, meestal https://servbay.host/phpmyadmin/, om phpMyAdmin te openen.

2. Maak een databasegebruiker aan

   Voor veiligheid en isolatie wordt aangeraden voor iedere applicatie een aparte database en gebruiker aan te maken.

   1. Open de gebruikersaccounts-pagina

      Klik in het hoofdmenu van phpMyAdmin op "Gebruikersaccounts".

   2. Voeg een nieuwe gebruiker toe

      Klik op "Voeg gebruiker toe" en vul het volgende in:

      • Gebruikersnaam: Kies een gebruikersnaam voor de verbinding met OctoberCMS, bijvoorbeeld october_user.
      • Hostnaam: Selecteer localhost of 127.0.0.1. Dit zorgt ervoor dat de gebruiker alleen lokaal verbinding kan maken, wat de veiligheid verhoogt.
      • Wachtwoord: Kies een sterk, uniek wachtwoord. Gebruik het voorbeeldwachtwoord password123 nooit in productie!
      • Herhaal wachtwoord: Voer nogmaals je gekozen wachtwoord in.
      • Onder "Database voor gebruiker aanmaken", kies "Maak een database aan met gelijke naam en ken alle rechten toe". Hierdoor wordt er automatisch een database october_user aangemaakt met alle rechten voor deze gebruiker.
      • Zorg dat "Alle rechten toekennen" onder "Globale rechten" is aangevinkt (meestal automatisch geregeld als je bovengenoemde optie kiest).
      • Klik onderaan op "OK" of "Uitvoeren" om het aanmaken van de gebruiker en database af te ronden.

Stap 4: Configureer de webserver (website toevoegen in ServBay)

Om toegang te krijgen tot je OctoberCMS-applicatie via de browser, voeg je een lokale site toe binnen ServBay.

1. Voeg een nieuwe website toe

   Open het ServBay-configuratiescherm, klik links op "Websites" (sommige oudere versies tonen "Hosts"). Klik op de knop "Website toevoegen".

   Vul in:

   • Naam: Geef de website een herkenbare naam, zoals My OctoberCMS Site.
   • Domein: Voer het gewenste lokale domein in, zoals servbay-octobercms.local. Gebruik bij voorkeur de .local extensie om conflicten met echte domeinen te voorkomen.
   • Websitetype: Kies PHP.
   • PHP-versie: Selecteer de PHP-versie die OctoberCMS nodig heeft en die je in ServBay hebt ingeschakeld.
   • Webroot: Blader naar de eerder aangemaakte projectmap: /Applications/ServBay/www/servbay-octobercms-app.

2. Sla de configuratie op en herstart ServBay

   Nadat je alles hebt ingevuld, klik op "Opslaan". ServBay vraagt om de wijzigingen toe te passen, wat meestal betekent dat je Caddy of Nginx en ServBay zelf opnieuw moet starten. Volg de instructies om de wijzigingen te activeren. Daarna wijst ServBay het domein servbay-octobercms.local automatisch toe aan je lokale machine (127.0.0.1).

Stap 5: Configureer de OctoberCMS-omgevingsvariabelen

OctoberCMS (op basis van Laravel) gebruikt een .env-bestand om de omgevingsvariabelen te beheren, waaronder de databaseverbinding en de app-sleutel.

1. Kopieer het standaardconfiguratiebestand

   Ga naar de hoofdmap van je project (/Applications/ServBay/www/servbay-octobercms-app) en kopieer .env.example naar .env:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. Bewerk het .env-bestand

   Open het .env-bestand in je favoriete teksteditor en pas de database-instellingen aan naar aanleiding van de gegevens die je in stap 3 hebt aangemaakt:

   # ... andere instellingen ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # Vervang dit door jouw database naam
   DB_USERNAME=october_user  # Vervang dit door jouw database gebruiker
   DB_PASSWORD=password123   # Vervang dit door het ingestelde wachtwoord
   
   # ... andere instellingen ...

   Belangrijk: Zorg dat DB_DATABASE, DB_USERNAME en DB_PASSWORD overeenkomen met de daadwerkelijk aangemaakte gegevens in stap 3.

Stap 6: Start de OctoberCMS-installatie

OctoberCMS biedt een webgebaseerde installatiewizard voor de laatste instellingen, database-migraties en het aanmaken van een admin-account.

1. Open de installatiepagina

   Open je browser en ga naar het lokale domein dat je in stap 4 hebt ingesteld, met /install.php achter het domein, bijvoorbeeld:

   https://servbay-octobercms.local/install.php

   Je zou nu de installatiewizard van OctoberCMS moeten zien.

2. Vul de databasegegevens in

   De wizard vraagt om database-instellingen. Vul hier exact dezelfde informatie in als je eerder in het .env-bestand hebt gezet:

   • Databasetype: MySQL
   • Database host: localhost of 127.0.0.1
   • Databasenaam: october_user
   • Gebruikersnaam database: october_user
   • Databasewachtwoord: password123

   (Gebruik uiteraard het daadwerkelijke, door jou gekozen wachtwoord)

3. Voer de beheerdergegevens in

   Vul de gewenste admin-accountgegevens in, zoals gebruikersnaam, wachtwoord en e-mailadres, voor toegang tot het backend van OctoberCMS.

4. Rond de installatie af

   Klik op "Installeren" of de overeenkomstige knop. De wizard zal de database migreren, een applicatiesleutel genereren, enzovoort. Wacht tot de installatie is voltooid.

Stap 7: Plugins en thema’s installeren (optioneel)

Na de installatie kun je inloggen op het beheergedeelte van OctoberCMS (https://servbay-octobercms.local/backend).

1. Plugins installeren

   Navigeer in het beheer naar "Systeem" -> "Updates" -> "Plugins". Hier kun je zoeken naar plugins uit de OctoberCMS Marketplace om je website uit te breiden.

2. Thema’s installeren

   Ga naar "Systeem" -> "Updates" -> "Thema’s" en kies uit de beschikbare thema’s wat het beste bij je project past.

Basisconfiguratie en gebruik na installatie

Na succesvolle installatie van OctoberCMS kun je aan de slag met het bouwen van je site. Dit zijn enkele veelvoorkomende eerste stappen:

• Frontend bekijken: Ga naar je lokale domein https://servbay-octobercms.local/ om de publieke site te zien (standaardthema).
• Backend openen: Navigeer naar https://servbay-octobercms.local/backend en log in met je admin-account dat je tijdens de installatie hebt aangemaakt.
• Pagina maken: In het backend ga je naar "CMS" -> "Pagina’s" om nieuwe pagina’s toe te voegen of te bewerken.
• Contentblokken aanmaken: Onder "CMS" -> "Inhoud" kun je herbruikbare contentfragmenten aanmaken.
• Thema instellen: Onder "CMS" -> "Thema’s" stel je het huidige thema, layouts, partials en meer in.
• Gebruikers en rechten beheren: Onder "Systeem" -> "Beheer" beheer je backend-gebruikers en hun rechten.

Veelgestelde vragen (FAQ)

• Vraag: De pagina servbay-octobercms.local toont de ServBay-defaultpagina of een foutmelding?
  • Antwoord: Controleer of je binnen het ServBay-configuratiescherm de website servbay-octobercms.local hebt toegevoegd en of de webroot correct verwijst naar /Applications/ServBay/www/servbay-octobercms-app. Zorg ervoor dat de benodigde pakketten herstart zijn zodat wijzigingen effect hebben. Check of Caddy/Nginx en PHP in ServBay draaien.
• Vraag: https://servbay-octobercms.local/install.php geeft een blanco pagina of foutmelding?
  • Antwoord: Dit is meestal een PHP-fout. Bekijk het PHP-errorlog in het ServBay-configuratiescherm. Mogelijke oorzaken: verkeerde bestandsrechten (zorg dat storage, themes en plugins en submappen beschrijfbaar zijn door de webserver), ongeschikte PHP-versie of ontbrekende extensies.
• Vraag: Databaseconnectiefout tijdens installatie?
  • Antwoord: Controleer zorgvuldig de databasegegevens in je .env-bestand (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) en zorg dat deze overeenkomen met wat je in phpMyAdmin hebt aangemaakt. Controleer of het MySQL/MariaDB-pakket in ServBay actief is.
• Vraag: Het commando composer create-project werkt niet?
  • Antwoord: Zorg dat Composer is ingeschakeld in het ServBay-configuratiescherm, evenals het juiste PHP-pakket. Controleer je netwerkverbinding, omdat Composer bestanden moet kunnen downloaden.

Samenvatting

Dankzij ServBay kun je snel en eenvoudig OctoberCMS installeren en configureren op macOS. Door de stappen uit deze handleiding te volgen, bouw je vliegensvlug een krachtige, ontwikkelaarsvriendelijke lokale ontwikkelomgeving voor je volgende webproject. Duik nu in de uitgebreide mogelijkheden van OctoberCMS en bouw indrukwekkende websites!