[PHP 5.2] Router pour pattern MVC

[grunk]

Je vous propose aujourd'hui une classe permettant de mettre en place très simplement le pattern MVC.
Cette classe est un router chargée de rediriger les requêtes reçues vers le bon controller et la bonne action.
Les parties vue et modèles ne sont ici pas abordée, afin que chacun puissent faire comme il l'entend. Le but est de proposer une solution très simple pour débuter.

Les fonctionnalités du router :

• Url propre du type http://monsite.com/nomController/nom...mParamN/paramN
• Gestion de sous dossier : Pas besoin d'être à la racine d'un serveur ou d'un vhost
• Support des règles de routages.
• Prise en charge d'un paramètre de langue supplémentaire en option : http://monsite.com/codeLangue/nomController/nomAction/
• Support d'url multilingue : http://monsite.com/fr/accueil/index et http://monsite.com/en/home/index pourront mener au même endroit
• Possibilité d'avoir un niveau de profondeur supplémentaire dans le dossier des controllers : /controller/sousdossier/monController.php

Utilisation

Quelque soit l'utilisation vous devrez avoir un htacces qui redirige toutes les requêtes via votre index.php :

Code :

1
2
3
 
RewriteEngine on
RewriteRule !\.(js|ico|gif|jpg|JPG|png|css)$ index.php

Format d'un controller

Afin d'utiliser le router, il faut respecter quelques règles pour les controller :

nom : le nom doit être de la forme : nomController , par exemple : indexController ou encore errorController
Paramètre : le constructeur du controller reçoit deux paramètres du routeur : la liste des paramètres passé par l'url et optionnellement le code langue
methode : Un controller doit impérativement avoir une méthode index();

Utilisation basique :

Code :

1
2
3
4
5
6
7
 
require 'Router.class.php';
 
$router = Router::getInstance();
//Définition du dossier contenant les controlleur
$router->setPath('controller/');
$router->load();

Ajout de controller et d'action de base

Code :

1
2
3
4
5
6
7
8
9
10
11
 
require 'Router.class.php';
 
$router = Router::getInstance();
//Définition du dossier contenant les controlleur
$router->setPath('controller/');
// Si aucun controller n'est spécifié on appèlera accueilController et sa méthode index()
$router->setDefaultController('accueil','index');
// En cas d'url invalid on appèlera le controller errorController et sa méthode alert()
$router->setErrorControllerAction('error', 'alert'); 
$router->load();

Définir une règle de routage

Code :

1
2
3
4
5
6
7
8
9
10
 
require 'Router.class.php';
 
$router = Router::getInstance();
//Définition du dossier contenant les controlleur
$router->setPath('controller/');
// L'url http://monsite.com/actualites/archives/2012/01/PHP sera redirigé vers
// actualitesController et sa méthode index(). Les paramètres annee, mois , catégorie seront passer au controller par le routeur.
$router->addRule('actualites/archives/:annee/:mois/:categorie', array('controller' => 'actualites', 'action' => 'index'));
$router->load();

Je laisse volontairement de coté la partie multilangue pour le moment que je n'ai pas assez testé. Si elle vous intéresse il suffira de jeter un oeil au code , son utilisation est documentée.

Je suis preneur de toutes les critiques que vous pourrez faire

[Benjamin Delespierre]

Il faut que je regarde en détail mais à vue de nez il n'est pas très différent du mien (sauf peut être pour les règles de routage qui son un poil plus élaborées).
Pour ceux que ça intéresse c'est par ici: https://github.com/bdelespierre/php-...uter.class.php

Sinon tu peux remplacer ta règle de réécriture par:

Code :

1
2
3
4
5
6
7
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !favicon.ico$
    RewriteRule ^(.*)$ index.php?url=$1 [QSA,L]
</IfModule>

ça t'évite de devoir spécifier toutes les extensions du monde à la main