Je ne suis pas un fan inconditionné des Frameworks PHP, ces derniers peuvent parfois s’avérer trop lourds pour certaines applications. L’apprentissage d’un framework PHP peut être fastidieu, et la documentation n’est pas toujours au rendez-vous.

Puis un jour, j’ai découvert CodeIgniter ! Je vous propose un tour d’horizon de ce framework à travers le développement d’un petit CRM. Nous verrons ainsi comment intégré CodeIgniter et comment tirer parti de ces nombreux avantages.

Notes de versions : Cette article est amené à évolué. Etant mon premier tutoriel CodeIgniter, vos remarques et toute critique pouvant améliorer cet article seront les bienvenues

Version 0.1 du 20 Juillet 2010

L’application présentée dans ce tutoriel n’a pas pour vocation d’être utilisée en production mais une version plus élaborée et complète sera prochainement disponible sur ce site.

I – Framework PHP

Définition d’un Framework (Source Wiki) :

En programmation informatique, un framework est un kit de composants logiciels structurels, qui définissent les fondations ainsi que les grandes lignes de l’organisation de tout ou partie d’un logiciel (architecture). En programmation orientée objet un framework est typiquement composé de classes mères qui seront dérivées et étendues par héritage en fonction des besoins spécifiques à chaque logiciel qui utilise le framework.

Les framework sont utilisés pour modeler l’architecture des logiciels applicatifs, des applications web, des middleware et des composants logiciels. Les framework sont achetés par les ingénieurs, puis ajoutés comme partie intégrante des logiciels applicatifs mis sur le marché, ils sont par conséquent rarement achetés et installés séparément par un utilisateur final.

Des tentatives de francisation du terme ont été faites. On trouve ainsi parfois les termes cadre d’applications, proposé par l’Office québécois de la langue française ou cadriciel. L’expression atelier de développement est également employée.

Un framework est un ensemble d’outils et de composants logiciels organisés conformément à un plan d’architecture et des design patterns. L’ensemble forme un squelette de programme. Il est souvent fourni sous la forme d’une bibliothèque logicielle, et accompagné du plan de l’architecture cible du framework.Avec un framework orienté objets, le programmeur qui utilise le framework pourra personaliser les éléments principaux du programme par extension, en utilisant le mécanisme d’héritage: créer des nouvelles classes qui contiennent toutes les fonctionnalités que met en place le framework, et en plus ses fonctionnalités propres, créées par le programmeur en fonction des besoins spécifiques à son programme. Le mécanisme d’héritage permet également de transformer des fonctionnalités existant dans les classes du framework.

Un framework est conçu en vue d’aider les programmeurs dans leur travail. L’organisation du framework vise la productivité maximale du programmeur qui va l’utiliser – gage de baisse des coûts de construction du programme. Le contenu exact du framework est dicté par le type de programme et l’architecture cible pour lequel il est concu.

2°) Les avantages d’un Framework

Recyclage du code : Le code est réutilisable, ceci signifie qu’il n’est plus nécessaire de coder 4 ou 5 fois la même chose pour des projets différents

Fiabilité : Le code de ces Frameworks sont testés et maintenus par une grande communauté de développeurs.

Débogage : le frameworks PHP ont leurs propres méthodes de débogage spécifiques qui vous permettent de repérer facilement les erreurs dans votre développement.

Aide communautaire: Vous ne jamais se sentir seul alors que le codage de ces cadres. Lorsque vous jamais ressenti aucune pression, vous pouvez demander de l’aide dans les communautés. Il ya bon nombres de développeurs, qui va sûrement aider dans votre développement.

Note : Pour plus d’information, je vous invite à consulter le livre blanc « frameworks php pour l’entreprise » que vous pourrez découvrir à l’adresse suivante : http://www.clever-age.com/veille/publications/developpement-specifique/livre-blanc-frameworks-php-pour-l-entreprise.html (envoi après demande par mail).

II – Présentation de CodeIgniter

1°) Sur le site de l’éditeur :

CodeIgniter est un framework PHP puissant avec un très faible encombrement, construit pour les codeurs PHP qui ont besoin d’une boîte à outils simple et élégante pour créer des applications web complet. Si vous êtes un développeur qui vit dans le monde réel de l’hébergement mutualisé et des comptes clients avec des délais, et si vous êtes fatigué de cadres de grandes lourdement et de manière approfondie sans-papiers

J’ai choisi de diffuser cette définition car elle représente assez bien ce qu’est CodeIgniter. Si vous avez déjà testé Zend Framework ou encore Symphonie, vous allez rapidement vous rendre compte de ces petites différences qui font de CodeIgniter un Framework Simple, Intuitif et rapide à mettre en oeuvre.

2°) Quelques références

Vous trouverez une liste plus complète d’applications et de sites réalisés avec CodeIgniter mais si vous voulez voir tout de suite ce qu’il est possible de faire avec ce Framework, voici quelques ressources :

• http://www.club-3d.com/
• http://www.bambooinvoice.org/
• http://ionizecms.com/

3°) Resources

Une des forces de CodeIgniter (comme tout bon framework) est représenté par sa communauté et plus particulièrement sa communauté Française. Vous pouvez consulter les ressources « Françaises » à l’adresse suivante : http://codeigniter.fr/. Vous y trouverez la documentation, des tutoriels, ScreenCasts et un forum.

Si vous souhaitez plus de ressource, le site principal de CodeIgniter accessible à l’adresse suivante : http://codeigniter.com/

II – Introduction à CodeIgniter

1°) Préparation du projet

Lancer votre IDE puis créez un nouveau projet à la racine de votre serveur WEB « crmIgniter » (j’utilise AptanaIDE)

2°) Téléchargement & installation

La première chose à faire, consiste à télécharger le Framework qui est matérialiser par une archive téléchargeable à l’adresse suivante : http://codeigniter.com/download.php

Une fois téléchargé cette archive, vous pouvez l’extraire. Après extraction, vous découvrirez deux dossiers :

• Un dossier system
• Un dossier user_guide

Déplacez l’ensemble de son contenu dans votre répertoire « crmIgniter » de sorte que votre fichier « index.php » soit à la racine de votre projet (figure 2.1.1).

Figure 2.2.1 - Contenu du repertoire crmIgniter

Regardons d’un peu plus prêt la structure du Framework et plus particulièrement le dossier « system » qui contient entre autre :

• Le dossier « codeigniter » correspond au Framework lui-même
• Le dossier « application » dans lequel sera stocké notre application
• Le dossier « helpers » regroupant des outils de manipulation PHP
• Le dossier « librarie » regroupant des bibliothèques de fonctions PHP

CodeIgniter est un Framework développé selon  le principe du MVC – Model View Controller. Je vous renvoie à l’adresse suivante pour la définition complète de ce qu’est le MVC : http://dico.developpez.com/html/3020-Conception-MVC-Model-View-Controller.php

Ouvrons maintenant notre dossier « application » et détaillons son contenu :

• Le dossier « config » qui contient nos données de configuration
• Le dossier « controllers » contenant des fichiers de class qui sont liés à nos URL
• Le dossier « view » correspondant aux vues

Comme un exemple vaut mieux qu’un grand discourt, tapez l’adresse suivant dans votre navigateur « http://localhost/crmIgniter/index.php/welcome/ ». Après avoir validé l’URL, vous devriez voir s’afficher la page de bienvenue (figure 2.2.2)

Figure 2.2.2 - Page de bienvenue CodeIgniter

Essayons de comprendre… nous avons une URL dont le trigger est « welcome », le contrôleur portant le même nom va s’executer. Regardons de plus prêt le contenu du fichier « /controllers/welcome.php » :

Code PHP :

<?php

class Welcome extends Controller {

 function Welcome()
 {
 parent::Controller();
 }

 function index()
 {
 $this->load->view('welcome_message');
 }
}

/* End of file welcome.php */
/* Location: ./system/application/controllers/welcome.php */

Ce fichier est une class et la fonction principale « index() » execute l’action « load->view ». Nous somme donc dans un contexte POO. Le « $this » définie notre application, en somme, nous pourrions traduire celas par « Mon application charge la vue ‘welcome_message’.

Si nous regardons à l’intérieur de notre dossier « view », nous devrions trouver un fichier « welcome_message.php ». En ouvrant ce fichier, nous pouvons consulter le code HTML qui le compose.

III – Notions de bases

1°) Modèle MVC

Le Modèle-Vue-Contrôleur (en abrégé MVC, de l’anglais Model-View-Controller) est une architecture et une méthode de conception qui organise l’interface homme-machine (IHM) d’une application logicielle. Ce paradigme divise l’IHM en un modèle (modèle de données), une vue (présentation, interface utilisateur) et un contrôleur (logique de contrôle, gestion des événements, synchronisation), chacun ayant un rôle précis dans l’interface. Cette méthode a été mise au point en 1979 par Trygve Reenskaug, qui travaillait alors sur Smalltalk dans les laboratoires de recherche Xerox PARC.

Pour faire plus simple, il s’agit simplement d’un model qui sépare la présentation du code.

Figure 3.1.1 - Organisation MVC

2°) Chargement des vues et URL

Le schéma de fonctionnement dans CodeIgniter est le suivant :

Le contrôleur principal analyse l’URL et va charger une vue, cette vue étant exécutée par une fonction

IV – Tutoriel Projet crmIgniter – Réalisation d’un CRM avec CodeIgniter

Introduction et notes : La réalisation de cette application se fait dans le cadre d’un tutoriel et n’a pas pour vocation à être mis en production. Le code est à vocation didacticiel et n’est pas optimisé ni sécurisé. Ce tutoriel évoluera au fil de l’application et servira de base à d’autres articles.

1°) Configuration

Nous allons commencer à configurer notre projet. Pour cela, ouvrez le dossier ‘application/config/’ dans votre éditeur.  ce dossier contient l’ensemble des fichiers de configuration. Nous allons commencer par éditer notre fichier ‘config.php’. Vous devez simplement renseigner / modifier les élements de ce fichier. J’ai simplement modifier l’URL de base :

$config['base_url']    = "http://localhost/crmIgniter/";

Configurons maintenant notre base de données. Dans un premier temps, créez une base de données MySql « crmIgniter », ne créz pas de table pour le moment, nous verrons cela ultérieurement.

Ouvrez votre fichier « application/config/database.php » puis  renseignez les éléments de ce fichier.

$active_group = "default";
$active_record = TRUE;

$db['default']['hostname'] = "localhost";
$db['default']['username'] = "root";
$db['default']['password'] = "";
$db['default']['database'] = "crmIgniter";
$db['default']['dbdriver'] = "mysql";
$db['default']['dbprefix'] = "";
$db['default']['pconnect'] = TRUE;
$db['default']['db_debug'] = TRUE;
$db['default']['cache_on'] = FALSE;
$db['default']['cachedir'] = "";
$db['default']['char_set'] = "utf8";
$db['default']['dbcollat'] = "utf8_general_ci";

/* End of file database.php */
/* Location: ./system/application/config/database.php */

Nous reviendrons ultérieurement sur ces fichiers de configuration.

2°) Les contrôleur CodeIgniter

Un contrôleur est simplement une class qui est nommée dans le but d’être chargée en fonction d’une URL.

L’exemple suivant : « http://www.monsite.com/articles/

chargera la class « articles ». Ce contrôleur devra contenir des fonctions permettant de charger des vues. Par défaut, la fonction « index() » chargera la vue par défaut

class articles{
    function index(){
    //Code à executer
    }
}

Il est possible de charger un contrôleur par défaut, cette opération peut se faire en éditant le fichier « application/config/routes.php »

$route['default_controller'] = 'articles';

Il vous est possible de passer des segments d’URL dans vos fonctions :

example.com/index.php/products/shoes/sandals/123

<?php
class Products extends Controller {

function shoes($sandals, $id)
{
echo $sandals;
echo $id;
}
}
?>

3°) Les vues CodeIgniter

Une vue est simplement une page WEB ou un fragment de page WEB. Cette vue est chargée par le contrôleur en relation avec L’URL

Code HTML – Exemple du contenu d’une vue

code

Nous l’avons vu précédemment, cette vue est chargée par le contrôleur et la fonction qui permet de charger une vue est la suivante :

<?php
class Blog extends Controller {

 function index()
 {
 $this->load->view('blogview');
 }
}
?>

Il vous est possible de charger plusieurs vues si nécessaire.

Vous pouvez également transférer des données à votre vue depuis votre contrôleur.

$data = array(
 'title' => 'My Title',
 'heading' => 'My Heading',
 'message' => 'My Message'
 );

 $this->load->view('blogview', $data);

ou encore :

<?php
class Blog extends Controller {

 function index()
 {
 $data['title'] = "My Real Title";
 $data['heading'] = "My Real Heading";

 $this->load->view('blogview', $data);
 }
}
?>

Enfin, CodeIgniter utilise une façon particulière de boucler les données d’un tableau

<?php
class Blog extends Controller {

 function index()
 {
 $data['todo_list'] = array('Clean House', 'Call Mom', 'Run Errands');

 $data['title'] = "My Real Title";
 $data['heading'] = "My Real Heading";

 $this->load->view('blogview', $data);
 }
}
?>

Code HTML

<html>
<head>
<title><?php echo $title;?></title>
</head>
<body>
<h1><?php echo $heading;?></h1>

<h3>My Todo List</h3>    

<ul>
<?php foreach($todo_list as $item):?>

<li><?php echo $item;?></li>

<?php endforeach;?>
</ul>

</body>
</html>

Vous pouvez si vous le souhaiter utiliser une syntaxe classique.

4°) Les helpers

Les helpers sont des bibliothèques de fonctions qui permettent de manipuler des données ; il en existe plusieurs sortes, on peut citer entre autre le helper « url » permettant de manipuler les chaines d’URL ou encore l’helper « email » permettant de manipuler les chaines d’email.

Il existe différentes façon de charger ces helpers, soit un par un ou via un tableau si vous devez en charger plusieurs. Cette opération est exécutée dans le constructeur de vos models.

class maClass extends Controller{
    function maClass(){
        parent::Controller();
        $this->load->helper('url');
        $this->load->helper('email');
    }
}

est équivalent à

class maClass extends Controller{
    function maClass(){
        parent::Controller();
        $this->load->helpers(aray('url','email'));
    }
}

Dans le cadre de mon application, je vais avoir besoin de manipuler différents types de données, voici les helpers que je vais charger :

function home(){

 //Constructeur
 parent::Controller();

 //Chargement des helpers
 $this->load->helpers(
 array(
 'url',
 'email',
 'array',
 'html',
 'date',
 'form'
 ));

 }

La documentation CodeIgniter étant très bien réalisé, n’hésitez pas à consulter cette dernière pour en savoir plus sur les helpers.

5°) URL Rewriting ou comment modifier les URL CodeIgniter

Note : Cette section impose que votre serveur Apache soit configuré pour accépter « l’URL Rewriting », si ce n’est pas le cas, vous devez activer le module d’URL Rewriting. Si vous souhaitez en savoir plus sur l’URL Rewriting, voici quelques ressources :

http://www.urlrewriting.fr/

http://codeigniter.com/user_guide/general/urls.html

Comme vous avez pu le remarquer, pour accéder à notre page « home », nous avons une URL de ce type :  http://localhost/crmIgniter/index.php/home/. Nous allons voir comment modifier l’URL d’accès et avoir une URL plus propre. Ceci peut être réalisé en utilisant une règle simple, qui est stocké dans un fichier nommé « .Htaccess » .

Ce que le. Htaccess nous permet de faire, c’est créer une série de règles. Alors tout d’abord, vous devez créer un fichier nommé. Htaccess à la racine de votre application WEB (ou dans le répertoire où vous avez index.php).

Saisissez le code ci-dessous dans votre fichier « .htaccess » :

Code du fichier htaccess :

DirectoryIndex index.php
RewriteEngine on
RewriteCond $1 !^(index\.php|images|css|js|robots\.txt|favicon\.ico)
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ ./index.php/$1 [L,QSA]

Quelques explications :

• On défini l’index
• Activation du moteur de réécriture
• Défini les conditions de réécriture
• Active les régles de réécriture

Vous pouvez tester et entrer l’URL « http://localhost/crmIgniter/home/ » dans votre navigateur.

La dernière étape cosniste à modifier notre fichier de configuration et plus particulièrement la section « $config['index_page'] = « index.php »; – il suffit d’effacer « index.pp » afin de laisser vide la valeur de notre « index_page ». Ceci aura pour effet de retirer les « index.php/ » dans nos liens.

6°) Création d’un template CodeIgniter.

A ce stade, nous devons à chaque chargement de fichier répéter nos en-tête, nos footer… Ceci n’est pas très pratique l’orsque l’on a l’habitude d’utiliser un système de pseudo Frame ou de charger des templates. Nous allons donc créer un système de template.

Etape 1 – Création du contrôleur principal

Créez un fichier application.php dans votre répertoire contrôleur, ce fichier nous servira de contrôleur principal :

Code du contrôleur principal :

<?php
class application extends Controller{

//Constructeur
function application(){
parent::Controller();
}

//Function index
function index(){
$this->load->view('template');
}
}

Vous pouvez ensuite créer la vue principale relative à notre contrôleur, dans notre exemple il s’agit du fichier template.php :

Code du fichier template.php

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
$this->load->view('crmContent');
$this->load->view('crmFooter');
?>

Dernière étape, créer les différents blocs qui composent notre template :

• crmHeader
• crmNav
• crmContent
• crmFooter

Code du fichier crmHeader :

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>crmIgniter - CodeIgniter CRM Application</title>
<meta name="description"
 content="crmIgniter - un CRM réalisé avec le Framework PHP CodeIgniter" />
 <base href="http://localhost/crmIgniter/" />
<link href="design/style.css" type="text/css" rel="stylesheet" />
<link href="js/jQuery/css/ui-lightness/jquery-ui-1.8.2.custom.css"/>
<script type="text/javascript" src="js/jQuery/js/jquery-1.4.2.min.js"></script>
<script type="text/javascript" src="js/jQuery/js/jquery-ui-1.8.2.custom.min.js"></script>
</head>
<body>
<div id="header">
<h1>crmIgniter</h1>
<h2>CodeIgniter CRM</h2>
</div>

Code du fichier crmNav

<div id="crmNav">
<ul>
 <li><a href="users" title="Gestion des utilisateurs">Utilisateurs</a></li>
 <li><a href="accounts" title="Gestion des comptes">Comptes</a></li>
 <li><a href="business" title="Gestion des affaires">Affaires</a></li>
</ul>
</div>

Code du fichier crmContent

<div id="content">
<h3>Contenu de l'application...</h3>
</div>

Code du fichier crmFooter

<div id="footer">
<p>&copy; - openWab &amp; CodeIgniter - crmIgniter 2010 - <a href="mailto:#">Contact</a></p>
</div>
</body>
</html>

Vous l’aurez compris, il n’y aura plus qu’à modifier les fichier de contenu (matérialisé ici par le fichier crmContent.php).

Note : Il existe d’autres méthodes mais j’ai souhaité vous présenter celle là dans un premier temps afin de vous expliquer la structure du projet. Si vous le souhaitez, il existe une librairie réalisée par un utilisateur de CodeIgniter permettant l’intégration de vues partielles. Vous pouvez consulter les informations relatives à cette librairie sur le Forum de CodeIgniter : http://codeigniter.com/forums/viewthread/62366/

Voici le résultat en image (figure 4.6.1):

Figure 4.6.1 - Interface principale crmIgniter

7°) Syntaxe alternative des vues

CodeIgniter vous permet d’utiliser une syntaxe alternative dans vos vues en lieu et place du « <?php echo [variable ou fonction]; ?>

Vous pouvez utiliser la syntaxe suivante :

<?=$variable?>

Note : Avant de pouvoir utiliser cette fonction, il est nécessaire d’activer les « Short tag » dans le php.ini.

<?=$variable?>

D’autres syntaxes sont disponibles notamment en ce qui concerne les structures de contrôle

<ul>

 <?php foreach($todo as $item): ?>

 <li><?=$item?></li>

 <?php endforeach; ?>

 </ul>

Reportez-vous à la documentation si vous souhaitez utiliser les syntaxes courtes : http://codeigniter.com/user_guide/general/alternative_php.html

8°) Notre module Utilisateurs

Nous allons dans cette section créer notre premier module. Nous nous intéresserons au module utilisateurs qui permet entre autre de lister, créer ou modifier les utilisateurs.

Étape 1 – Création du contrôleur et des vues

Dans votre dossier contrôleur, créez un fichier « users.php », ce sera notre contrôleur principal dont voici le code :

<?php
class users extends Controller{

 function users(){
 parent::Controller();

 }

 function index(){
 $this->load->view('users_module');
 }
}

Rien de spécifique, ce module va simplement charger la vue « users_module » que nous allons créer. Cette vue va simplement lister les actions pouvant être executées.

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
?>
<div id="content">
<a href="users/add_user/" title="nouvel utilisateur">Nouvel utilisateur</a>
<a href="users/list_users/" title="Liste des utilisateurs">Liste des utilisateurs</a>
</div>
<?php
$this->load->view('crmFooter');
?>

Nous allons maintenant modifier notre contrôleur en y ajoutant une fonction « add_user » :

<?php
class users extends Controller{

 function users(){
 parent::Controller();

 }

 function index(){
 $this->load->view('users_module');
 }

 function add_user(){
 $this->load->view('user_add_new');
 }
}

Créez maintenant la vue « user_add_new »

Code du fichier user_add_new.php :

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
?>
<h3>Nouvel utilisateur::</h3>
<p>Cette interface vous permet d'ajouter un nouvel utilisateur</p>
<p><a href="users/">retour</a></p>
<?php
$this->load->view('crmFooter');
?>

Cliquez sur le lien « Nouvel utilisateur » et vous devriez voir notre nouvelle vue.

Vous pouvez réaliser les mêmes opération pour la vue « list_users » ; vous trouverez ci-dessous les différents codes dont notre contrôleur complet.

<?php
class users extends Controller{

 function users(){
 parent::Controller();

 }

 //Fonction index chargeant la vue par défaut
 function index(){
 $this->load->view('users_module');
 }

 //Fonction add_user permettant d'ajouter un utilisateur
 function add_user(){
 $this->load->view('user_add_new');
 }

 //Fonction list_user listant les utilisateurs
 function list_users(){
 $this->load->view('users_list');
 }

 //Fonction update_user pour modifier un utilisateur
 function update_user(){
 $this->load->view('user_update');
 }

 //Fonction user_delete supression d'un utilisateur
 function delete_user(){
 $this->load->view('user_delete');
 }
}

Etape 2 – Création du formulaire d’ajout d’utilisateur

Ouvrez votre fichier user_add_new.php, nous allons réaliser notre formulaire d’ajout de données puis réaliser l’enregistrement dans notre base de données :

Avant toute chose, veillez à charger les helper « Form » ; ce helper permet la manipulation de formulaires.Ce helper vous permet entre autre de générer des formulaires et des champs de formulaires. Vous trouverez ci-dessous le code de notre fichier « user_add_new » :

<?php
//Initialisation des attributs du formulaire
$formAtt = array('id'=>'add_user','class'=>'standardForm');

//Overture du formulaire
echo form_open("",$formAtt);

//Ajout d'un champ hidden
echo form_hidden("id",'');

//Labels + Champs de type texte
echo form_label("Nom d'utilisateur : ");
echo form_input('username');
echo form_label("Mot de passe : ");
echo form_input('password');

//Initialisation des valeurs d'un dropdown (select)
$titles = array(
 'Madame'=>'Madame',
 'Mademoiselle'=>'Mademoiselle',
 'Monsieur'=>'Monsieur'
);
echo form_label("Civilité : ");
echo form_dropdown("title",$titles);

echo form_label("Nom : ");
echo form_input('name');
echo form_label("Prénom : ");
echo form_input('subname');
echo form_label("Email : ");
echo form_input('mail');
echo form_label("Fonction : ");
echo form_input('role');

//Génération du bouton submit
echo form_submit("add_user","Enregistrer");

//Fermeture du formulaire
echo form_close()
?>

Voici le code HTML généré par l’utilisation du helper et des fonctions qui y sont liées :

Code HTLM généré :

<form action="http://localhost/crmIgniter/" method="post" id="add_user"
 class="standardForm">
<input type="hidden" name="id" value="" />
<label>Nom d'utilisateur : </label>
<input type="text" name="username" value="" />
<label>Mot de passe : </label><input type="text" name="password" value="" />
<label>Civilité: </label>
<select name="title">
 <option value="Madame">Madame</option>
 <option value="Mademoiselle">Mademoiselle</option>
 <option value="Monsieur">Monsieur</option>
</select>
<label>Nom : </label>
<input type="text" name="name" value="" />
<label>Prénom: </label>
<input type="text" name="subname" value="" />
<label>Email : </label><input type="text" name="mail" value="" />
<label>Fonction : </label>
<input type="text" name="role" value="" />
<input type="submit" name="add_user" value="Enregistrer" />
</form>

Note : Je n’ai pas testé l’efficacité de ce helper en terme de performance mais son utilisation peut faire gagner un peu de temps en terme de développement.

Voici le résultat en image (Figure 4.8.1) :

Figure 4.8.1 - Formulaire ajout d'un utilisateur

Étape 3 – Traitement du formulaire

Reste à récupérer les données et à les insérer dans notre formulaire. Pour cela, nous allons utilise la class « database », il est don cnecessaire de l’initialiser dans notre contrôleur :

//Chargement de la class database
$this->load->database();

Ensuite, nous pouvons l’utiliser simplement en stockant les données de notre formulaire dans un tableau :

<?php
//Traitement des données du formulaire

//Récupération des variables post
if(isset($_POST['add_user'])){
 $newUser = array(
 'id'=>$_POST['id'],
 'username'=>$_POST['username'],
 'password'=>sha1($_POST['password']),
 'title'=>$_POST['title'],
 'name'=>$_POST['name'],
 'subname'=>$_POST['subname'],
 'mail'=>$_POST['mail'],
 'role'=>$_POST['role']
 );
 //Insert
 $this->db->insert('users', $newUser); 

 echo '<p>Enregistrement inséré</p>';
}

?>

Etape 4 – Lister des données

Comme vous avez pu le voir, les opérations sur les bases de données sont facilité avec l’utilisation de cette class. Nous allons voir comment lister des données provenant de notre base de données. Pour cela, nous utiliserons la class « pagination », cette class permet de générer facilement des pages de résultats et une navigation entre ses pages.

La première étape consiste à initialiser nos bibliothèque. Voici le code du Contrôleur « users » dans lequel j’ai initialiser deux librairies. La librairie « pagination » pour naviguer entre les pages et la librairie « table » qui va nous permettre d’afficher nos résultats dans un tableau.

//Chargement de la librairie pagination
 $this->load->library('pagination');

 //Chargement de la librairie table
 $this->load->library('table');

Une fois ses paramètres initialisés, nous pouvons les utiliser à travers différentes méthodes et options. Vous trouverez ci-dessous le code de notre fonction « users_list() » de notre contrôleur « users ».

//Fonction list_user listant les utilisateurs
 function list_users(){

 //Chargement de la librairie table
 $this->load->library('table');

 //Chargement de la librairie pagination
 $this->load->library('pagination');

 //Défini l'URL de base
 $config['base_url'] = 'http://localhost/crmIgniter/users/list_users/';

 //Initialise le nombre total d'enregistrements
 $config['total_rows'] = $this->db->get('users')->num_rows();

 //Initialise le nombre d'enregistrements à afficher par page
 $config['per_page'] = '10';
 $config['num_links'] = '10';
 $config['full_tag_open'] = '<p>';
 $config['full_tag_close'] = '</p>';

 //Initialisation de notre pagination
 $this->pagination->initialize($config);        

 //Execution de la requête - Voir documentation http://codeigniter.com/user_guide/database/active_record.html
 $this->db->select('id,title,name,subname,mail');
 $data['records'] = $this->db->get('users',$config['per_page'],$this->uri->segment(3));

 //Chargement de la vue et transfert des données à notre vue
 $this->load->view('users_list',$data);

 }

Quelques explication :

1. Chargement de nos librairies.
   1. L’url sert à indiquer au script après quels éléments il devra insérer le numéro d’enregistrement
   2. On récupére le nombre total d’enregistrement afin de calculer le nombre de page
   3. On configure le nombre d’enregistrement par page
   4. On  configure le nombre maximum de liens à afficher
   5. On configure les balises qui engloberons nos liens de pagination
   6. Initialisation globale de notre pagination
2. Exécution de la requête
3. Chargement de la vue

Il ne reste plus qu’à exécuter cela dans notre vue, ouvrez votre vue « users_list.php » et éditez le code comme ci-dessous

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
?>
<h3>Liste des utilisateurs::</h3>
<div>
<?php

//Initialisation des en-tête de notre tableau
echo $this->table->set_heading('ID','Titre','Nom','Prénom','Email');

//Initialisation de notre tableau
echo $this->table->generate($records);//Données récupérées de $data['records'] du contrôleur

//Initialisation de la pagination
echo $this->pagination->create_links();

?>
</div>
<?php
$this->load->view('crmFooter');
?>

Quelques explications :

1. Chargement de notre template
2. Initialisation des en-têtes de notre tableau set_heading()
3. Initialisation du tableau
4. Initialisation de la pagination
5. Chargement du footer

Nous pouvons maintenant afficher nos résultats. Le tableau n’est pas mis en forme mais vous pouvez déjà naviguer dans votre tableau. Reste à appliquer un beau CSS à notre table.

Vous trouverez en figure 4.8.2 le résultat obtenu :

Figure 4.8.2 - Tableau et pagination générés avec la class HTML Table et pagination de CodeIgniter

Etape 5 – Modification d’enregistrement

Nous allons voir ici comment modifier un enregistrement mais avant cela, nous allons voir comment récupérer nos résultats sans l’utilisation de la Class « htm_table ».

Dans notre contrôleur « users.php », nous avons une fonction permettant de récupérer les résultats de notre et nous les passons dans notre vue à l’aide de la variable $data['records']. Nous allons utiliser ces données pour créer un tableau.

//Execution de la requête - Voir documentation http://codeigniter.com/user_guide/database/active_record.html
$this->db->select('id,title,name,subname,mail');
$data['records'] = $this->db->get('users',$config['per_page'],$this->uri->segment(3));

Dans un premier temps, nous allons initialiser les données dans notre vue puis boucler les résultats.

Voici le code de notre vue users_list.php:

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
?>
<h3>Liste des utilisateurs::</h3>
<div>
<table>
 <thead>
 <tr>
 <th>ID</th>
 <th>Titre</th>
 <th>Nom</th>
 <th>Prénom</th>
 <th>Mail</th>
 <th>Options</th>
 </tr>
 </thead>
 <tbody>
 <?php
 //Récupération des enregitrements sous forme de tableau
 $rows = $records->result_array();

 //Boucle les enregistrements et création du lien de modification
 foreach($rows as $k => $v){
 echo "<tr>
 <td>$v[id]</td>
 <td>$v[title]</td>
 <td>$v[name]</td>
 <td>$v[subname]</td>
 <td>$v[mail]</td>
 <td><a id=\"$v[id]\" class=\"updateRecord\" href=\"users/update_user/$v[id]\" title=\"Modifier l'enregistrement\">Modifier</a></td>
 </tr>";
 }
 ?>
 </tbody>
 <tfoot>
 <tr>
 <td colspan="6"><?php
 echo $this->pagination->create_links();
 ?></td>
 </tr>
 </tfoot>
</table>
</div>
 <?php

 $this->load->view('crmFooter');
 ?>

<script type="text/javascript">
$("tr:odd").css('background','#f5f5f5');
</script>

Notre tableau est maintenant créé et nous pouvons naviguer entre les différentes pages. J’ai ajouté une nouvelle colonne « Options » qui me permet d’effectuer des actions en cliquant sur un lien. Ici, c’est un lien qui déclenchera ma fonction ‘update_user’ et qui est suivi de l’identifiant (figure 4.8.3).

Figure 4.8.3 - Table de mise à jour de données

La structure d’une URL CodeIgniter est la suivante :

« example.com/class/function/ID »

Créez une nouvelle vue « user_update.php » et placez y le code suivant :

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
?>
<h3>Mise à jour d'un utilisateur</h3>

<?php
$this->load->view('crmFooter');
?>

En cliquant sur le lien vous devriez lancer la vue « user_update.php ».

Il ne reste plus qu’à créer notre formulaire de modification, pour cela, nous allons utiliser la class « database ». Voici étape par étape les opérations à réaliser :

Récupéré l’ID de notre enregistrement à modifier

Exécuter la requête nous permettant de récupérer l’enregistrement souhaité

Générer le formulaire

Envoyer et traiter le formulaire pour mise à jour de la base de données

Commençons…

Nous devons récupérer l’ID de l’enregistrement ; rappelez-vous, dans le script précédent, celui qui affiche la liste des utilisateurs, nous avons généré des liens qui passent l’ID de l’utilisateur dans l’URL :

<a id=\$v[id]\" class=\"updateRecord\" href=\"users/update_user/$v[id]\" title=\"Modifier l'enregistrement\">Modifier</a>

Notre URL après avoir cliqué sur un lien ressemblera donc à cela :

http://localhost/crmIgniter/users/update_user/10

Rappelons nous la structure de notre URL :

http://localhost/crmIgniter/[Class]/[Fonction]/[ID]

Pour récupérer notre ID, nous allons utiliser la class « URI Class » qui permet de manipuler nos chaines d’URL et ce que nous pouvons appeler des « Segments ». Cette class met à notre disposition une fonction « uri->segment() » ; Cette fonction attend en paramètre le N° de segment que vous souhaitez récupérer.

Que se passe t’il si dans mon fichier « user_update.php » je met le code suivant ?

code//Récupération de l'ID
$id = $this->uri->segment(3);
echo $id;

Et bien j’affiche le Segment correspondant à mon ID soit l’ID à récupérer

Maintenant que nous avons récupérer notre ID, il ne nous reste plus qu’à récupérer les données de notre table. Pour cela nous utiliserons Activ_record.  CodeIgniter utilise une version modifiée de la class « activ_record ». activ_record est un model d’accès et de traitement des bases de données permettant de manipuler les données.

Pour modifier un enregistrement la fonction est la suivant « $this->db->update([table],[données]);

Vous trouverez ci-dessous le code commenté de notre fichier user_update.php.

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
?>
<h3>Mise à jour d'un utilisateur</h3>
<div><?php
//Récupération de l'ID
$id = $this->uri->segment(3);
echo "Id actif : $id<br/>";
$query = $this->db->get_where('users', array('id' => $id));
$activUser = $query->result_array();
$activUser = $activUser[0];
echo '<pre>'."\n";
print_r($activUser);
echo '</pre>'."\n";

/**
 * Ici commence le formulaire
 * On utilise le form helper pour générer le formulaire +
 * les inputs
 */
echo form_open('users/update_user/'.$id);
echo form_label('Nom d\'utilisateur : ');
echo form_input('username',$activUser['username']);
echo form_label('Civilié : ');
$options = array();
echo form_dropdown('title',array('Madame'=>'Madame','Mademoiselle'=>'Mademoiselle','Monsieur'=>'Monsieur'),$activUser['title']);
echo form_label('Nom : ');
echo form_input('name',$activUser['name']);
echo form_label('Prénom : ');
echo form_input('subname',$activUser['subname']);
echo form_label('Email : ');
//Un tableau permettant de passer des attributs à notre input
$mailData = array(
 'name'        => 'mail',
 'id'          => 'mail',
 'value'       => $activUser['mail'],
 'maxlength'   => '200',
 'size'        => '50',
 'style'       => 'width:300px'
);
echo form_input($mailData);
echo form_submit('update_user','Enregistrer les modifications');
echo form_close();

/**
 * Récupération des données - Traitement du formulaire
 */
if(isset($_POST['update_user'])){
 echo "Formulaire soumis :: Traitement de la mise à jour...<br/>";
 //Passage des données récupérées dans un tableau
 $data = array(
 'username' => $_POST['username'],
 'title' => $_POST['title'],
 'name' => $_POST['name'],
 'subname' => $_POST['subname'],
 'mail' => $_POST['mail']
 );
 //Sélection de l'enregistrement à modifier
 $this->db->where('id',$id);
 //Modification de l'enregistrement
 $this->db->update('users',$data);
}
?>
</div>
<?php
$this->load->view('crmFooter');
?>

Les figures ci-dessous vous montre en image les actions réalisées (Figures 4.8.4, 4.8.5, 4.6).

Figure 4.8.4 - Formulaire de mise à jour utilisateur

Figure 4.8.5 - Base de données avant la mise à jour

Figure 4.8.7 - Base de données après la mise à jour

Étape 6 – Suppression d’un enregistrement

La suppression d’un enregistrement suivra le même chemin à la différence prêt que nous utiliserons la fonction « $this->db->delete('mytable', array('id' => $id));" de la class activ_record.

Il suffit pour cela d’ajouter un lien de suppression à notre liste d’utilisateurs et d’y lier encore une fois l’ID de l’utilisateur. Le lien pointera sur la fontion « delete_user() » de notre contrôleur.

<a id=\$v[id]\" class=\"deleteRecord\" href=\"users/delete_user/$v[id]\" title=\"Supprimer l'enregistrement\">Supprimer</a>

Notre vue contiendra simplement notre fonction de suppression :

<?php
$this->load->view('crmHeader');
$this->load->view('crmNav');
?>
<h3>Supression d'un utilisateur : </h3>
<?php
$id = $this->uri->segment(3);
if(isset($_POST['confirm_delete'])){
 $this->db->delete('users', array('id' => $id));
 echo "<p class=\"confirm\">L'enregsitrement N° $id a bien été supprimé ! </p>\n";
}else{
 ?>
 <!-- Formulaire -->
 <form action="" method="post">
 <p>Etes vous sur de vouloir supprimer l'enregistrement N° <?=$id?> de la table utilisateurs ?</p>
 <input type="submit" name="confirm_delete" value="Confirmer"/>
 </form>
 <?php
}
?>
<?php
$this->load->view('crmFooter');
?>

V – Conclusion

Vous venez de voir comment utiliser dans les grandes lignes le Framework CodeIgniter. En conclusion on peut remarquer différents points forts :

• L’utilisation du model MVC
• Des class et des helpers facilitant grandement le développement d’application WEB
• Une documentation riche
• La facilité d’intégrer ses propres librairies et extensions

CodeIgniter est donc un Framework très intéressant ne demandant pas un trop long apprentissage.

VI – Ressources

Applications développées avec CodeIgniter

68KB – Script de base de données de connaissances

BackendPro Control Panel : Application permettant de gérer la partie administration d’un site ou d’une application

Blogmer : Blog script qui se veut simple d’utilisation et convivial et dont les fonctions sont essentielles

Ionize CMS : Un puissant gestionnaire de contenu réalisé avec CodeIgniter

Sites développés avec CodeIgniter

Vous trouverez la liste des sites réalisés avec CodeIgniter à l’adresse suivante : http://codeigniter.com/projects/

Documentation & Tutoriels

Documentation principale : http://codeigniter.com/user_guide/

Tutoriels Vidéo : http://codeigniter.com/tutorials/

Wiki : http://codeigniter.com/wiki/

Ressource CodeIgniter : http://codeigniterdirectory.com/