Stap 3: Maak een database aan

Als je Drupal installeert op een testsite, kun je deze stap overslaan. Wanneer je het installatiescript uitvoert (de volgende stap), is het voldoende om de gebruikersnaam en het wachtwoord van een databasegebruiker op te geven met toestemming om een nieuwe database aan te maken.

Als je Drupal op een openbare webserver installeert, moet je eerst een database aanmaken en toegang verlenen aan een gebruiker met beperkte rechten. De databasegebruiker die je tijdens de installatie opgeeft, zal verbinding maken met de database bij elke paginaweergave.

Op deze pagina vind je instructies voor het aanmaken van een Drupal-database via een van de volgende methoden:

• Een webgebaseerd bedieningspaneel (zoals CPanel of Plesk)
• PhpMyAdmin
• SQL-opdrachten (via de opdrachtregel)
• MySQL / MariaDB-opdrachten
• PostgreSQL-opdrachten

Tekens toegestaan in een MySQL / MariaDB-databasenaam

• Als je hoofdletters gebruikt in de databasenaam, worden deze omgezet naar kleine letters.
• Toegestane tekens: a..z, 0..9 en “_” (underscore).

Een database en gebruiker aanmaken via een webgebaseerd bedieningspaneel

De meeste hostingaccounts bieden een webpaneel waarmee je je site kunt beheren. Deze tools bevatten eenvoudige functies om een nieuwe database en een “gebruiker” met databasebevoegdheden aan te maken. Raadpleeg de documentatie of neem contact op met je hostingprovider voor specifieke instructies.

Wanneer je een databasegebruiker aanmaakt, kun je een pagina zien waar je de privileges kunt instellen die de gebruiker krijgt. In de meeste bedieningspanelen kun je simpelweg “Alle” privileges aanvinken (maar de optie “Grant” uitschakelen als die verschijnt). Daarmee stel je de gebruiker correct in.

Noteer de gebruikersnaam, het wachtwoord, de databasenaam en de hostnaam (bijvoorbeeld als je installeert op http://example.com, http://drupal.example.com of http://example.com/blog). Deze gegevens heb je nodig bij de installatie van Drupal.

Bij veel hosts wordt de gebruikersnaam die je gebruikt voor het inloggen op het bedieningspaneel toegevoegd als prefix aan je databasenaam en soms ook aan je databasegebruiker. Bijvoorbeeld: als je inlogt als “webadmin” en een database “drupal8db” maakt met een gebruiker “d8user”, moet je tijdens de installatie mogelijk “webadmin_drupal8db” en “webadmin_d8user” invoeren.

Een database en gebruiker aanmaken met phpMyAdmin

De veiligste manier om een database aan te maken met phpMyAdmin is door een gebruiker te maken die volledige rechten heeft op de nieuwe database, maar geen rechten op andere databases. Dit beperkt de toegang als iemand je inloggegevens bemachtigt.

Opmerking: deze procedure gaat ervan uit dat je root-toegang hebt tot phpMyAdmin (versie 3.5.x).

1. Log in op phpMyAdmin als root.
2. Klik op Users en vervolgens op Add user.
3. Voer een gewenste gebruikersnaam in.
4. Kies bij Host de optie Local (veiliger, tenzij je toegang nodig hebt vanaf een andere server).
5. Voer een wachtwoord in of genereer er één.
6. Selecteer in het gedeelte Database for user de optie Create database with same name and grant all privileges.
7. Kies COLLATION utf8mb4_unicode_ci of utf8mb4_general_ci.

• Opmerking: utf8mb4_general_ci is iets sneller, maar utf8mb4_unicode_ci biedt nauwkeurigere tekstreeksen. Gebruik utf8mb4_unicode_ci als je twijfelt.
• Als je tijdens de installatie geen COLLATION kunt kiezen, kun je dit later aanpassen onder het tabblad Operations.

Klik vervolgens op Go om de gebruiker aan te maken.

PhpMyAdmin maakt nu een database aan met dezelfde naam als de gebruiker. Als je een andere naam wilt gebruiken, kun je via het tabblad Operations de database hernoemen.

Een database aanmaken via de opdrachtregel

Als je geen grafisch paneel gebruikt of ervaring hebt met MySQL, MariaDB of PostgreSQL, kun je de volgende opdrachten gebruiken.

Database aanmaken met MySQL / MariaDB-opdrachten

Opmerking: De database moet worden aangemaakt met UTF-8 (utf8mb4) en COLLATION utf8mb4_unicode_ci of utf8mb4_general_ci. Zie de MySQL-documentatie: MySQL 5.7 handleiding.

Voor MariaDB: MariaDB kennisbank.

In de volgende voorbeelden is ‘username’ een gebruiker met CREATE en GRANT-rechten, en ‘databasename’ de naam van de nieuwe database.

mysql -u username -p -e "CREATE DATABASE databasename CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci";

Log vervolgens in:

mysql -u username -p

Maak een gebruiker aan en ken rechten toe:

CREATE USER username@localhost IDENTIFIED BY 'password';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE TEMPORARY TABLES
ON databasename.* TO 'username'@'localhost' IDENTIFIED BY 'password';

Gebruik backticks (`) rond de databasenaam als deze speciale tekens bevat. Gebruik bijvoorbeeld `drupal\_test\_account`.* in plaats van drupal_test_account.*.

Opmerking: Voeg eventueel de privilege LOCK TABLES toe als je Drush gebruikt om databaseback-ups te herstellen.

FLUSH PRIVILEGES;
exit

Database aanmaken met PostgreSQL

De database moet UTF-8 (UNICODE) gebruiken.

1. Maak een gebruiker aan

createuser --pwprompt --encrypted --no-adduser --no-createdb username

2. Maak een database aan

createdb --encoding=UNICODE --owner=username databasename

Als alles correct verloopt, zie je de melding CREATE DATABASE.