Une application a 3 options pour demander à PECL/mysqlnd_qc si une requête doit être mise en cache ou non. L'approche la plus basique est de mettre en cache toutes les requêtes en définissant mysqlnd_qc.cache_by_default = 1. Cette approche est souvent peu pratique. Mais elle permet aux utilisateurs de prendre conscience rapidement des gains de performance de la mise en cache. Une application prévue pour utiliser un cache doit être capable de préfixer les requêtes sélectionnées avec l'astuce SQL appropriée. Cependant, le fait de modifier le code source d'une application peut ne pas toujours être possible ou désiré, par exemple, pour éviter des problèmes lors des mises à jour logicielles. Aussi, PECL/mysqlnd_qc autorise la définition d'une fonction de rappel qui décide si une requête doit être mise en cache ou non.
La fonction de rappel est installée avec la fonction
mysqlnd_qc_set_is_select(). La fonction de rappel fournit
la chaîne de requête pour chaque requête inspectée par le plugin. Alors, la
fonction de rappel décide de la mise en cache ou non. La fonction de rappel
est supposée retourner FALSE si la requête ne doit pas être mise en cache.
Si la valeur TRUE est retournée, le plugin tentera d'ajouter la requête au cache.
L'entrée du cache prendra le TTL par défaut (
mysqlnd_qc.ttl). Si la fonction de rappel retourne une valeur
numérique, elle sera utilisée comme TTL au lieu de la valeur par défaut.
Exemple #1 Définir une fonction de rappel avec mysqlnd_qc_set_is_select()
mysqlnd_qc.enable_qc=1 mysqlnd_qc.collect_statistics=1
<?php
/* fonction de rappel qui va décider si la requête doit être mise en cache ou non */
function is_select($query) {
static $patterns = array(
/* true - utilisation du TTL par défaut depuis mysqlnd_qc.ttl */
"@SELECT\s+.*\s+FROM\s+test@ismU" => true,
/* 3 - utilisation d'un TTL = 3 secondes */
"@SELECT\s+.*\s+FROM\s+news@ismU" => 3
);
/* vérifie si la requête correspond au masque */
foreach ($patterns as $pattern => $ttl) {
if (preg_match($pattern, $query)) {
printf("is_select(%45s): mise en cache\n", $query);
return $ttl;
}
}
printf("is_select(%45s): pas de mise en cache\n", $query);
return false;
}
/* Installation de la fonction de rappel */
mysqlnd_qc_set_is_select("is_select");
/* Connexion, création et peuplement de la table test */
$mysqli = new mysqli("host", "user", "password", "schema", "port", "socket");
$mysqli->query("DROP TABLE IF EXISTS test");
$mysqli->query("CREATE TABLE test(id INT)");
$mysqli->query("INSERT INTO test(id) VALUES (1), (2), (3)");
/* Mise en cache */
$mysqli->query("SELECT id FROM test WHERE id = 1");
/* Récupération depuis le cache */
$mysqli->query("SELECT id FROM test WHERE id = 1");
/* Mise en cache */
$mysqli->query("SELECT * FROM test");
$stats = mysqlnd_qc_get_core_stats();
printf("Mise en cache : %d\n", $stats['cache_put']);
printf("Récupération depuis le cache : %d\n", $stats['cache_hit']);
?>
Les exemples ci-dessus vont afficher :
is_select( DROP TABLE IF EXISTS test): pas de mise en cache is_select( CREATE TABLE test(id INT)): pas de mise en cache is_select( INSERT INTO test(id) VALUES (1), (2), (3)): pas de mise en cache is_select( SELECT id FROM test WHERE id = 1): mise en cache is_select( SELECT id FROM test WHERE id = 1): mise en cache is_select( SELECT * FROM test): mise en cache Mise en cache : 2 Récupération depuis le cache : 1
La fonction de rappel de cet exemple teste si une chaîne de requête
correspond au masque. Si c'est le cas, elle retournera soit TRUE
pour mettre en cache la requête en utilisant le TTL par défaut,
soit un TTL alternatif.
Pour minimiser les modifications de l'application, la fonction de rappel peut être mise dans un fichier qui sera par la suite inclut dans le script.