Rechercher une fonction PHP

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

mysqlnd_qc_set_is_select ( string $callback ) : mixed

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.

Retour à la première page de Manuel PHP  Table des matières Haut

Liste de paramètres

Cette fonction ne contient aucun paramètre.

Retour à la première page de Manuel PHP  Table des matières Haut

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Retour à la première page de Manuel PHP  Table des matières Haut

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

Retour à la première page de Manuel PHP  Table des matières Haut

Voir aussi

Rechercher une fonction PHP

Version en cache

22/11/2024 05:10:56 Cette version de la page est en cache (à la date du 22/11/2024 05:10:56) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

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

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

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.

Table des matières Haut