Vous trouverez plus de détails sur la page « Introduction - DSN ».
La première action, avant d'utiliser une base de données, est de s'y connecter.
Pour cela il faut définir un DSN (Data Source Name) qui donnera tous les renseignements sur la base de données à utiliser : nom, utilisateur, mot de passe, machine hébergeant le serveur, type de SGBD, etc. Sa syntaxe (légèrement simplifiée) est la suivante :
type_de_BD://utilisateur:mot_de_passe@machine/base_de_données?option=valeurPar exemple :
Pour une base PostgreSQL :
pgsql://utilisateur:mot_de_passe@localhost/base
Pour une base SQLite, sous linux :
sqlite:////chemin_complet_vers_fichier.db?mode=0666
Pour une base SQLite, sous Windows :
sqlite:///c:/chemin_complet_vers_fichier.db?mode=0666
Il suffit ensuite d'exécuter la commande
$db =& DB::connect(votre_DSN);
Le nom de la variable $db est sans importance. Ce n'est qu'une variable, vous pouvez lui donner le nom qui vous plaît. Il faut seulement garder à l'esprit qu'il faut conserver cette variable (quel que soit son nom), c'est elle qui permettra d'accéder à la base de données avec les fonctions des chapitres suivants.