(PECL mysqlnd_qc >= 1.0.0)
mysqlnd_qc_set_is_select — Installe une fonction de rappel qui décide si une requête doit être mise en cache
Installe une fonction de rappel qui décide si une requête doit être mise en cache.
Il y a plusieurs façons de demander à PELC/mysqlnd_qc de mettre en cache
une requête. Par défaut, PECL/mysqlnd_qc tente de mettre en cache une
requête si la mise en cache de toutes les requêtes est activée ou si
la chaîne de requête commence avec une astuce SQL. Le plugin, en interne,
appèle une fonction nommée is_select()
. Cette fonction
interne peut être remplacée avec une fonction de rappel définie par l'utilisateur.
Ainsi, la fonction de rappel définie par l'utilisateur est responsable
de décider si le plugin tente une mise en cache ou non de la requête.
En raison du fait que la fonction interne est remplacée par la fonction
de rappel, la fonction de rappel a un contrôle total. La fonction de rappel
est libre d'ignorer la directive de configuration
mysqlnd_qc.cache_by_default
ainsi que les astuces SQL.
La fonction de rappel est invoquée pour chaque requête inspectée
par le plugin. Elle prend la chaîne de requête comme paramètre.
La fonction de rappel retourne false
si la requête ne doit pas être
mise en cache. Elle retourne true
pour demander au plugin de tenter
de mettre en cache le jeu de résultats, s'il y en a un.
Une entrée du cache est ainsi créée en utilisant le TTL par défaut
défini par la directive de configuration PHP mysqlnd_qc.ttl
.
Si un TTL différent doit être utilisé, la fonction de rappel doit retourner
une valeur numérique qui sera utilisée comme TTL.
La fonction interne is_select
fait partie de l'interface
interne de gestion de stockage du cache. Aussi, un gestionnaire de stockage
défini par l'utilisateur offre les mêmes possibilités.
Cette fonction ne contient aucun paramètre.
Cette fonction retourne true
en cas de succès ou false
si une erreur survient.
Exemple #1 Exemple avec mysqlnd_qc_set_is_select()
<?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 de la valeur 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;
}
mysqlnd_qc_set_is_select("is_select");
/* Connexion, création et peuplement de la table test */
$mysqli = new mysqli("host", "user", "password", "schema");
$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");
?>
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