Drupal installeren en configureren in de lokale ServBay-ontwikkelomgeving

Overzicht

Drupal is een krachtig, flexibel en uitbreidbaar open source content management systeem (CMS) en wordt op grote schaal gebruikt voor allerlei soorten websites, van persoonlijke blogs en kleine bedrijfswebsites tot grote bedrijfspoorten en complexe webapplicaties. Het biedt uitgebreide contentbeheerfuncties, gedetailleerde gebruikersrechten en een robuuste modulaire architectuur en is daarmee ideaal voor ontwikkelaars die veel maatwerk en hoge prestaties vereisen.

ServBay is een lokale webontwikkeltool speciaal ontworpen voor macOS, waarin populaire webservers (zoals Caddy, Nginx), verschillende programmeertaal-runtimes (zoals PHP, Node.js, Python, Go, Java), databases (zoals MySQL, PostgreSQL, MongoDB, Redis) en ontwikkeltools zoals Composer en npm zijn geïntegreerd. Door Drupal te installeren en te configureren binnen ServBay beschik je over een stabiel, gebruiksvriendelijk en compleet lokaal ontwikkelplatform.

In dit artikel wordt stapsgewijs uitgelegd hoe je Drupal installeert en configureert in de ServBay-omgeving, zodat je snel aan de slag kunt met een lokale Drupal-ontwikkelomgeving.

Vereisten

Zorg dat je aan de volgende voorwaarden voldoet voordat je met Drupal aan de slag gaat:

1. ServBay geïnstalleerd en actief: Controleer of ServBay succesvol op macOS is geïnstalleerd en het programma draait.
2. Basiskennis van ServBay: Weet hoe je via de ServBay-interface pakketten beheert, websites toevoegt en toegang krijgt tot ingebouwde tools zoals phpMyAdmin.
3. PHP en MySQL/MariaDB geïnstalleerd: ServBay bevat standaard verschillende PHP-versies en MySQL of MariaDB. Zorg dat de gewenste PHP-versie is ingeschakeld en dat de databaseservice actief is.
4. Composer geïnstalleerd: Composer is standaard geïntegreerd in ServBay. Dit is essentieel voor het beheren van de dependencies van moderne PHP-projecten. In deze gids gebruiken we Composer om het Drupal-project op te zetten.

Drupal installeren: stappenplan

Hieronder vind je een gedetailleerd stappenplan om Drupal te installeren en te configureren binnen ServBay.

Stap 1: Maak een projectmap aan

Maak eerst een aparte submap voor je Drupal-project in de webroot van ServBay op /Applications/ServBay/www.

Open de Terminal-applicatie en voer de volgende commando’s uit:

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

Hiermee wordt onder /Applications/ServBay/www een nieuwe map servbay-drupal-app aangemaakt en navigeer je direct naar deze map.

Stap 2: Maak een Drupal-project aan met Composer

Composer is al standaard in ServBay geïntegreerd, je hoeft dus geen aparte installatie uit te voeren. Het is de aanbevolen methode om met Composer je Drupal-project en afhankelijkheden te beheren.

Voer vanuit de zojuist aangemaakte servbay-drupal-app-map het volgende Composer-commando uit:

composer create-project drupal/recommended-project .

Dit commando maakt op basis van de drupal/recommended-project-template een nieuw Drupal-project in de huidige map (.). Composer downloadt automatisch de Drupal core-bestanden en alle benodigde afhankelijkheden. Dit kan even duren, afhankelijk van je internetsnelheid.

Let op: De drupal/recommended-project-template plaatst alle publiek toegankelijke bestanden (zoals index.php, CSS, JavaScript etc.) in een submap genaamd web. Deze projectstructuur is bij moderne Drupal-projecten standaard voor extra veiligheid.

Stap 3: Maak een database en gebruiker aan

Drupal heeft een database nodig voor het opslaan van content, configuratie en gebruikersdata. We gebruiken phpMyAdmin, dat al in ServBay is inbegrepen, om dit makkelijk te regelen.

1. Open phpMyAdmin van ServBay

   Start je webbrowser en ga naar het standaard dashboardadres van ServBay: https://servbay.host/. Zoek op de dashboardpagina het onderdeel “phpMyAdmin” (meestal onder “Tools” of “Database”) en klik op de link om phpMyAdmin te openen.

   servbay.host is een speciaal voor lokale ontwikkeling gereserveerde domeinnaam die verwijst naar het interne beheerpaneel van ServBay.

2. Maak een databasegebruiker aan

   Het is verstandig om voor je Drupal-project een aparte databasegebruiker aan te maken met eigen rechten.

   • Ga naar Gebruikersaccounts: Klik op het tabblad “Gebruikersaccounts” bovenaan in het hoofdmenu van phpMyAdmin.
   • Nieuwe gebruiker toevoegen: Klik op “Voeg gebruiker toe”.
   • Vul gebruikersgegevens in:
     • Gebruikersnaam: Kies een gewenste gebruikersnaam, bijvoorbeeld drupal_user.
     • Hostnaam: Selecteer of vul localhost in (alleen lokale verbindingen, verhoogt de veiligheid).
     • Wachtwoord: Kies een sterk wachtwoord. Gebruik GEEN zwak wachtwoord zoals password123 (enkel als voorbeeld hier); gebruik een wachtwoordgenerator voor meer veiligheid in de praktijk.
     • Herhaal wachtwoord: Voer het wachtwoord nogmaals in.
   • Databaserechten: Vink bij “Database voor gebruiker aanmaken” de optie “Maak een database met dezelfde naam en verleen alle rechten” aan. Dan wordt automatisch een database drupal_user aangemaakt en krijgt de gebruiker alle rechten op die database.
   • Globale rechten: Zet geen vinkje bij “Alle rechten toekennen” onder globale rechten (tenzij je precies weet wat je doet), alleen rechten op de eigen database zijn nodig.
   • Uitvoeren: Controleer alle gegevens en klik op de knop “Uitvoeren” rechtsonder.

   Nu is er een database drupal_user aangemaakt, plus een gelijknamige gebruiker die hierop alle rechten heeft.

Stap 4: Webserver configureren (Website toevoegen in ServBay)

Configureer een nieuwe site binnen ServBay, zodat een lokale domeinnaam verwijst naar de Drupal-web map van je project.

1. Open de ServBay UI: Start het ServBay-programma.
2. Website toevoegen: Klik op het tabblad “Websites” in het linkermenu.
3. Klik op de Toevoegen-knop: Klik op de “+”-knop onderaan om een nieuwe website te configureren.
4. Vul de websitegegevens in:
   • Naam: Kies een herkenbare naam, bijvoorbeeld My Drupal Site.
   • Domeinnaam: Vul de lokale domeinnaam in waarop je Drupal wilt benaderen, zoals servbay-drupal.local. ServBay ondersteunt .local-domeinen zonder aanpassing van het hosts-bestand.
   • Soort website: Kies PHP.
   • PHP-versie: Selecteer uit de lijst de PHP-versie die je voor deze Drupal-installatie wilt gebruiken. Controleer in de Drupal-documentatie welke PHP-versies compatibel zijn met jouw Drupal-versie.
   • Website rootmap: Dit is essentieel: wijs naar de map met het Drupal-entrypoint (index.php). Bij een Composer-installatie is dit de web-map: /Applications/ServBay/www/servbay-drupal-app/web.
5. Sla de configuratie op: Klik op “Opslaan” (of soortgelijke knop) zodra alles is ingevuld. ServBay laadt nu de nieuwe webserverconfiguratie automatisch in.

Stap 5: Voer de Drupal-installatiewizard uit

Je kunt nu de installatie via je browser starten op de geconfigureerde lokale domeinnaam.

1. Installeerpagina openen

   Open je browser en ga naar: https://servbay-drupal.local/core/install.php.

   Je ziet nu het installatiescherm van Drupal.

2. Kies een taal

   Selecteer de standaardtaal voor je nieuwe Drupal-omgeving en klik op “Opslaan en doorgaan”.

3. Kies het installatietype

   Meestal kies je voor “Standaard” installatie voor een volledige basisconfiguratie met veelgebruikte functies. Klik weer op “Opslaan en doorgaan”.

4. Voer de databasegegevens in

   Vul hier de databasegegevens in die je bij stap 3 hebt aangemaakt:

   • Databasetype: Selecteer MySQL, MariaDB, Percona Server, of gelijkwaardig.
   • Databasenaam: drupal_user (of de daadwerkelijke databasenaam).
   • Databasegebruikersnaam: drupal_user.
   • Databasewachtwoord: Het hiervoor gekozen wachtwoord.
   • Databasehost: localhost.
   • Geavanceerde opties: Standaard niet nodig, tenzij je database een andere poort of specifieke configuratie gebruikt.

   Klik op “Opslaan en doorgaan”. Drupal maakt nu verbinding met de database en importeert de nodige gegevens.

5. Vul de websitegegevens in

   Bij een succesvolle databaseverbinding volgt de siteconfiguratie. Vul het volgende in:

   • Sitenaam: Titel van je website.
   • E-mailadres van de site: Wordt gebruikt voor notificaties en beheer.
   • Gebruikersnaam beheerder: Deze gebruik je om in te loggen op Drupal.
   • Wachtwoord beheerder: Kies een sterk wachtwoord.
   • Land/regio: Selecteer je locatie.
   • Tijdzone: Selecteer je tijdzone.

   Klik na invullen op “Opslaan en doorgaan”. Drupal maakt nu de configuratiebestanden aan en rondt de installatie af.

6. Installatie voltooid

   Je wordt na de installatie doorgestuurd naar de homepage van je gloednieuwe Drupal-website. Gefeliciteerd, Drupal is succesvol geïnstalleerd in je ServBay-omgeving!

Stap 6: Modules en thema’s installeren (verkenning)

Een van de grootste krachten van Drupal is zijn modulaire ecosysteem. Na de installatie kun je je site uitbreiden en aanpassen met modules en thema’s.

1. Inloggen op de Drupal-backend: Ga naar https://servbay-drupal.local/user of https://servbay-drupal.local/admin en log in met de zojuist ingestelde beheergegevens.
2. Modules installeren: Navigeer na het inloggen naar het beheeritem “Uitbreidingen” (Extend) om nieuwe modules te zoeken en te installeren waarmee je de functionaliteit van je site vergroot.
3. Thema’s installeren: Via “Uiterlijk” (Appearance) kun je nieuwe thema’s installeren en instellen om het uiterlijk van je site aan te passen.

Verder gebruik en configuratie na installatie

Na de succesvolle installatie kun je direct aan de slag met de opbouw van je site. Enkele veelvoorkomende eerste stappen:

Aanmaken van contenttypes en inhoud

In Drupal zijn contenttypes het fundament; hiermee bepaal je de structuur van verschillende typen inhoud (zoals artikelen of pagina’s).

1. Contenttype maken: Ga in de backend naar “Structuur” > “Contenttypes”. Je kunt bestaande contenttypes bewerken of op “Contenttype toevoegen” klikken om een nieuwe te definiëren, inclusief velden zoals titel, tekst, afbeelding etc.
2. Inhoud aanmaken: Ga naar “Inhoud” > “Inhoud toevoegen”, kies het gewenste contenttype, vul de velden in en klik op “Opslaan en publiceren”.

Navigatiemenu’s configureren

Met menu’s organiseer je de navigatielinks op je site.

1. Menu maken: Ga naar “Structuur” > “Menu’s”. Je kunt bestaande menu’s bewerken of nieuwe aanmaken.
2. Menupunten toevoegen: Bewerk een menu, klik op “Link toevoegen”, vul de linktekst en het doellocatie (intern zoals /node/1 of een externe URL) in, en sla op.

Bloklay-out aanpassen

Blokken zijn aanpasbare contentonderdelen die worden weergegeven in bijvoorbeeld de zijbalken of de footer.

1. Blok toevoegen: Ga naar “Structuur” > “Bloklay-out”. Hier zie je de beschikbare regio’s van je thema. Je kunt blokken (zoals menu’s of aangepaste content) naar de gewenste regio slepen.
2. Blok configureren: Klik op “Configureren” bij een blok om zaken als titel, zichtbaarheid op pagina’s of voor bepaalde rollen in te stellen.

Let op en veelgestelde vragen (FAQ)

• Hoe wijzig ik de PHP-configuratie? Als Drupal bepaalde PHP-extensies of een hoger memory_limit nodig heeft, kun je in ServBay bij het tabblad “Pakketten” op de configuratieknop van de juiste PHP-versie klikken om het php.ini-bestand te bewerken. Start daarna de PHP-service opnieuw (ServBay geeft dit aan of doet het automatisch).
• Waarom is mijn website niet toegankelijk?
  • Controleer of ServBay actief is.
  • Controleer je websiteconfiguratie in ServBay, vooral domeinnaam en maplocatie. De webroot moet naar .../servbay-drupal-app/web verwijzen.
  • Kijk of de webserver (Caddy/Nginx) in ServBay draait.
  • Ga naar https://servbay-drupal.local (installatiepagina: https://servbay-drupal.local/core/install.php).
• Wat als de databaseverbinding mislukt?
  • Controleer dat databasegebruikersnaam, databasenaam en wachtwoord overeenkomen met die in phpMyAdmin.
  • Databasehost moet localhost zijn.
  • Check of MySQL/MariaDB draait in ServBay.
• Composer-afhankelijken installeren mislukt? Controleer je internetverbinding; Composer moet packagist.org kunnen bereiken. Soms moet je de Composer-cache wissen of Composer zelf updaten (ServBay houdt de ingebouwde versie actueel).
• Bestandsrechtenproblemen? Drupal moet kunnen schrijven naar bepaalde mappen (web/sites/default/files en web/sites/default/settings.php). ServBay draait meestal met gebruikersrechten, waardoor deze issues op macOS weinig voorkomen, maar controleer zo nodig de rechten van deze mappen.

Samenvatting

Door deze gids te volgen heb je succesvol Drupal geïnstalleerd en geconfigureerd binnen de lokale ServBay-ontwikkelomgeving. ServBay biedt een handig, efficiënt en compleet platform, waarmee je direct aan de slag kunt met Drupal-webontwikkeling. Je kunt nu de krachtige mogelijkheden van Drupal benutten om je website te bouwen, lokaal te ontwikkelen, te testen en te debuggen in ServBay. En naarmate je meer met Drupal werkt, kun je dankzij de flexibiliteit van ServBay gemakkelijk verschillende PHP-versies, databases en andere services beheren—ideaal voor wisselende projectbehoeften.