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.
Liste de paramètres
Cette fonction ne contient aucun paramètre.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
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