Router pour pattern MVC

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 :)

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 ;)

Bonjour,

J'ai testé ce routeur sur un développement de test, il fonctionne correctement et est pratique d'utilisation :ccool:

Petit bémol toutefois quand j'ai voulu testé la fonctionnalité multilingue. Elle possède un petit bug, ne permet pas d'envoyer une série de variables aussi facilement qu'avec les règles de routage du mode non multilingue (nécessite obligatoirement un couple "nom/valeur") et aucun outil n'est fourni pour créer le tableau qui alimente la fonction setControllerTraduction. Certes à chacun sa préférence pour la manière de créer ce tableau mais une petite proposition aurait été pratique, ne serait-ce que pour faire des tests plus confortablement et rapidement.
Je ferai une proposition avec des fonctionnalités plus avancées pour le mode multilingue dans un prochain post.

Concernant le petit bug (toujours pour le mode multilingue) qu'il convient de corriger c'est en gras, $this->controller est redéfini une première fois puis réutilisé par la suite (alors qu'il conviendrait d'utiliser la valeur initiale) :

Code:

---

1 2 3 4 5 6 7 8 9 10 11 12 13

//Permet d'avoir des URL multilingue if(!empty($this->tradController)){ if(isset($this->tradController[$this->codeLangue][$this->controller]['controllerName'])){ $controller = $this->tradController[$this->codeLangue][$this->controller]['controllerName']; if(!empty($controller)) $this->controller = $controller; // Ici } if(isset($this->tradController[$this->codeLangue][$this->controller]['actionsNames'][$this->action])){ // Ici $action = $this->tradController[$this->codeLangue][$this->controller]['actionsNames'][$this->action]; // Ici if(!empty($action)) $this->action = $action; } }

---

Enfin bon à part le mode multilingue qu'il conviendrait d'étoffer un peu, ce petit routeur fait bien son travail :)

Merci pour ton retour.
Je t'avoue que la version multilangue avait été développée en coup de vent pour un projet mais finalement jamais testée , donc du coup doit y'avoir pas mal de chose à revoir ^^

Si jamais tu veux apporter une correction tu peux toujours faire un pull request sur github :
https://github.com/grunk/Pry

C'est le projet complet du framework mais tu trouvera le router ici dans Pry/Controller