mysqlnd_qc_set_is_select

(PECL mysqlnd_qc >= 1.0.0)

mysqlnd_qc_set_is_selectInstalle une fonction de rappel qui décide si une requête doit être mise en cache

Description

mixed mysqlnd_qc_set_is_select ( string $callback )

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

LoadingChargement en cours