Wil je vanuit PHP verbinding maken met een MySQL- of MariaDB-database? Dan heb je twee keuzes: MySQLi of PDO. In dit artikel lees je hoe je met allebei een verbinding maakt, veilig queries uitvoert met prepared statements, en de verbinding met je database versleutelt met TLS. Gebruikt je website nog de oude mysql_connect()? Dan lees je ook hoe je die ombouwt.
In dit artikel
Prepared statements: veilig gegevens gebruiken in een query
De verbinding versleutelen met TLS: MySQLi-verbinding met MySQL over SSL/TLS, PDO-verbinding met MySQL over SSL/TLS, Controleren of de verbinding versleuteld is
Van ext/mysql naar MySQLi: MySQLi-equivalenten voor ext/mysql, En WordPress?
MySQLi of PDO?
Beide extensies zijn goed, actueel en veilig, zolang je prepared statements gebruikt. Het verschil:
- MySQLi (de i staat voor improved) werkt alleen met MySQL en MariaDB. Je kunt het procedureel gebruiken (
mysqli_connect()) of objectgeoriënteerd (new mysqli()). Handig als je oudeext/mysql-code ombouwt, want de functies lijken erg op elkaar. - PDO (PHP Data Objects) werkt met meerdere soorten databases, zoals MySQL, SQL Server, PostgreSQL en SQLite. Wissel je later van database, dan hoef je minder code aan te passen. Ook de prepared statements met benoemde parameters zijn wat prettiger.
Begin je een nieuw project? Kies dan PDO. Bouw je bestaande code om, dan is MySQLi vaak de kleinste stap. In de voorbeelden hieronder gebruik ik de tekenset utf8mb4: die ondersteunt alle Unicode-tekens, ook emoji. De oude utf8 doet dat niet.
Verbinding maken met MySQLi
Een gewone, onversleutelde verbinding met MySQLi maak je zo:
<?php
$db = new mysqli( 'db-host', 'gebruiker', 'wachtwoord', 'databasenaam' );
$db->set_charset( 'utf8mb4' );
$result = $db->query( 'SELECT id, titel FROM artikelen' );
while ( $row = $result->fetch_assoc() ) {
echo $row['titel'] . PHP_EOL;
} Sinds PHP 8.1 gooit MySQLi standaard een mysqli_sql_exception als er iets misgaat, bijvoorbeeld als de verbinding mislukt. Vang die af met try/catch, en toon de foutmelding nooit aan je bezoekers: die kan de naam van je databaseserver of gebruiker bevatten.
Verbinding maken met PDO
Bij PDO geef je de server, database en tekenset op in de DSN (Data Source Name):
<?php
$dsn = 'mysql:host=db-host;dbname=databasenaam;charset=utf8mb4';
$db = new PDO( $dsn, 'gebruiker', 'wachtwoord', array(
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
) );
foreach ( $db->query( 'SELECT id, titel FROM artikelen' ) as $row ) {
echo $row['titel'] . PHP_EOL;
} Ook PDO gooit sinds PHP 8.0 standaard een exceptie (PDOException) bij een fout.
Prepared statements: veilig gegevens gebruiken in een query
Zet nooit invoer van bezoekers, zoals $_GET of $_POST, rechtstreeks in een SQL-query. Dan is je website kwetsbaar voor SQL-injectie. Gebruik daarom prepared statements: de database krijgt de query en de waarden los van elkaar.
Met MySQLi:
$stmt = $db->prepare( 'SELECT titel FROM artikelen WHERE id = ?' );
$stmt->bind_param( 'i', $id );
$stmt->execute();
$row = $stmt->get_result()->fetch_assoc(); Met PDO, met een benoemde parameter:
$stmt = $db->prepare( 'SELECT titel FROM artikelen WHERE id = :id' );
$stmt->execute( array( 'id' => $id ) );
$row = $stmt->fetch(); Meer voorbeelden en achtergrond lees je in SQL injection tegengaan met prepared statements.
De verbinding versleutelen met TLS
Draait je database op een andere server dan je website? Dan gaan je gebruikersnaam, wachtwoord en alle gegevens standaard onversleuteld over het netwerk. PHP gebruikt namelijk alleen TLS (vroeger SSL genoemd) als je daar zelf om vraagt, ook als de databaseserver het ondersteunt. Vraag je hostingprovider of de databaseserver TLS ondersteunt, en welk CA-certificaat je nodig hebt.
Gebruik ook het CA-certificaat om het certificaat van de server te controleren. Zonder die controle is de verbinding wel versleuteld, maar weet je niet zeker dat je met de echte databaseserver praat. Bij die controle kijkt PHP ook of de hostnaam waarmee je verbindt in het certificaat van de server staat. Het certificaat dat MySQL zelf aanmaakt, voldoet daar niet aan: dan krijg je Peer certificate CN=… did not match expected CN
. Vraag je hostingprovider in dat geval om de juiste hostnaam en het bijbehorende CA-certificaat.
Gebruik voor TLS de hostnaam of het IP-adres van de databaseserver, niet localhost. Met localhost verbindt PHP via een lokale socket, en daarover is TLS niet mogelijk (en ook niet nodig).
MySQLi-verbinding met MySQL over SSL/TLS
Met MySQLi geef je het CA-certificaat op met mysqli::ssl_set(), zet je de certificaatcontrole aan, en maak je de verbinding met real_connect() en de vlag MYSQLI_CLIENT_SSL:
<?php
$db = mysqli_init();
$db->ssl_set( null, null, '/pad/naar/ca.pem', null, null );
$db->options( MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, true );
$db->real_connect( 'db-host', 'gebruiker', 'wachtwoord', 'databasenaam', 3306, null, MYSQLI_CLIENT_SSL );
$db->set_charset( 'utf8mb4' ); PDO-verbinding met MySQL over SSL/TLS
Bij PDO geef je het CA-certificaat en de certificaatcontrole mee als opties:
<?php
$dsn = 'mysql:host=db-host;dbname=databasenaam;charset=utf8mb4';
$db = new PDO( $dsn, 'gebruiker', 'wachtwoord', array(
Pdo\Mysql::ATTR_SSL_CA => '/pad/naar/ca.pem',
Pdo\Mysql::ATTR_SSL_VERIFY_SERVER_CERT => true,
) ); De constanten Pdo\Mysql::ATTR_SSL_CA en Pdo\Mysql::ATTR_SSL_VERIFY_SERVER_CERT bestaan sinds PHP 8.4. Draai je PHP 8.3 of ouder, gebruik dan PDO::MYSQL_ATTR_SSL_CA en PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT. Die oude namen zijn sinds PHP 8.5 verouderd (deprecated) en geven daar een melding.
Waar het CA-bestand staat, verschilt per besturingssysteem. Op Debian en Ubuntu is dat bijvoorbeeld /etc/ssl/certs/ca-certificates.crt. Op Windows heb je zelf een cacert.pem nodig. Hoe je dat netjes oplost voor code die op beide platformen draait, lees je in Cross-platform MYSQL_ATTR_SSL_CA usage in PHP (Engels).
Controleren of de verbinding versleuteld is
Of de verbinding echt versleuteld is, vraag je op met deze query. Krijg je een cipher terug, zoals TLS_AES_256_GCM_SHA384, dan is de verbinding versleuteld. Is de waarde leeg, dan niet:
SHOW SESSION STATUS LIKE 'Ssl_cipher'; Van ext/mysql naar MySQLi
Toen ik dit artikel in 2015 schreef, gebruikten veel websites nog de oude ext/mysql-functies, zoals mysql_connect() en mysql_query(). Die functies waren sinds PHP 5.5 verouderd, en in PHP 7.0 zijn ze verwijderd. Kom je ze nog tegen in een oude website, dan krijg je op een moderne PHP-versie deze foutmelding:
Fatal error: Uncaught Error: Call to undefined function mysql_connect()
Ombouwen naar MySQLi is meestal niet moeilijk. Staat in je scripts bijvoorbeeld dit:
<?php
$conn = mysql_connect( 'db-host', 'gebruiker', 'wachtwoord' );
$db = mysql_select_db( 'databasenaam', $conn );
$result = mysql_query( 'SELECT * FROM artikelen' ); Dan wordt dat met MySQLi:
<?php
$conn = mysqli_connect( 'db-host', 'gebruiker', 'wachtwoord', 'databasenaam' );
$result = mysqli_query( $conn, 'SELECT * FROM artikelen' ); Let op: MySQLi wil de verbinding als éérste parameter, waar die bij ext/mysql vaak de laatste (optionele) parameter was. Staat de verbindingscode in elk script opnieuw? Zet hem dan meteen in één apart bestand dat je overal laadt. En bouw queries met gebruikersinvoer meteen om naar prepared statements. De stap van mysql_real_escape_string() naar mysqli_real_escape_string() maakt je code niet veiliger.
MySQLi-equivalenten voor ext/mysql
mysql_connectwordtmysqli_connect;mysql_select_dbis niet meer nodig, want de database geef je mee aanmysqli_connectmysql_querywordtmysqli_querymysql_fetch_assoc,mysql_fetch_rowenmysql_fetch_arraywordenmysqli_fetch_assoc,mysqli_fetch_rowenmysqli_fetch_arraymysql_num_rowsenmysql_affected_rowswordenmysqli_num_rowsenmysqli_affected_rowsmysql_insert_idwordtmysqli_insert_idmysql_free_resultenmysql_closewordenmysqli_free_resultenmysqli_closemysql_real_escape_stringwordtmysqli_real_escape_string, maar gebruik liever prepared statements
Een uitgebreidere stap-voor-stap-uitleg vind je in mijn artikel Migrate PHP ext/mysql to MySQLi (Engels).
En WordPress?
WordPress gebruikt sinds versie 3.9 MySQLi. Een TLS-versleutelde databaseverbinding stel je daar in met de constante MYSQL_CLIENT_FLAGS in wp-config.php. Lees hoe in WordPress-database opschonen en wp-config.php optimaliseren.
Conclusie
Met MySQLi of PDO maak je vanuit PHP eenvoudig verbinding met MySQL of MariaDB. Gebruik altijd prepared statements voor gegevens van bezoekers, kies utf8mb4 als tekenset, en versleutel de verbinding met TLS als je database op een andere server draait. Staat er nog ergens mysql_connect() in je code? Dan is dit hét moment om die om te bouwen!


Fijn om deze tutorial te lezen en te gebruiken
Dank je wel voor je reactie Stef, fijn te vernemen dat je de tutorial goed kon gebruiken :-)
Bedankt :)
Heel graag gedaan :)