Tiens, en tapant le titre, je me disais que je devrais peut-être lui trouver un autre nom que "le framework de ALF-Solution". L'appel est donc lancé ;).

Revenons au sujet qui nous préoccupe. Avant de vraiment pouvoir attaquer l'utilisation du framework, je vais vous parler de l'un ou l'autre module indispensable à connaître pour pouvoir utiliser le framework. Je commencerai donc à vous présenter la manière d'interagir avec la base de données et ensuite l'utilisation du moteur de template pour pouvoir afficher les données.

La base de données

L'utilisation de la base de données va se faire principalement au travers de 3 classes, à savoir DB, Table et TableRow. La première classe va principalement servir pour réaliser la connexion vers la base de données et sera utilisée par les deux autres.

Connexion à la base de données

Pour établir un lien avec la base de données, il suffit d'exécuter les lignes de codes suivantes :

$dblink = new DB(HOST, USER, PASSWORD, DBNAME, TYPEDB);
$dblink->connect();

La première ligne va instancier un objet de type DB. La deuxième ligne va établir la connexion vers la db.

Les paramtères HOST, USER, PASSWORD, DBNAME, TYPEDB sont des constantes préalablement définies comme suit :

define('HOST', 'localhost');
define('USER', 'root');
define('PASSWORD', 'mypassword');
define('DBNAME', 'framework');
define('TYPEDB', 'mysql');

Bien sûr vous pouvez choisir de directement passer les valeurs des constantes à l'appel de l'instanciation de la classe DB, comme-ceci :

$dblink = new DB('localhost', 'root', 'mypassword', 'framework', 'mysql');

mais pour une question de facilité de déclaration et d'éventuel changement des paramètres de connexion à la DB, il est plus facile de déclarer des constants et d'utiliser celles-ci.

Enfin pour que ce exemple simple fonctionne, il faut bien sûr inclure le fichier contenant la classe DB dans votre code, ce qui se fait à l'aide de la ligne suivante :

include_once "./db/DB.php5";

Il est a noter, que le fichier DB.php5 a été mis dans un sous-répertoire pour une simple question d'organisation de notre projet. Voici donc l'exemple complet

/**
 * @author: Pierre Delporte - pierre.delporte@alf-solution.be
 * Date: 1/02/15
 * Time: 13:17
 * @note : aucune garantie n'est données sur le code ci-après.
 * Ce code est donné à titre d'exemple.
 */
include_once "./db/DB.php5";

define('HOST', 'localhost');
define('USER', 'root');
define('PASSWORD', 'mypassword');
define('DBNAME', 'framework');
define('TYPEDB', 'mysql');

$dblink = new DB(HOST, USER, PASSWORD, DBNAME, TYPEDB);
if ( !$dblink->connect()){
    echo 'La connexion à la base de donnée a échouée'
} else {
    echo 'Connexion réussie';
}

 Proposons déjà une première petite amélioration, toute simple, qui consiste à déplacer la déclaration des variables constantes dans un fichier .php séparé. Appelons ce fichier global.php et toujours dans le soucis de bien organiser notre projet, mettons le dans le sous-répertoire que nous nomerons includes. Il reste alors à y faire référence, via la ligne de commande :

/* Inclure le fichier avec les variables globales au projet */
include_once "./db/DB.php5";

Voici l'exemple modifié dans sa totalité

/**
 * @author: Pierre Delporte - pierre.delporte@alf-solution.be
 * Date: 1/02/15
 * Time: 13:17
 * @note : aucune garantie n'est données sur le code ci-après.
 * Ce code est donné à titre d'exemple.
 */
/* Inclure le fichier avec les variables globales au projet */
include_once "./db/DB.php5";
/* Inclure la classe de connexion à la base de données */
include_once './includes/global.php';

$dblink = new DB(HOST, USER, PASSWORD, DBNAME, TYPEDB);
if ( !$dblink->connect()){
    echo 'La connexion à la base de donnée a échouée'
} else {
    echo 'Connexion réussie';
}

 Vous pouvez aussi télécharger le projet via ce lien (13 Ko).