mysqlnd_qc_set_is_select
(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
Description
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.
Exemples
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
Voir aussi
- Configuration de l'exécution
- mysqlnd_qc.ttl
- mysqlnd_qc.cache_by_default
- mysqlnd_qc_set_user_handlers() - Définit les fonctions de rappel pour un gestionnaire de stockage procédural défini par l'utilisateur
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.mysqlnd-qc-set-is-select.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.