ExpressionEngine CMS installeren en configureren in de lokale ServBay-omgeving

Overzicht

ExpressionEngine is een krachtig en flexibel contentmanagementsysteem (CMS) dat veel wordt gebruikt voor het bouwen van allerlei soorten complexe websites en webapplicaties. Het biedt een rijke set aan kernfunctionaliteiten en een sterk modulaire architectuur, waarmee ontwikkelaars en ontwerpers websites flexibel kunnen maken en aanpassen.

ServBay is een lokale webontwikkelomgeving die speciaal is ontworpen voor macOS. Het biedt een alles-in-één oplossing die populaire webservers (zoals Nginx, Caddy, Apache), programmeertaal-runtimes (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), databases (MySQL, PostgreSQL, MongoDB, Redis) en ontwikkelaarstools (Composer, npm/yarn, phpMyAdmin/Adminer) integreert. Met ServBay kunnen ontwikkelaars eenvoudig hun lokale ontwikkelomgeving opzetten en beheren.

In dit artikel lees je stap voor stap hoe je ExpressionEngine in ServBay installeert en configureert, zodat je snel een ExpressionEngine-project kunt starten.

Waarom ExpressionEngine installeren met ServBay?

ExpressionEngine lokaal installeren met ServBay biedt de volgende voordelen:

• Geïntegreerde omgeving: ServBay bevat alle vereiste componenten voor ExpressionEngine, zoals PHP, MySQL en een webserver. Losse installatie en configuratie is niet nodig.
• Ondersteuning voor meerdere versies: Je kunt eenvoudig wisselen tussen verschillende PHP-versies in ServBay, afhankelijk van de eisen van jouw versie van ExpressionEngine.
• Makkelijk databasebeheer: ServBay bevat standaard phpMyAdmin of Adminer, zodat je zonder moeite de benodigde database voor ExpressionEngine aanmaakt en beheert.
• Eenvoudige siteconfiguratie: Via de grafische interface van ServBay kun je snel een lokale website aanmaken die verwijst naar de projectmap van ExpressionEngine.
• Isolatie en beheer: ServBay stelt je in staat voor elk project een aparte siteconfiguratie aan te maken, waardoor conflicten tussen verschillende projecten worden voorkomen.

Vereisten

Voordat je begint met installeren, controleer je of je aan de volgende voorwaarden voldoet:

1. ServBay is al geïnstalleerd en draait op je macOS-systeem. Nog niet geïnstalleerd? Ga dan naar de officiële ServBay website voor instructies.
2. Je hebt basiskennis van het werken met de terminal/commandline.
3. Je kent de basisprincipes van databases (zoals databases en gebruikers).
4. Je hebt schrijfrechten op de standaard webroot van ServBay: /Applications/ServBay/www.

Installatiestappen

We nemen de volgende stappen om ExpressionEngine in ServBay te installeren en te configureren.

Stap 1: Projectmap voorbereiden en ExpressionEngine downloaden

Open eerst je terminal. Navigeer naar de standaard webroot van ServBay (/Applications/ServBay/www), maak een nieuwe projectmap aan (bijvoorbeeld servbay-ee-app), en ga deze map binnen.

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

Gebruik nu het curl-commando om de nieuwste versie van ExpressionEngine te downloaden naar de huidige map. De -L-optie volgt redirects, de -o-optie geeft de bestandsnaam op.

curl -L https://expressionengine.com/latest -o expressionengine.zip

Stap 2: ExpressionEngine-bestanden uitpakken

Na het downloaden pak je het bestand expressionengine.zip uit met het unzip-commando in de map servbay-ee-app. Verwijder daarna het zipbestand.

unzip expressionengine.zip
rm expressionengine.zip

Na het uitpakken zijn de ExpressionEngine-bestanden te vinden in de map servbay-ee-app.

Stap 3: Database en gebruiker voor ExpressionEngine aanmaken

Voor het opslaan van content en instellingen heeft ExpressionEngine een database nodig. ServBay biedt standaard MySQL en phpMyAdmin voor eenvoudige databasebeheer.

1. Open phpMyAdmin in ServBay

   Start je webbrowser en ga naar de lokale toolpagina van ServBay: https://servbay.host/. Zoek daar de link naar "phpMyAdmin" en klik erop. Je belandt dan op de inlogpagina van phpMyAdmin. Gebruik de standaardgegevens van ServBay (de standaardinstallatie vereist vaak geen wachtwoord voor 'localhost'; raadpleeg desnoods de ServBay-database-instellingen).

2. Aanmaken van de databasegebruiker en database

   Log in op phpMyAdmin en maak een aparte databasegebruiker en bijbehorende database aan voor ExpressionEngine.

   • Ga naar gebruikersaccounts: Klik in het hoofdmenu van phpMyAdmin op "Gebruikersaccounts".
   • Nieuwe gebruiker toevoegen: Klik op "Voeg gebruiker toe".
   • Vul gebruikers- en databasegegevens in:
     • Gebruikersnaam: Kies bijvoorbeeld ee_user als databasegebruikersnaam voor ExpressionEngine.
     • Hostnaam: Selecteer localhost. Zo kan de gebruiker alleen lokaal verbinden, wat extra veiligheid biedt.
     • Wachtwoord: Bedenk een sterk en veilig wachtwoord voor de databaseconnectie van ExpressionEngine. Onthoud hem goed. (Gebruik als demo bijvoorbeeld password123, maar gebruik in productie altijd een sterk wachtwoord.)
     • Opnieuw invoeren: Bevestig het wachtwoord door het nogmaals in te voeren.
     • Database voor gebruiker aanmaken: Vink “Maak een database aan met dezelfde naam en verleen alle rechten” aan. Daarmee maak je automatisch een database ee_user en krijgt deze gebruiker alle rechten op die database.
   • Controleer rechten: Controleer of bij de sectie “Globale rechten” geen onnodige rechten zijn aangevinkt. (Met de optie hierboven zijn alle nodige database-rechten al toegekend.)
   • Uitvoeren: Klik op “Uitvoeren” onderaan de pagina om de gebruiker en database aan te maken.

   Je hebt nu een database ee_user en een gebruiker ee_user die volledige rechten heeft op deze database.

Stap 4: Website instellen in ServBay

Nu gaan we ServBay vertellen hoe verzoeken voor een bepaald domein (zoals servbay-ee.local) naar jouw ExpressionEngine-projectmap moeten worden gestuurd.

1. Open ServBay en voeg een nieuwe site toe

   Start de grafische interface van de ServBay-app. Klik in de linker navigatiebalk op "Websites". Druk vervolgens bovenin op de “+” of "Toevoegen" knop om een nieuwe site in te stellen.

   • Naam: Geef je website een herkenbare naam, zoals My ExpressionEngine Site.
   • Domein: Kies een domeinnaam om lokaal de ExpressionEngine-site te bereiken, bijvoorbeeld servbay-ee.local. ServBay voegt deze domeinnaam automatisch toe aan je hosts-bestand (die verwijst naar 127.0.0.1).
   • Soort site: Kies PHP, want ExpressionEngine is op PHP gebaseerd.
   • PHP-versie: Selecteer de versie van PHP die past bij de vereisten van jouw ExpressionEngine-installatie. ServBay biedt meerdere PHP-versies waaruit je kunt kiezen.
   • Webroot (Document Root): Kies via de bladerknop de projectmap die je bij stap 1 hebt aangemaakt, namelijk /Applications/ServBay/www/servbay-ee-app.
   • Webserver: Kies één van de ondersteunde servers (Nginx, Caddy, Apache). ServBay genereert automatisch een passende configuratie. Voor lokale ontwikkeling voldoet de standaardoptie meestal.

2. Opslaan en toepassen van instellingen

   Vul alle gevraagde informatie in en klik op “Opslaan” of “Toepassen”. Mogelijk moet ServBay de webserver herstarten om de nieuwe instellingen in te laden; volg de instructies en wacht tot de herstart is voltooid.

   Vanaf nu wordt elk verzoek aan https://servbay-ee.local/ door ServBay doorgestuurd naar je ExpressionEngine-projectmap.

Stap 5: ExpressionEngine webinstaller uitvoeren

ExpressionEngine bevat een webinstaller die je door de laatste configuratiestappen leidt.

1. Open de installatiewizard

   Start je webbrowser en ga naar het ingestelde domein van je ServBay-site, gevolgd door het installatiebestand admin.php. Dit bestand is standaard te vinden op /admin.php.

   Te bezoeken adres: https://servbay-ee.local/admin.php

   Je ziet nu het welkomstscherm of de installatiewizard van ExpressionEngine.

2. Configuratie volgens de wizard

   De installatiewizard vraagt om enkele essentiële gegevens:

   • Database-instellingen:
     • Databasehost: localhost
     • Databasenaam: ee_user (zoals bij stap 3 aangemaakt)
     • Databasegebruikersnaam: ee_user
     • Databasewachtwoord: Vul hier het wachtwoord in dat je voor ee_user hebt gekozen.
   • Beheerdersaccount aanmaken: Kies gebruikersnaam, wachtwoord en e-mailadres voor de superadmin van ExpressionEngine. Gebruik hiervoor een sterk wachtwoord.
   • Siteconfiguratie: Vul sitenaam, URL en andere basisgegevens in.

3. Installatie afronden

   Controleer of alles correct is ingevuld en klik op “Installeren” (of vergelijkbare knop) in de wizard. ExpressionEngine maakt dan de benodigde tabellen aan en voltooit de eerste configuratie.

   Na voltooiing word je doorgaans doorgestuurd naar het login- of dashboard van de backend.

Stap 6: Basisconfiguratie na installatie

Na het installeren van de kern van ExpressionEngine kun je desgewenst plugins, templates en andere basisinstellingen toepassen.

1. Inloggen op de ExpressionEngine backend

   Log in met het beheerdersaccount dat je tijdens de installatie hebt aangemaakt. De standaardinlogpagina is te bereiken via https://servbay-ee.local/admin.php, waar je je gebruikersnaam en wachtwoord invoert.

2. Plugins installeren

   Binnen de backend ga je naar “Ontwikkelaar” -> “Add-Ons” -> “Plugins”. Hier kun je beschikbare plugins bekijken en installeren afhankelijk van je projectbehoeften.

3. Templates installeren en configureren

   Ga in het menu naar “Ontwerp” -> “Templates”. Je kunt daar groepen en individuele templates aanmaken, en HTML/CSS/EE-code schrijven voor de presentatie van je website-inhoud.

Je website bouwen met ExpressionEngine

Nu je ExpressionEngine succesvol met ServBay hebt opgezet, kun je beginnen met het bouwen en beheren van je website-inhoud. Enkele veelvoorkomende eerste stappen:

Kanalen en items aanmaken

De kern van ExpressionEngine bestaat uit “kanalen” en “items”. Kanalen bepalen het type en de structuur van je content; items zijn de daadwerkelijke contentstukjes.

1. Kanaal aanmaken: Ga in de backend naar “Contentstructuur” -> “Kanalen”. Klik op “Nieuw kanaal aanmaken”, vul de kanaalnaam en teams van velden (Fields Group) in, en sla het kanaal op.
2. Item aanmaken: Navigeer naar “Content” -> “Publiceren”. Kies een eerder aangemaakt kanaal, vul de titel, inhoud en andere gegevens in (volgens de kanaalvelden), en sla het item op.

Navigatiemenu instellen

Navigatiemenu’s maak je doorgaans via templates.

1. Maak of bewerk een template: Ga naar “Ontwerp” -> “Templates” en maak bijvoorbeeld een nieuwe nav-template in de groep site.
2. Schrijf navigatiecode: Gebruik ExpressionEngine-template-tags in de template om kanaalitems of pagina’s op te halen en de HTML-navigatiestructuur te genereren.
3. Navigatie opnemen in layouts: Voeg je navigatietemplate toe aan je hoofdlay-out, bijvoorbeeld via {% include 'site:nav' %} (bij gebruik van Blade) of een andere geschikte tag.

Widgets/zijbalken aanpassen

Net als het navigatiemenu kun je zijbalken en andere “widgets” via dedicated templates realiseren.

1. Maak een widgettemplate aan: In “Ontwerp” -> “Templates” kun je bijvoorbeeld een site:sidebar-template aanmaken.
2. Schrijf widgetcode: Voeg code toe om recente items, categorieën, advertenties of voorraad aan de template toe te voegen.
3. Widget opnemen in layouts: Voeg de widgettemplate toe waar deze zichtbaar moet zijn in jouw layout.

Veelgestelde vragen (FAQ)

• Vraag: Ik krijg een foutmelding over rechten als ik https://servbay-ee.local/ bezoek. Wat nu?
  • Antwoord: Controleer de rechten van je ExpressionEngine-projectmap (/Applications/ServBay/www/servbay-ee-app) en alle submappen en bestanden. Zorg dat de ServBay-gebruiker (meestal jijzelf) lees- en schrijfrechten heeft. Pas indien nodig de rechten aan via chmod of chown, bijvoorbeeld: sudo chown -R jouwgebruikersnaam:jouwgroep /Applications/ServBay/www/servbay-ee-app.
• Vraag: Waarom kan de ExpressionEngine-installatiewizard geen verbinding maken met de database?
  • Antwoord: Controleer goed of de ingevulde databasegegevens (host: localhost, naam, gebruikersnaam, wachtwoord) exact overeenkomen met wat je bij phpMyAdmin hebt aangemaakt. Zorg ook dat de MySQL/MariaDB-dienst binnen ServBay actief is.
• Vraag: Kan ik ook andere databases van ServBay, zoals PostgreSQL, gebruiken?
  • Antwoord: ExpressionEngine ondersteunt voornamelijk MySQL/MariaDB. Alleen als ExpressionEngine officieel PostgreSQL ondersteunt en je beschikking hebt over de juiste drivers en configuratie, is de PostgreSQL-dienst van ServBay inzetbaar. Raadpleeg de officiële documentatie van ExpressionEngine voor databasecompatibiliteit.

Samenvatting

Als je alle bovenstaande stappen hebt gevolgd, heb je nu succesvol ExpressionEngine CMS geïnstalleerd en geconfigureerd in je lokale ServBay-ontwikkelomgeving. ServBay biedt een eenvoudige, efficiënte omgeving met alle benodigde onderdelen voor lokale ExpressionEngine-ontwikkeling. Je kunt nu profiteren van de krachtige mogelijkheden van ExpressionEngine om je website of webapplicatie te bouwen. Veel succes met ontwikkelen!