Installatie - LimeSurvey CE

Let op: Deze installatie-instructies gelden voor de huidige versie van LimeSurvey. Oudere instructies voor 1.92 vindt u hier en instructies voor een upgrade vindt u hier. Als u LimeSurvey liever installeert via de opdrachtregel, zie dan Installatie via de opdrachtregel (CLI).

Controleren of je LimeSurvey op je website kunt gebruiken

Controleer of uw server voldoet aan de volgende eisen.

Bij de installatie worden de systeemvereisten gecontroleerd!

De minimale set vereisten voor LimeSurvey:

• Minimaal 500 MB schijfruimte (het uitgepakte LimeSurvey 7.x-pakket alleen al neemt ongeveer 380 MB in beslag), plus ruimte voor uw geüploade bestanden en enquêtegegevens.
• MariaDB 10.3.38 of hoger OF MySQL 8 of hoger OF Microsoft SQL Server 2019 of hoger OF Postgres 14 of hoger.
• Vereisten voor de PHP-versie:
  • LS 7.x vanaf PHP 8.1.29 (getest tot en met PHP 8.5.x)
  • LS 6.x van PHP 8.1.x tot 8.3.x
  • LS 5.x van PHP 7.2.5 tot 8.0.x
  • LS 3.x van PHP 5.5.9 tot 7.4.x
• PHP memory_limit van minimaal 128 MB.
• De volgende PHP-modules/bibliotheken moeten zijn ingeschakeld:
  • mbstring (Multibyte String Functions) extensiebibliotheek.
  • PDO-databasestuurprogramma voor MySQL/MariaDB (pdo_mysql) of Postgres (pdo_pgsql) of MSSQL (pdo_sqlsrv voor Windows en pdo_dblib voor Linux).
  • GD - zie documentatie van de PHP GD-Library-extensie
  • Zip - zie documentatie van de PHP Zip-extensie
  • Zlib - zie documentatie van de PHP Zlib-extensie
  • Curl-bibliotheek
  • fileinfo
  • JSON
  • Verder gaan we er in het algemeen van uit dat alle standaard PHP-bibliotheken zijn ingeschakeld, bijvoorbeeld:
    • ctype
    • filter
    • hash
    • openssl
    • session
    • SimpleXML
    • enz. …
• Voor LimeSurvey 7.x: het URL-formaat moet zijn ingesteld op path (URL's zoals index.php/admin). Het oude URL-formaat get (URL's zoals index.php?r=admin) wordt niet langer ondersteund. Het installatieprogramma stelt het formaat path automatisch in, dus u hoeft dit alleen te controleren als u een oud config.php-bestand met 'urlFormat' => 'get' hergebruikt.

NB.: Als je in Linux een verbinding maakt met een MSSQL database op een Windows-server met gebruik van dblib PDO-driver, dan moet de onderliggende FreeTDS goed ingesteld zijn. Lees de pagina Problemen oplossen voor meer informatie.

Optionele PHP-extensies:

• GD-Library met ondersteuning voor FreeType en JPEG is nodig voor captcha's, mooie grafieken in de statistieken of om afbeeldingen te uploaden via de HTML-editor - zie documentatie van de PHP GD-Library-extensie
• IMAP is nodig voor het systeem voor het bijhouden van e-mailbounces - zie documentatie van de PHP IMAP-extensie. Vanaf PHP 8.4 wordt de IMAP-extensie niet meer meegeleverd met PHP en moet deze apart worden geïnstalleerd via PECL.
• LDAP is nodig om deelnemers aan de enquête te importeren via LDAP - zie PHP LDAP-documentatie
• Intl wordt gebruikt om teksten correct te sorteren volgens de regels van de betreffende taal - zie PHP Intl-documentatie
• Sodium wordt aanbevolen voor gegevensversleuteling - zie PHP Sodium-documentatie. Als deze ontbreekt, valt LimeSurvey terug op een veel tragere PHP-implementatie.

Aanbevolen PHP-instellingen (het installatieprogramma toont een waarschuwing als uw waarden lager zijn):

• max_input_vars: 5000 of meer
• post_max_size: 32M of meer
• upload_max_filesize: 32M of meer

In de meeste gevallen kan je webhoster je helpen om deze componenten te activeren.

Webbrowser compatibiliteit

Bij het invullen van de enquête ondersteunen we Edge en alle nieuwere vergelijkbare webbrowsers zoals Edge, Firefox, Chrome, Opera, ... met JavaScript ingeschakeld.

Voor het beheergedeelte ondersteunen we Edge en alle vergelijkbare webbrowsers zoals Firefox, Chrome, Opera, ... met JavaScript ingeschakeld.

Schermgrootte

We ondersteunen alle gebruikelijke schermgroottes voor het afnemen van enquêtes vanaf (360px x 640px en hoger). Voor LimeSurvey-beheer is de minimale schermresolutie 1280px x 1024px.

Hosting van LimeSurvey

LimeSurvey werkt met de meeste hostingbedrijven die PHP en MySQL/MariaDB leveren. Wilt u een kant-en-klaar geïnstalleerde versie van LimeSurvey die wij voor u onderhouden? Probeer dan LimeSurvey Cloud. Zie LimeSurvey Cloud versus LimeSurvey CE voor de verschillen.

Download LimeSurvey

Download de laatste stabiele versie van de LimeSurvey. Er zijn zip, gzip, bz2 en 7zip-bestanden beschikbaar. Sla de download op.

Uitpakken van LimeSurvey-download

Pak het bestand uit in een map. Gebruik hiervoor je favoriete software. Check bij het uitpakken dat je de mapstructuur mee uitpakt (gebeurt meestal vanzelf). Het pad mag geen haakjes, maar wel spaties bevatten.

Informatie over de server verzamelen

U moet het volgende weten om LimeSurvey correct op uw webserver te installeren:

• Het beoogde webadres waar uw scripts komen te staan (bijvoorbeeld https://my.domain.com/limesurvey).
• Welke webserversoftware gebruikt u?
  • voor Apache: LimeSurvey Apache-voorbeeldconfiguratie
  • voor nginx: bekijk onze LimeSurvey nginx-voorbeeldconfiguratie (verouderd, geen ondersteuning voor de editor)
• De fysieke locatie op uw server waar uw scripts komen te staan (bijvoorbeeld /home/usr/htdocs/limesurvey).
• De IP-/netwerklocatie van uw databaseserver (bijvoorbeeld localhost).
• Als uw databaseserver een niet-standaardpoort gebruikt, zoek dan uit welke poort dat is.
• Uw gebruikersnaam en wachtwoord voor uw databaseserver.
• Bij de meeste providers kunt u het script de database niet laten aanmaken, maar moet u dit zelf doen. Gebruikt u zo'n provider, maak dan zelf een database aan (bijvoorbeeld limesurvey). Gebruik voor MySQL/MariaDB de tekenset utf8mb4 met de collatie utf8mb4_unicode_ci.

De bestanden uploaden op de webserver

Maak met uw FTP/SFTP-programma (bijvoorbeeld FileZilla) verbinding met uw webserver en maak een map aan voor uw scripts. Upload de bestanden daarna met behoud van de mapstructuur. Zorg ervoor dat u de bestanden in binaire modus uploadt (controleer de instellingen van uw FTP-programma). Houd er rekening mee dat uploaden in ASCII-modus kan leiden tot ongebruikelijke fouten (bijvoorbeeld de foutmelding 'class not found' tijdens de installatie) en dat afbeeldingen mogelijk niet correct worden geüpload. Zorg er ook voor dat de verborgen .htaccess-bestanden worden geüpload - deze beschermen enkele mappen en maken URL's zonder index.php mogelijk op Apache.

Maprechten

Om het script goed te laten werken, heeft het toegang nodig tot een aantal mappen - dit geldt vooral voor Linux/*nix-systemen.

• De map "/limesurvey/tmp" (en alle onderliggende mappen en bestanden) wordt gebruikt voor imports en uploads en moet voor uw webserver zijn ingesteld op Lezen en schrijven.
• De map "/limesurvey/upload/" (en alle onderliggende mappen en bestanden) moet ook Lezen en schrijven hebben voor uw webserver, zodat afbeeldingen en mediabestanden kunnen worden geüpload.
• De map "/limesurvey/application/config/" heeft eveneens rechten voor Lezen en schrijven nodig voor uw webserver.
• De overige mappen kunnen op Alleen lezen worden ingesteld.

  Als u Linux gebruikt, hangt het instellen van rechten af van de configuratie van uw webserver. Als uw webserver bijvoorbeeld draait als gebruiker www-data (Debian/Ubuntu) of apache (RHEL/Rocky Linux/AlmaLinux), typ dan chown -R www-data <directory> ; chmod -R 755 <directory> voor de drie hierboven genoemde mappen. Hierdoor heeft iedereen leesrechten en heeft uw webserver schrijfrechten.

Een databasegebruiker aanmaken

LimeSurvey zal een database inclusief de structuur aanmaken. Daarvoor heeft het een gebruikersnaam en wachtwoord nodig van een database gebruiker. We raden aan een gebruiker aan te maken met de volgende rechten:

- MySQL/MariaDB: SELECT, CREATE, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX

- PostgreSQL: De eenvoudigste manier is om de database-gebruiker eigenaar te maken van de LimeSurvey-database. Anders heeft de gebruiker het recht CREATE nodig op het schema, plus SELECT, INSERT, UPDATE, DELETE, TRUNCATE, TRIGGER op de tabellen en USAGE op de sequences.

- Microsoft SQL Server: De database-gebruiker moet lid zijn van de rol db_owner van de LimeSurvey-database. Als u wilt dat het installatieprogramma de database aanmaakt, heeft de gebruiker ook de serverrol dbcreator nodig.

Het installatiescript starten

Open de URL van uw LimeSurvey-installatie in uw browser (bijvoorbeeld https://example.org/limesurvey). Als u alles correct hebt geconfigureerd, start het LimeSurvey installatie-programma automatisch - volg gewoon de instructies:

1. Selecteer de taal van het installatieprogramma en accepteer de licentie.
2. Bekijk de Controle voor de installatie. Alle vereiste onderdelen moeten als OK zijn gemarkeerd voordat u verder kunt gaan.
3. Voer uw Database-configuratie in. LimeSurvey vraagt u of u de database en/of de tabellen in de database wilt aanmaken en maakt vervolgens de benodigde tabellen aan.
4. Stel het beheerdersaccount in: voer de gebruikersnaam, het wachtwoord en het e-mailadres van de beheerder in, evenals de naam van uw enquêtesite en de standaardtaal.

Het beheerscript voor het eerst opstarten

Als de installatie klaar is, bent u klaar! Open uw browser en voer de URL van de LimeSurvey-beheeromgeving in. Als u 'limesurvey' als mapnaam hebt gebruikt om de bestanden in op te slaan, wordt dit iets als https://www.example.com/limesurvey/admin.

U zou een inlogscherm moeten zien. Log in met de gebruikersnaam en het wachtwoord van de beheerder die u tijdens de installatie hebt ingevoerd. Als u deze in het installatieprogramma niet hebt gewijzigd, zijn dit de standaard inloggegevens:

Gebruikersnaam: admin
Wachtwoord: password

Als u nog steeds het standaardwachtwoord gebruikt, wijzig dit dan direct in uw accountinstellingen. Veel plezier!

Verdere configuratie

Voor verdere instellingen, zoals de e-mailconfiguratie (SMTP) of beveiligingsinstellingen, zie Optionele instellingen en Algemene instellingen.

Caching

LimeSurvey maakt standaard gebruik van de Yii-bestandscache, maar dit kan worden gewijzigd. Mogelijke andere caches zijn:

• Memcached (CMemCache)
• Redis (CRedisCache)
• APCu (CApcCache)
• Database (CDbCache)

Raadpleeg de documentatie bij Yii.

Vanaf LimeSurvey 4.0.0 heb je ook de mogelijkheid om berekeningen te cachen in ExpressionScript. Dit kan de snelheid verbeteren bij een meer complexe enquête. Als je de emcache wilt inschakelen, voeg dan onderstaande regel toe aan het config.php-bestand (componentsarray):

'emcache' => array('class' => 'CFileCache'),

Net als bij Yii-cache kun je een andere cache gebruiken.

De emcache is niet compatibel met gerandomiseerde enquêtes en wordt in dergelijke gevallen automatisch uitgeschakeld.

Problemen

Net als bij alle computerprogramma's werkt het meestal zoals de instructies beschrijven, maar soms ook niet. Er zijn te veel mogelijke redenen waarom dingen niet volgens plan verlopen om ze hier te beschrijven. Als u problemen ondervindt, bekijk dan eerst de Installatie-FAQ. Staat uw antwoord daar niet tussen, plaats dan uw probleem en eventuele foutmeldingen op de LimeSurvey-forums, open een supportticket (alleen voor klanten die LimeSurvey Cloud gebruiken) of word lid van ons Discord-kanaal.