Fichier ecrire/base/trouver_table.php

Gestion de l'obtention des descriptions de tables SQL

Source

Proposer une amélioration

Liste des fonctions

APIs

Cela sert notamment au moment de la compilation des boucles, critères et balise.

Les champs et clés de la tables sont retrouvés prioritairement via le gestionnaire de base de données. Les descriptions sont complétées, pour les tables éditoriales, des informations déclarées ou construites par la déclaration des objets éditoriaux.

array | boolean base_trouver_table_dist( string $nom , string $serveur = '' , boolean $table_spip = true )

Paramètres

  1. string $nom

    Nom de la table Vide '' demande de vider le cache des discriptions

  2. string $serveur = ''

    Nom du connecteur

  3. boolean $table_spip = true

    Indique s'il faut transformer le préfixe de table

Retour

  • array | boolean

    false si table introuvable tableau de description de la table sinon, en particulier :

    • field : tableau des colonnes SQL et leur description (comme dans serial.php ou objets.php)
    • key : tableau des KEY (comme dans serial.php ou objets.php)
    • table et tablesql : nom de la table (avec spip en préfixe)
    • id_table : nom SPIP de la table (type de boucle) le compilateur produit FROM $r['table'] AS $r['id_table']

    • Toutes les autres informations des objets éditoriaux si la table est l'un d'eux.

API

Exemples

  • $trouver_table = charger_fonction('trouver_table', 'base');
    $desc = $trouver_table('spip_groupes_mots');

    Cette fonction intervient à la compilation, mais aussi pour la balise contextuelle EXPOSE ou certains critères.
    L'ensemble des descriptions de table d'un serveur est stocké dans un fichier cache/sql_desc.txt par soucis de performance. Un appel avec $nom vide est une demande explicite de vidange de ce cache

Voir également

Utilisé par

Package

Proposer une amélioration