Bedrock Installeren en Configureren in de ServBay-omgeving

Overzicht

In dit document begeleiden we je bij het installeren en configureren van Bedrock in de lokale ontwikkelomgeving van ServBay. Bedrock biedt een moderne WordPress-projectstructuur met dependency management via Composer, geoptimaliseerde configuratiebeheerpraktijken en het volgen van best practices — waardoor de efficiëntie en veiligheid van de ontwikkeling, uitrol en het onderhoud van je WordPress-project fors toeneemt. In combinatie met ServBay’s krachtige en gebruiksvriendelijke beheer van lokale omgevingen kun je razendsnel een Bedrock-ontwikkelomgeving opzetten.

Wat is Bedrock?

Bedrock is een WordPress-projectstructuur ontwikkeld door het Roots-team, met als doel de WordPress-ontwikkelervaring te verbeteren. Bedrock wijkt aanzienlijk af van de traditionele WordPress-structuur en biedt onder andere de volgende voordelen:

• Dependency management via Composer: Zowel WordPress-core, thema’s als plugins worden beheerd via Composer, waardoor updates en dependency-conflicten gemakkelijk te managen zijn.
• Verbeterd configuratiebeheer: Volgens de Twelve-Factor App principes worden omgevingsvariabelen beheerd via een .env-bestand, waardoor configuratie gescheiden blijft van de code en veiliger en flexibeler is.
• Betere projectstructuur: WordPress-core bevindt zich in een aparte submap (web/wp), terwijl thema’s en plugins in web/app staan, waardoor het geheel overzichtelijker is.
• Verbeterde veiligheid: Standaard voorziet Bedrock in beveiligingsmaatregelen, zoals het verbergen van paden naar kernbestanden.

Bedrock is een uitstekende keuze voor het bouwen van robuuste, onderhoudbare en moderne WordPress-applicaties.

Waarom kiezen voor ServBay voor Bedrock-ontwikkeling?

ServBay is een lokaal webontwikkeltool speciaal ontworpen voor macOS. Het biedt geïntegreerde support voor toonaangevende webservers (Caddy/Nginx/Apache), meerdere PHP-versies, databases (MySQL/PostgreSQL/MongoDB) en ontwikkelomgevingen voor Node.js, Python, Go en Java. Bedrock combineren met ServBay biedt je:

• Razendsnelle setup: ServBay wordt geleverd met alle vereiste tools voor Bedrock (PHP, Composer, databases), zodat je niets handmatig hoeft te installeren of te configureren.
• Flexibel wisselen tussen PHP-versies: Test eenvoudig Bedrock-compatibiliteit met verschillende PHP-versies.
• Geïntegreerd databasebeheer: Beheer en maak eenvoudig databases aan via de ingebouwde phpMyAdmin of Adminer.
• Eenvoudige siteconfiguratie: Stel Bedrock-websites (virtuele hosts) direct en overzichtelijk in via ServBay’s grafische interface, met de juiste document root.
• Gecentraliseerd beheer: Beheer alle benodigde pakketten en sites voor lokale ontwikkeling centraal in één applicatie.

Vereisten

Zorg ervoor dat je aan de volgende voorwaarden voldoet voordat je begint met de installatie:

• ServBay is geïnstalleerd en actief op macOS.
• Je hebt basiskennis van werken met de command line.
• Je hebt basiskennis van Composer (deze gids behandelt de specifieke commando’s).

Stappen voor het Installeren van Bedrock

In dit gedeelte lees je stap voor stap hoe je een Bedrock-project installeert en configureert binnen ServBay.

Stap 1: Maak de Projectmap aan

Navigeer naar de standaard webroot van ServBay op /Applications/ServBay/www en maak een nieuwe projectmap aan. Kies bij voorkeur een duidelijke naam, bijvoorbeeld servbay-bedrock-app.

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

Deze map wordt de hoofdmap van je Bedrock-project.

Stap 2: Maak een Bedrock-project aan met Composer

ServBay wordt geleverd met Composer, waardoor je het composer commando direct in de terminal kunt gebruiken. Voer in de zojuist aangemaakte projectmap (/Applications/ServBay/www/servbay-bedrock-app) onderstaand Composer-commando uit om Bedrock te installeren:

composer create-project roots/bedrock .

Dit commando downloadt de nieuwste versie van Bedrock en alle benodigde dependencies binnen de huidige map (.). Hoe lang dit duurt is afhankelijk van je internetverbinding.

Stap 3: Maak een Database en Gebruiker aan

Bedrock en WordPress hebben een database nodig voor het opslaan van inhoud en instellingen. We gebruiken hiervoor de ingebouwde phpMyAdmin van ServBay.

1. Open phpMyAdmin, het databasebeheertool van ServBay

   Open je browser en ga naar de ServBay-locatie https://servbay.host/. Klik op de "phpMyAdmin" link op de welkomstpagina om naar de beheertool te gaan.

2. Maak een nieuwe databasegebruiker aan

   Voor het gemak en de veiligheid is het aangeraden om per project een eigen database en gebruiker aan te maken.

   1. Ga naar het gebruikersaccount-overzicht

      Klik bovenin het menu van phpMyAdmin op "Gebruikersaccounts".

   2. Voeg een nieuwe gebruiker toe

      Klik op "Gebruiker toevoegen". Vul vervolgens dit in:

      • Gebruikersnaam: Kies een naam voor deze database, bijvoorbeeld bedrock_user.
      • Hostnaam: Selecteer localhost, zodat deze gebruiker alleen lokaal verbinding kan maken.
      • Wachtwoord: Voer een veilig wachtwoord in. Sla het wachtwoord op. Voor lokale tests kun je bijvoorbeeld password123 gebruiken, maar gebruik voor productie altijd een sterk wachtwoord.
      • Bevestigen: Voer het gekozen wachtwoord opnieuw in.

      Bij "Database voor gebruiker aanmaken", kies "Maak een database aan met dezelfde naam als de gebruiker en ken alle rechten toe". Zo wordt automatisch een database en gebruiker bedrock_user aangemaakt, waarbij de gebruiker alle rechten krijgt.

      Zorg ervoor dat "Alle rechten toekennen" is geselecteerd zodat deze gebruiker volledige toegang krijgt tot de nieuwe database.

      Klik onderaan op "Starten" om de gebruiker en de database te creëren.

Stap 4: Bedrock Configureren

Bedrock gebruikt omgevingsvariabelen voor de configuratie. Die staan doorgaans in een .env-bestand in de projectroot.

1. Bewerk het omgevingsconfiguratiebestand

   In de root van je Bedrock-project (/Applications/ServBay/www/servbay-bedrock-app) vind je het voorbeeldbestand .env.example. Kopieer en hernoem deze als .env:

   cp .env.example .env

   Het .env-bestand wordt gebruikt voor de echte projectconfiguratie, .env.example is uitsluitend een voorbeeld en bevat geen gevoelige informatie.

2. Pas het .env-bestand aan

   Open met een teksteditor (bijvoorbeeld VS Code, Sublime Text, Nano etc.) het nieuwe .env bestand. Zoek de instellingen voor de databaseverbinding en pas deze aan met de waarden uit stap 3:

   # Database
   DB_NAME='bedrock_user' # Naam van de database, gelijk aan de gebruikersnaam
   DB_USER='bedrock_user' # Database gebruikersnaam
   DB_PASSWORD='password123' # Het wachtwoord voor de databasegebruiker
   DB_HOST='localhost' # Database host, voor lokale ServBay meestal localhost
   DB_PREFIX='wp_' # Tabelprefix, kan standaard blijven of aangepast worden
   
   # WordPress Environment
   WP_ENV='development' # Actieve omgeving, bijvoorbeeld development, staging of production
   
   # Site URLs
   WP_HOME='http://servbay-bedrock.local' # Volledige URL van de website
   WP_SITEURL='${WP_HOME}/wp' # URL naar de WordPress-core

   Vul de juiste waarden in op basis van jouw situatie (vooral het wachtwoord onder DB_PASSWORD, zoals in phpMyAdmin aangemaakt).

   WP_HOME en WP_SITEURL bepalen onder welk adres je de site in de browser bezoekt. servbay-bedrock.local is een veelgebruikt lokaal ontwikkelingsdomein, maar dit kun je aanpassen. WP_SITEURL verwijst naar de submap (web/wp) waar WordPress is geïnstalleerd.

   Je kunt in .env ook andere Bedrock- en WordPress-instellingen beheren, zoals het instellen van constanten of e-mailconfiguratie.

Stap 5: Webserver Configureren (ServBay Site)

Om ervoor te zorgen dat de ServBay-webserver je Bedrock-project kan tonen, moet je in ServBay een nieuwe site (virtual host) aanmaken.

1. Voeg een nieuwe site toe

   Open de ServBay-app, klik in het linker menu op "Websites". Klik op de "+" of "Website toevoegen" om een nieuwe site in te stellen. Vul het volgende in:

   • Naam: Een duidelijk herkenbare naam, zoals My Bedrock Site (enkel voor intern gebruik).
   • Domein: Het domein uit het .env-bestand, bijv. servbay-bedrock.local. ServBay koppelt dit automatisch aan localhost (127.0.0.1).
   • Websitetype: Kies PHP.
   • PHP-versie: Selecteer een PHP-versie die door Bedrock ondersteund wordt (meestal de nieuwste stabiele versie in ServBay).
   • Document root: Belangrijk: Bij Bedrock is de webroot niet de hoofdmap, maar de web submap, dus gebruik /Applications/ServBay/www/servbay-bedrock-app/web.

2. Sla de configuratie op

   Heb je alles ingevuld? Klik dan op opslaan. ServBay past zijn webserverinstellingen automatisch aan. Volg eventuele instructies voor het opnieuw opstarten van de services als ServBay dat aangeeft.

Stap 6: WordPress Installatie Voltooien

Je Bedrock-project en de ServBay-site zijn nu klaar. Voltooi de installatie van WordPress zoals je dat gewend bent via de browser.

1. Bezoek de installatiepagina

   Open je browser en ga naar het adres dat bij WP_SITEURL en de ServBay-siteconfiguratie hoort, bijvoorbeeld http://servbay-bedrock.local/wp. Als alles klopt, verschijnt de WordPress-installatieassistent.

2. Vul de databasegegevens in

   De wizard vraagt om databasegegevens. Vul in wat je in stap 3 hebt aangemaakt:

   • Database: bedrock_user
   • Gebruikersnaam: bedrock_user
   • Wachtwoord: Het gekozen wachtwoord (bijvoorbeeld password123)
   • Database host: localhost
   • Tabelvoorvoegsel: wp_ (meestal standaard, tenzij je zelf anders wenst)

   Klik op "Verzenden". WordPress probeert nu verbinding te maken met de database.

3. Voer site-instellingen in

   Bij een succesvolle databaseverbinding ga je door naar het instellen van de sitesettings:

   • Sitetitel: De naam van je website.
   • Gebruikersnaam: Stel een admin gebruikersnaam in.
   • Wachtwoord: Kies een sterk admin-wachtwoord.
   • E-mailadres: Vul het beheerdersemailadres in.
   • Zichtbaarheid voor zoekmachines: In een lokale ontwikkelomgeving kun je "Blokkeer zoekmachines voor deze site" inschakelen.

4. Rond de installatie af

   Klik op "WordPress installeren". WordPress voltooit de installatie en maakt de benodigde tabellen in de database aan. Je ziet nu een bevestigingspagina, waarna je kunt inloggen op het WordPress-beheer (wp-admin).

Stap 7: Thema’s & Plugins installeren (met Composer)

Bedrock stimuleert het installeren van thema’s en plugins via Composer in plaats van via de WordPress backend.

1. Zoek Composer-pakketnamen voor thema’s/plugins

   Populaire thema’s en plugins hebben vaak een pakket op Packagist (packagist.org) of WordPress Packagist (wpackagist.org). De naam volgt meestal het patroon vendor/package-name, bijvoorbeeld wpackagist-theme/twentytwentyone of wpackagist-plugin/wordpress-seo.

2. Installeer via Composer

   Ga in de Bedrock-projectroot (/Applications/ServBay/www/servbay-bedrock-app) en gebruik Composer:

   Thema installeren:

   composer require wpackagist-theme/your-theme-name

   Plugin installeren:

   composer require wpackagist-plugin/your-plugin-name

   Vervang your-theme-name en your-plugin-name met de echte pakketnamen. Composer plaatst thema’s in web/app/themes en plugins in web/app/plugins.

3. Activeer in de WordPress backend

   Log in op WordPress beheer (http://servbay-bedrock.local/wp/wp-admin/):

   • Thema’s: Ga naar "Weergave" -> "Thema’s", kies en activeer het gewenste thema.
   • Plugins: Ga naar "Plugins" -> "Geïnstalleerde plugins", zoek en activeer de plugin.

   Je kunt nog steeds handmatig .zip-bestanden uploaden via de backend, maar Composer is de aanbevolen en modernste manier bij Bedrock.

Werken met Bedrock

Nu je Bedrock succesvol hebt opgezet in ServBay, kun je aan je website bouwen net als met een klassieke WordPress-site, terwijl je profiteert van moderne ontwikkelpraktijken.

• Pagina’s & berichten aanmaken: Log in op WordPress beheer en voeg content toe via "Pagina’s" en "Berichten" — precies als bij standaard WordPress.
• Menu’s beheren: Instellingen onder "Weergave" -> "Menu’s".
• Widgets aanpassen: Beheer content voor zijbalken en andere ruimtes onder "Weergave" -> "Widgets".
• Thema- & pluginontwikkeling: Als ontwikkelaar bouw je zelf in web/app/themes of web/app/plugins.
• Configuratiebeheer: Beheer verschillende omgevingen (development, staging, productie) centraal met .env.

Veelgestelde Vragen (FAQ)

• Vraag: Krijg ik een 404-fout op http://servbay-bedrock.local?

  • Antwoord: Controleer of het ingestelde domein in ServBay overeenkomt met het gebruikte adres.
  • Antwoord: Zorg dat de website root in ServBay op /Applications/ServBay/www/servbay-bedrock-app/web staat.
  • Antwoord: Kijk of de ServBay-webserver actief is.
  • Antwoord: Controleer WP_HOME in het .env-bestand.

• Vraag: Zie ik een databaseverbinding-fout op http://servbay-bedrock.local/wp?

  • Antwoord: Check of de waarden in .env (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST) exact kloppen met wat je in phpMyAdmin hebt aangemaakt.
  • Antwoord: Controleer of MySQL of de gebruikte database in ServBay draait.
  • Antwoord: Controleer of de gebruiker in phpMyAdmin alle rechten heeft op de database.

• Vraag: Waarom zie ik geïnstalleerde thema’s/plugins niet in WordPress?

  • Antwoord: Heb je daadwerkelijk composer install of composer require uitgevoerd in de projectroot, en ging dit zonder fouten?
  • Antwoord: Thema’s geïnstalleerd met Composer vind je in web/app/themes, plugins in web/app/plugins. Check of ze daar staan.
  • Antwoord: Activeer ze in de backend bij "Weergave"/"Thema’s" of "Plugins"/"Geïnstalleerde plugins".

• Vraag: Hoe update ik Bedrock, WordPress core, thema’s of plugins?

  • Antwoord: Bij Bedrock, beheerd via Composer, update je dependencies met composer update (voor alles) of composer update vendor/package-name (voor één pakket). Na een update kan het zijn dat je WordPress vraagt om database-updates uit te voeren.

Samenvatting

Met deze stappen heb je succesvol een Bedrock-project opgezet in de lokale ontwikkelomgeving van ServBay. Dankzij het gemak van ServBay en de moderne workflow van Bedrock kun je WordPress-projecten nu sneller, veiliger en efficiënter ontwikkelen en beheren. Begin vandaag nog met het bouwen van je volgende WordPress-website, en profiteer volop van de voordelen van Bedrock!