en nl sitemap

Installatie Frocole services

De Frocole App communiceert met de server door middel van een set PHP web services. Daarnaast is er een Drupal 10 gebaseerde beheer omgeving voor o.a. het aanmaken van cursussen.

De Frocole services kunnen eenvoudig geïnstalleerd worden door de files te kopiëren naar een separate folder op de webserver (b.v. ‘/frocole/’) 1.

De volgende stap is om de frocole database 2 te creëren met een tool als PhpMyAdmin en daarin de SQL-commando’s uit frocole.sql te importeren en uit te voeren 3. Belangrijk is dat de database ‘utf8mb4_general_ci’ gebruikt in plaats van ‘latin1’ als karakter set.

Het schema van de database 4 ziet er als volgt uit:

drawSQL-export-2022-03-14_12_21

Daarna is de volgende stap om de database inloggegevens te definiëren. Standaard gebruikt Frocole services een ‘config.inc’ file die een ‘frocole_db.ini’ file leest dat net buiten de web root staat (dus b.v. /srv/www als de webroot /srv/www/htdocs is). In deze laatste file staan de inloggegevens van de MySQL database.

Deze ‘frocole_db.ini’ file heeft het volgende formaat:

    [database]
    host = <mysql hostname>
    port = <mysql poortnummer>
    schema = <frocole_database_name>
    username = <mysql user>
    password = <mysql user>

De diverse waarden moeten gelijk zijn als hetgeen aan Drupal’s ‘settings.php’ toegevoegd wordt als deel van de installatie van de Frocole beheer module.

In de ‘config.inc’ file kan de variabele $develop op false gezet worden waardoor de beveiliging wordt aangescherpt (i.e. geen PHP foutmeldingen in de browser, geen ‘phpinfo()’ functie en onderdrukken van het PHP versie nummer in http headers). Verder zijn de meeste webservices alleen via POST te gebruiken. Dit wordt in de ‘.htaccess’ file afgedwongen.

Hierna kan de database connectie getest worden door het oproepen van de pagina’s ‘/frocole/CheckIfServerExists.php’ en ‘/frocole/CheckIfDatabaseExists.php’ in een webbrowser 5.

Voetnoten:

  1. Een alternatief voor unzippen en kopiëren is git te gebruiken voor deployment direct vanuit de GitHub repository. Dit kan vanaf de command line, als de huidige folder de web root is, met het git commando: ‘git clone https://github.com/Frocole/Frocole_Services.git frocole’. ↩

  2. Indien een andere database naam dan ‘frocole’ gewenst is, moet dit zowel in het bovenstaande commando als in het sql bestand aangepast worden (zie de regels 20 tot 24). ↩

  3. Dit kan met een commando: ‘mysql –u{mysql username} –p{mysql password} –h{mysql host} –P{mysql port} frocole < {*.sql bestandnaam}’. . ↩

  4. Relaties tussen de tabellen worden door de Frocole App en de Frocole Services softwarematig afgedwongen, er zijn aldus geen SQL relaties gedefinieerd in de MySQL database. ↩

  5. Dit kan inhouden dat men tijdelijk het configuratieblok in de /frocole/.htaccess moet disabelen of de .htaccess file gedurende het initiële testen een andere naam moet geven ↩