Programmer avec SPIP 3.0
Documentation technique sur SPIP 3.0

> > > > sql_get_select

sql_get_select

La fonction sql_get_select() retourne la requête de sélection demandée. C’est un alias de la fonction sql_select() mais qui envoie l’argument $option à false, de sorte la requête SQL au lieu d’être exécutée est retournée.

Elle prend les mêmes arguments que sql_select() hormis le dernier qui est renseigné par la fonction :

  1. $select,
  2. $from,
  3. $where,
  4. $groupby,
  5. $orderby,
  6. $limit,
  7. $having,
  8. $serveur

Elle s’utilise comme ceci :

  1. $requete = sql_get_select('colonne', 'table');
  2. // retourne "SELECT colonne FROM table" (avec MySQL)

Télécharger

On récupère ainsi une requête SQL valide pour le gestionnaire de base de données utilisé. Comme cette requête est propre, elle peut être utilisée directement par la fonction sql_query(), mais plus souvent, elle sert à créer des sous requêtes en association avec sql_in() :

  1. // liste d'identifiants
  2. $ids = sql_get_select('id_table', 'tableA');
  3. // selection en fonction de cette selection
  4. $resultats = sql_select('titre', 'tableB', sql_in('id_table', $ids)));

Télécharger

Exemple

Pour obtenir tous les titres de rubriques dont les identifiants d’articles sont supérieurs à 200, une des méthodes possibles (on pourrait aussi utiliser une jointure) est d’utiliser sql_get_select() :

  1. // creer la requete de selection donnant la liste des rubriques
  2. $ids = sql_get_select('DISTINCT(id_rubrique)', 'spip_articles', array('id_article > 200'));
  3. // selectionner ces rubriques
  4. $res = sql_select('titre', 'spip_rubriques', sql_in('id_rubrique', $ids));
  5. while ($r = sql_fetch($res)) {
  6. // afficher le titre.
  7. echo $r['titre'] . '<br />';
  8. }

Télécharger

De façon bien plus complexe, on trouve des exemples dans certaines fonctions de critères, par exemple dans le critère {noeud} du plugin « SPIP Bonux » qui crée une sous requête pour récupérer la liste des objets ayant des enfants.

  1. function critere_noeud_dist($idb, &$boucles, $crit) {
  2. // [...]
  3. // cette construction avec IN fera que le compilateur demandera
  4. // l'utilisation de la fonction sql_in()
  5. $where = array("'IN'", "'$boucle->id_table." . "$primary'", "'('.sql_get_select('$id_parent', '$table_sql').')'");
  6. if ($crit->not)
  7. $where = array("'NOT'", $where);
  8.  
  9. $boucle->where[]= $where;
  10. }

Télécharger