FramElem : mon framework PHP pas à pas - 3. Réécriture d'URL et routage

Un billet blog de CinéPhil

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# .htaccess 
# Accès contrôlé au site et réécriture d'URL 
#  
# @author 	Philippe Leménager 
# @version 	V0.1 - plemenager - 2019-06-25 - Création 
# 
# Historique : 
# 
# 
  
# Réécriture d'URL 
# Exemple : lesite.com/fr/Accueil/changerLangue/en => index.php?langue=fr&module=Accueil&action=changerLangue&param=en 
RewriteRule ^([a-zA-Z]+)\/([a-zA-Z]+)\/([a-zA-Z_]+)\/(.+)$ index.php?langue=$1&module=$2&action=$3&param=$4 [L] 
  
# Règle idem sans le paramètre final 
RewriteRule ^([a-zA-Z]+)\/([a-zA-Z]+)\/([a-zA-Z_]+)$ index.php?langue=$1&module=$2&action=$3 [L]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<?php 
namespace application\controllers; 
  
/** 
 * 
 * @author philippe 
 *         
 */ 
class Routeur 
{ 
  
	/** 
	 */ 
	public function __construct() 
	{} 
  
	/** 
	 */ 
	function __destruct() 
	{} 
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<?php 
namespace application\controllers; 
  
/** 
 * Routeur des requêtes http vers le bon contrôleur à exécuter. 
 *  
 * @filesource 	application/controllers/ 
 * @author 		Philippe Leménager 
 * @version 	V0.1 - plemenager - 2019-06-26 - Création 
 */ 
class Routeur 
{ 
  
	/** 
	 * Constructeur 
	 */ 
	public function __construct() 
	{} 
  
	/** 
	 * Destructeur 
	 */ 
	function __destruct() 
	{} 
} 
?>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
class Routeur 
{ 
	/**  
	 * Langue applicable  
	 * @var string 
	 */ 
	private $langue; 
  
	/**  
	 * Module où se trouve l'action à lancer 
	 * @var string 
	 */ 
	private $module; 
  
	/** 
	 * Action à lancer 
	 * @var string 
	 */ 
	private $action; 
  
	/** 
	 * Paramètre(s) éventuel(s) 
	 * @var string 
	 */ 
	private $parametres; 
  
	/** 
	 * Constructeur 
	 */ 
	public function __construct() 
	{}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
		/** 
	 * Destructeur 
	 */ 
	function __destruct() 
	{} 
  
	/** 
	 * Retourne le code de la langue à utiliser. 
	 * @return string 
	 */ 
	public function getLangue() 
	{ 
		return $this->langue; 
	} 
  
	/** 
	 * Affecte le code de la langue à utiliser au routeur 
	 * @param string $langue 
	 */ 
	public function setLangue($langue) 
	{ 
		$this->langue = $langue; 
	} 
  
	/** 
	 * Retourne le nom du module 
	 * @return string 
	 */ 
	public function getModule() 
	{ 
		return $this->module; 
	} 
  
	/** 
	 * Affecte le module au routeur 
	 * @access private 
	 * @param string $module 
	 */ 
	private function setModule($module = 'Accueil') 
	{ 
		$this->module = $module; 
	} 
  
	/** 
	 * Retourne l'action demandée 
	 * @return string 
	 */ 
	public function getAction() 
	{ 
		return $this->action; 
	} 
  
	/** 
	 * Affecte l'action demandée au routeur 
	 * @access private 
	 * @param string $action 
	 */ 
	private function setAction($action) 
	{ 
		$this->action = $action; 
	} 
  
	/** 
	 * Retourne la liste des paramètres éventuels donnés par l'URI 
	 * @return string 
	 */ 
	public function getParametres() 
	{ 
		return $this->parametres; 
	} 
  
	/** 
	 * Affecte les paramètres éventuels de l'URI au routeur 
	 * @access private 
	 * @param string $parametres 
	 */ 
	private function setParametres($parametres) 
	{ 
		$this->parametres = $parametres; 
	}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
	/** 
	 * Instancie le contrôleur requis et lance l'action demandée 
	 */ 
	public function appelerAction() 
	{ 
		// Construction du chemin vers la classe de l'action 
		$classeControleur = 'application\\modules\\'.$this->getModule().'\\controllers\\'.$this->getAction(); 
  
		// Instanciation de la classe contrôleur de l'action 
		$controleur = new $classeControleur(); 
  
		// Appel de la méthode par défaut de toute classe d'action 
		$controleur->index(); 
	}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
	/** 
	 * Constructeur 
	 */ 
	private function __construct() 
	{ 
		// Décomposition de l'URI renvoyée par .htaccess 
  
		if(empty($_REQUEST)) 
		{ 
			// Si pas de REQUEST => accès direct à la page d'accueil du site 
			$this->setLangue('fr'); // Langue par défaut = français 
			$this->setModule('Accueil'); 
			$this->setAction('Accueil'); 
		} 
		else 
		{ 
			// Une REQUEST a été demandée 
			$this->setLangue($_REQUEST['langue']); 
			$this->setModule($_REQUEST['module']); 
			$this->setAction($_REQUEST['action']); 
  
			if(isset($_REQUEST['param'])) 
			{ 
				$this->setParametres($_REQUEST['param']); 
			} 
		} 
	} // Fin function __construct()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
class Routeur 
{ 
	/**  
	 * Instance du singleton Routeur  
	 * @staticvar Routeur 
	 */ 
	private static $instance = null; 
  
// Déclaration des autres attributs 
  
	/** 
	 * Constructeur lancé par getInstance() 
	 * @access private 
	 */ 
	private function __construct() 
	{ 
// ... 
	} // Fin private function __construct() 
  
	/** 
	 * Destructeur 
	 */ 
	function __destruct() 
	{} 
  
	/** 
	 * Permet l'instanciation du singleton Routeur 
	 * @return Routeur 
	 */ 
	public static function getInstance() 
	{ 
		if(is_null(self::$instance)) 
		{ 
			self::$instance = new self; 
		} 
  
		return self::$instance; 
	}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
<?php 
/** 
 * Point d'accès unique dans le site. 
 * 
 * Traite l'URL appelée par l'utilisateur et oriente vers le contrôleur correspondant 
 * 
 * @filesource	index.php 
 * @author		Philippe Leménager 
 * @version		V0.2 - 2019-07-02 - plemenager - Ajout du lancement du routeur et affichage provisoire des erreurs PHP. 
 */ 
  
 /* Historique : 
  * V0.1 - 2019-06-20 - plemenager - Création 
  */ 
  
// Affichage des erreurs 
// TODO à supprimer en prod 
ini_set('display_errors', 1); 
error_reporting(E_ALL); 
  
// Ajout d'un slash final au répertoire racine du site 
define('DIR_ROOT', __DIR__.DIRECTORY_SEPARATOR); 
  
/** 
 * Autoloader des classes en suivant les namespaces. 
 * 
 * Code fourni par rawsrc (https://www.developpez.net/forums/blogs/32058-rawsrc/b5109/autoloader/) 
 * 
 * @param string $full_class_name : Nom complet de la classe (avec son espace de nom) 
 */ 
$autoloader = function($full_class_name) 
{ 
	// on prépare le terrain : on remplace le séparateur d'espace de nom par le séparateur de répertoires du système 
	$name = str_replace('\\', DIRECTORY_SEPARATOR, $full_class_name); 
  
	// on construit le chemin complet du fichier à inclure : 
	// il faut que l'autoloader soit toujours à la racine du site : tout part de là avec __DIR__ 
	$path = DIR_ROOT.$name.'.php'; 
  
	// on vérfie que le fichier existe et on l'inclut 
	// sinon on passe la main à un autre autoloader (return false) 
	if (is_file($path)) 
	{ 
		include $path; 
	} 
	else 
	{ 
		return false; 
	} 
}; 
  
// On enregistre la fonction dans le registre d'autoload 
spl_autoload_register($autoloader); 
  
/** 
 * Lancement du routeur et appel de l'action demandée ou par défaut 
 */ 
use application\controllers\Routeur; 
Routeur::getInstance()->appelerAction(); 
?>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
<?php 
namespace application\modules\Accueil\controllers; 
  
/** 
 * Classe contrôleur de l'accueil du site 
 *  
 * @filesource	application/modules/Accueil/controllers/Accueil.php 
 * @author 		Philippe Leménager 
 * @version 	V0.1 - plemenager - 02/07/2019 - Création       
 */ 
class Accueil 
{ 
  
	/** 
	 */ 
	public function __construct() 
	{} 
  
	/** 
	 */ 
	function __destruct() 
	{} 
} 
?>

1
2
3
4
5
	public function index() 
	{ 
		// FIXME Affichage provisoire du masque des pages du site (à modifier plus tard) 
		require DIR_ROOT.'application/views/page.phtml'; 
	}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<?php 
/** 
 * Gabarit général des pages web. 
 * 
 * @filesource  page.phtml 
 * @author              Philippe Leménager 
 * @version             V0.2 - 2019-07-02 - plemenager - Affichage d'un texte provisoire pour tests 
 */ 
  
/* Historique : 
 * @version             V0.1 - 21 juin 2019 - plemenager - Création 
 */ 
?> 
<!DOCTYPE html> 
<html> 
<head> 
	<title>FramElem - Accueil</title> 
	<meta charset="utf-8" /> 
	<meta name="description" lang="fr" content="FramElem - Un framework PHP élémentaire" /> 
	<meta name="keywords" lang="fr" content="FramElem, framework, PHP" /> 
	<meta name="author" lang="fr" content="Philippe LEMÉNAGER" /> 
	<meta name="viewport" content="width=device-width"> 
	<link rel="stylesheet" href="Public/css/general.css" type="text/css"> 
</head> 
<body> 
<div id="header"> 
	<!-- Contient l'en-tête de la page --> 
</div> 
<div id="content"> 
	<!-- Contient les informations publiées par le site --> 
	<h1>FramElem : un framework PHP élémentaire !</h1> 
	<p>Ceci est un affichage provisoire à fins de tests.</p> 
</div> 
<div id="footer"> 
	<!-- Contient le pied de page !--> 
</div> 
</body> 
</html>

1
2
[root@localhost ~]# cd /var/www/html 
[root@localhost html]# ln -s /home/philippe/eclipse-workspace/framelem framelem