Contao CMS installeren en configureren in de ServBay-omgeving

Contao is een krachtig open source contentmanagementsysteem (CMS) dat bijzonder geschikt is voor het bouwen van websites voor het midden- en kleinbedrijf, portals of complexe webapplicaties. In deze handleiding leggen we stap voor stap uit hoe je Contao installeert en configureert in ServBay, een gebruiksvriendelijke lokale webontwikkelomgeving op macOS. Zo kun je snel aan de slag met je Contao-project.

ServBay biedt een alles-in-één omgeving met geïntegreerde PHP, Composer, databaseservices (zoals MySQL/MariaDB en PostgreSQL) en webservers (zoals Caddy, Nginx en Apache), waardoor het opzetten van een lokale ontwikkelomgeving enorm vereenvoudigd wordt. Met ServBay voldoe je moeiteloos aan de vereisten van Contao.

Wat is Contao?

Contao is een open source, PHP-gebaseerd CMS dat bekend staat om zijn gebruiksvriendelijkheid, flexibiliteit en krachtige beheeromgeving. Het biedt een scala aan functies zoals gedetailleerd rechtenbeheer, versiebeheer, meertalige ondersteuning, responsieve afbeeldingsverwerking en een modulaire architectuur waarmee je eenvoudig extra functionaliteit kunt toevoegen. De kernfilosofie van Contao is dat ontwikkelaars en designers snel op maat gemaakte websites kunnen bouwen, zonder vanaf nul te hoeven beginnen.

Vereisten

Voordat je begint met de installatie van Contao, zorg ervoor dat aan de volgende voorwaarden is voldaan:

1. ServBay is geïnstalleerd en draait: Installeer ServBay op je macOS-systeem. Zorg ervoor dat ServBay actief is en dat de benodigde PHP-versie (Contao heeft een specifieke PHP-versie nodig; raadpleeg de officiële Contao-documentatie voor de meest actuele eisen) en een databaseservice (zoals MySQL of MariaDB) zijn ingeschakeld in ServBay.
2. Composer: Composer is standaard geïntegreerd in ServBay. Je hoeft deze dus niet apart te installeren.
3. Toegang tot de terminal: Je hebt de terminal nodig om Composer-commando’s uit te voeren.

Stappenplan voor de installatie van Contao

In dit gedeelte doorloop je stap voor stap de installatie en configuratie van Contao in ServBay.

Stap 1: Maak een projectmap aan

Navigeer eerst naar de standaard webroot van ServBay, /Applications/ServBay/www, en maak daar een nieuwe submap voor jouw Contao-project aan.

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

We installeren Contao in de map servbay-contao-app.

Stap 2: Maak een nieuw Contao-project aan met Composer

Contao raadt installatie via Composer aan. Omdat Composer is ingebouwd in ServBay, kun je in de projectmap direct het volgende commando uitvoeren om een Contao-project aan te maken:

composer create-project contao/managed-edition .

Deze opdracht downloadt de nieuwste versie van de Contao Managed Edition en alle afhankelijkheden in de huidige map (.). De duur van dit proces varieert afhankelijk van je internetverbinding.

Toelichting Contao Managed Edition: contao/managed-edition is een officiële distributie die de kern van Contao en aanbevolen afhankelijkheden bevat, én een standaard projectstructuur biedt. Let op: bij installatie met de managed edition is de webroot van Contao de submap web in het project.

Stap 3: Database en gebruiker aanmaken

Contao heeft een database nodig om data en instellingen op te slaan. ServBay biedt handige tools voor databasebeheer, zoals phpMyAdmin of Adminer. Hier gebruiken we phpMyAdmin als voorbeeld:

1. Ga naar ServBay’s ingebouwde phpMyAdmin

   Open het lokale adres van ServBay: https://servbay.host/. Zoek op de pagina naar de link naar phpMyAdmin en klik hierop.

2. Maak een databasegebruiker aan

   Het is veiliger om een aparte databasegebruiker voor je Contao-applicatie aan te maken.

   a. Open de pagina met gebruikersaccounts

   Klik op "Gebruikersaccounts" in het hoofdmenu van phpMyAdmin.
   

   b. Voeg een nieuwe gebruiker toe

   Klik op "Voeg een gebruikersaccount toe" en vul de volgende informatie in:
   
   *   **Gebruikersnaam:** Voer een naam in voor de databaseverbinding met Contao, bijvoorbeeld `contao_user`.
   *   **Hostnaam:** Kies `localhost`. Hiermee kan de gebruiker alleen lokaal verbinden, wat veiliger is.
   *   **Wachtwoord:** Kies een **sterk wachtwoord** (gebruik geen eenvoudig wachtwoord zoals `password123`; dit is enkel een voorbeeld, gebruik in een echte omgeving een wachtwoordgenerator).
   *   **Herhaal:** Voer het wachtwoord nogmaals in.
   
   Kies bij "Database voor gebruiker aanmaken" de optie "Maak een database met dezelfde naam aan en verleen alle rechten". Hierdoor wordt er automatisch een database aangemaakt met de naam `contao_user`, waaraan alle rechten worden toegekend aan de gebruiker `contao_user`.
   
   *   Zorg ervoor dat "Alle rechten verlenen" is aangevinkt.
   *   Klik onderaan de pagina op "Starten" om de database en gebruiker aan te maken.
   

Stap 4: Website configureren in ServBay

Nu stel je een website in ServBay in die verwijst naar je zojuist aangemaakte Contao-projectmap.

1. Open ServBay en voeg een nieuwe website toe

   Open het hoofdscherm van ServBay. Ga in het linker navigatiemenu naar "Websites" en klik op de knop "Toevoegen" om een nieuwe website aan te maken.

2. Vul de websitegegevens in

   • Naam: Geef je website een herkenbare naam, bijvoorbeeld My Contao Site.
   • Domein: Stel een lokaal ontwikkelingsdomein in, bij voorkeur eindigend op .local of .servbay.demo, zoals servbay-contao.local. ServBay zorgt automatisch voor lokale domeinmapping.
   • Websitetype: Kies PHP.
   • PHP-versie: Selecteer de PHP-versie die voldoet aan de Contao-eisen (raadpleeg de officiële Contao-documentatie voor de juiste versie).
   • Webroot: Dit is zeer belangrijk. Bij installatie met de Composer contao/managed-edition bevindt de publieke map van Contao (met o.a. index.php) zich in de submap web van het project. Vul daarom het volledige pad in naar de web map, bijvoorbeeld: /Applications/ServBay/www/servbay-contao-app/web.

3. Sla de configuratie op

   Klik na het invullen van alle gegevens onderaan in ServBay op "Opslaan". De nieuwe websiteconfiguratie wordt nu toegepast.

Stap 5: Start de Contao webinstallatie

Na het instellen van je website kun je de Contao webinstaller openen in je browser via het ingestelde domein.

1. Open de installatiepagina

   Ga in je webbrowser naar je ingestelde domein gevolgd door /contao/install, bijvoorbeeld: https://servbay-contao.local/contao/install.

   Als alles goed is ingesteld, zie je nu het installatievenster van Contao.

2. Vul de databasegegevens in

   Tijdens de installatie wordt gevraagd naar de database-instellingen. Vul hier de gegevens in die je bij stap 3 hebt aangemaakt:

   • Databasehost: localhost
   • Databasenaam: contao_user (als je de optie "Maak een database met dezelfde naam aan" hebt gebruikt).
   • Gebruikersnaam: contao_user
   • Wachtwoord: Het wachtwoord dat je bij stap 3 hebt gekozen.

3. Vul beheerdersgegevens in

   Stel volgens de instructies op het scherm de loginnaam, het wachtwoord en het e-mailadres in voor de beheerder van de Contao-backend. Gebruik hierbij een sterk wachtwoord.

4. Voltooi de installatie

   Volg de resterende stappen in de installer, zoals het aanmaken van de database-tabellen. Klik op de respectievelijke knoppen (zoals "Installeren" of "Voltooien") om het installatieproces af te ronden.

Stap 6: Installatie controleren en inloggen op de backend

Na voltooiing van de installatie kun je controleren of Contao correct werkt en inloggen op het beheerdersgedeelte.

1. Bezoek de frontend van je website

   Ga in de browser naar je domein, bijvoorbeeld https://servbay-contao.local/. Je ziet nu ofwel de standaard welkomstpagina van Contao, of een lege pagina (afhankelijk van de standaardconfiguratie). Dit betekent dat de webserver correct is ingesteld en de Contao-frontend bereikbaar is.

2. Ga naar het Contao-beheer (backend)

   Bezoek de loginpagina van het Contao-beheerdersgedeelte, meestal https://servbay-contao.local/contao.

   Log in met de beheerdersgegevens die je bij installatie stap 5 hebt ingesteld. Na succesvol inloggen kom je op het beheerportaal van Contao, waar je content, extensies en website-instellingen kunt beheren.

Veelgestelde vragen (FAQ)

Vraag: Er verschijnt een foutmelding bij het bezoeken van https://servbay-contao.local/ of https://servbay-contao.local/contao/install. Wat moet ik doen?

Antwoord:

• Controleer of ServBay draait: Zorg dat de ServBay-app actief is en de vereiste PHP- en webservers (Caddy of Nginx) gestart zijn.
• Controleer je websiteconfiguratie in ServBay: Bevestig dat alle instellingen kloppen, vooral domeinnaam, websitetype, PHP-versie en webroot (vergeet niet dat bij contao/managed-edition de webroot de web-map van het project is).
• Controleer domeinmapping: ServBay regelt automatisch .local domeinen. Bij gebruik van andere extensies, of als je problemen ervaart, probeer ServBay opnieuw te starten of controleer het hosts-bestand van je systeem (al regelt ServBay dit doorgaans automatisch).
• Bekijk de logbestanden van de webserver: Raadpleeg de logbestanden van de webserver (Caddy of Nginx) via ServBay voor meer gedetailleerde foutmeldingen.

Vraag: Wat als de databaseverbinding niet lukt?

Antwoord:

• Controleer of de databaseservice draait: Zorg ervoor dat MySQL/MariaDB of PostgreSQL actief is in ServBay.
• Controleer de databasegegevens: Kijk goed na of de host (localhost), databasenaam, gebruikersnaam en wachtwoord exact overeenkomen met wat je in phpMyAdmin hebt ingesteld.
• Controleer gebruikersrechten: Controleer of de databasegebruiker alle benodigde rechten heeft op de Contao-database.

Vraag: Wat moet ik doen bij een rechtenfout tijdens de installatie?

Antwoord: Voor de installatie heeft Contao schrijfrechten op bepaalde mappen nodig. Normaal voldoet de standaardconfiguratie van ServBay, maar mocht je toch problemen hebben, stel dan in de terminal de juiste rechten in voor de Contao-projectmap:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # Vervang your_username door je macOS-gebruikersnaam
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao moet voor deze mappen schrijfrechten hebben

Wees voorzichtig met chmod 777 — in productie is dat niet veilig, maar voor lokale ontwikkeling is het een gebruikelijke tijdelijke oplossing voor rechtenproblemen.

Samenvatting

Als je deze handleiding volgt, zou je Contao CMS succesvol moeten hebben geïnstalleerd en geconfigureerd in je ServBay lokale ontwikkelomgeving. De alles-in-één omgeving van ServBay maakt het beheer van Composer-afhankelijkheden, database-instellingen en webserverconfiguraties eenvoudig, zodat jij je kunt richten op de ontwikkeling in Contao zelf. Je kunt nu content creëren, pagina's vormgeven, extensies en thema’s installeren en je eigen website samenstellen via het Contao-beheer.

Voor meer gedetailleerde informatie over het gebruik en de mogelijkheden van Contao, raadpleeg de officiële Contao-documentatie.