CMS Lite


Accès à une base de données externe

Page classée dans : Infos techniques à propos de ce site    •    Auteur : Quintilien    •    Dernière mise à jour : 2024-10-28
Page précédente : Installer le site : le fichier config.ini
Page suivante : Un dernier mot sur les aspects techniques

Depuis la version 4.7.0, cette fonction est une option : elle n'est pas installée par défaut, ni sur ce site de démonstration. Pour l'activer, depuis le répertoire de l'installation :

cp options/external-database/install/public/extdb.php public/
cp options/external-database/install/data/base_de_donnees_bouquins.db data/

puis ajouter la ligne external_db_allowed décrite ci-dessous à config/config.ini. Mode d'emploi complet : options/external-database/README.fr.md dans le dépôt.

Pour qu'une base de données "externe" soit accessible par le site

  1. Le fichier config.ini doit contenir une ligne reprenant

    • le mot-clé external_db_allowed =

    • la description de la base de données

    • le chemin et le nom du fichier

    • les noms des deux "vues" (view) associées (voir explications plus loin)

  2. Les différents éléments de la ligne doivent être séparés par une virgule.

Exemple

external_db_allowed = Bouquins, ../data/base_de_donnees_bouquins.db , vue_collections, vue_detail_titre

Remarque : dans le cas où on souhaite accéder à plusieurs bases de données externes, il suffit de rajouter des lignes dans le config.ini en suivant la même syntaxe.

Les bases de données externes sont accessibles (en lecture seulement) au travers de deux "vues" (view) qui doivent être préalablement définies dans la base de données

  • la première vue correspond à l'affichage d'un tableau qui contient autant de lignes qu'il y a d'enregistrements à afficher ;

  • il est possible de trier par ordre ascendant ou descendant en cliquant sur le titre des colonnes.

  • la seconde vue correspond à ce qui doit être affiché quand on sélectionne un enregistrement en cliquant sur une des lignes de la liste

Note

  • La première colonne de chaque vue est l'identifiant unique de la fiche ; dans la vue de détail, elle doit s'appeler id.

  • L'identifiant n'est pas affiché dans la liste (la première colonne est masquée).

Exemple de base de données externes relative à des titres regroupés en collections

TABLE "titres"

"id"	INTEGER NOT NULL UNIQUE,
"nom"	TEXT,
"parution"	INTEGER,
"fk_collection"	INTEGER,
"note"	TEXT DEFAULT '',
PRIMARY KEY("id" AUTOINCREMENT),
FOREIGN KEY("fk_collection") REFERENCES "collections"("id")

TABLE "collections"

"id"	INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT UNIQUE,
"titre"	TEXT

VIEW "vue_collections"

CREATE VIEW vue_collections AS 
SELECT  * FROM (
SELECT titres.id,  titres.nom AS Titre,  collections.titre AS "Collection",  titres.parution AS Parution
FROM titres
INNER JOIN collections ON collections.id = titres.fk_collection
)

VIEW "vue_detail_titre"

CREATE VIEW vue_detail_titre AS 
SELECT 
titres.id		,  
titres.nom AS 'Titre',  
collections.titre AS 'Collection', 
titres.parution AS 'Parution', 
titres.note AS 'Notes'
FROM titres
INNER JOIN collections ON collections.id = titres.fk_collection
ORDER BY titres.nom


 ↑  Retourner en début de page
← Page précédente : Installer le site : le fichier config.ini
→ Page suivante : Un dernier mot sur les aspects techniques