New file |
0,0 → 1,146 |
<?xml version="1.0" encoding="iso-8859-1"?> |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
<html xmlns="http://www.w3.org/1999/xhtml"> |
<head> |
<!-- template designed by Marco Von Ballmoos --> |
<title>File Source for Modele.php</title> |
<link rel="stylesheet" href="../media/stylesheet.css" /> |
<meta http-equiv='Content-Type' content='text/html; charset=UTF8'/> |
</head> |
<body> |
<h1>Source for file Modele.php</h1> |
<p>Documentation is available at <a href="../Framework/_Modele.php.html">Modele.php</a></p> |
<div class="src-code"> |
<div class="src-code"><ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li> |
<li><div class="src-line"><a name="a2"></a><span class="src-comm">// declare(encoding='UTF-8');</span></div></li> |
<li><div class="src-line"><a name="a3"></a><span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a4"></a><span class="src-doc">* Classe modèle, donc d'accés au données, elle ne devrait pas être appelée de l'extérieur.</span></div></li> |
<li><div class="src-line"><a name="a5"></a><span class="src-doc">* Elle fait office d'abstraction légère de base de données en utilisant les objects PDO natifs</span></div></li> |
<li><div class="src-line"><a name="a6"></a><span class="src-doc">* de PHP</span></div></li> |
<li><div class="src-line"><a name="a7"></a><span class="src-doc">* Elle est abstraite donc doit obligatoirement être étendue.</span></div></li> |
<li><div class="src-line"><a name="a8"></a><span class="src-doc">*</span></div></li> |
<li><div class="src-line"><a name="a9"></a><span class="src-doc">* PHP Version 5</span></div></li> |
<li><div class="src-line"><a name="a10"></a><span class="src-doc">*</span></div></li> |
<li><div class="src-line"><a name="a11"></a><span class="src-doc">* </span><span class="src-doc-coretag">@category</span><span class="src-doc"> Class</span></div></li> |
<li><div class="src-line"><a name="a12"></a><span class="src-doc">* </span><span class="src-doc-coretag">@package</span><span class="src-doc"> Framework</span></div></li> |
<li><div class="src-line"><a name="a13"></a><span class="src-doc">* </span><span class="src-doc-coretag">@author</span><span class="src-doc"> aurelien <aurelien@tela-botanica.org></span></div></li> |
<li><div class="src-line"><a name="a14"></a><span class="src-doc">* </span><span class="src-doc-coretag">@copyright</span><span class="src-doc"> 2009 Tela-Botanica</span></div></li> |
<li><div class="src-line"><a name="a15"></a><span class="src-doc">* </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL</span></div></li> |
<li><div class="src-line"><a name="a16"></a><span class="src-doc">* </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.gnu.org/licenses/gpl.html Licence GNU-GPL</span></div></li> |
<li><div class="src-line"><a name="a17"></a><span class="src-doc">* </span><span class="src-doc-coretag">@version</span><span class="src-doc"> SVN: $$Id: Modele.php 120 2009-09-01 12:21:14Z aurelien $$</span></div></li> |
<li><div class="src-line"><a name="a18"></a><span class="src-doc">* </span><span class="src-doc-coretag">@link</span><span class="src-doc"> /doc/framework/</span></div></li> |
<li><div class="src-line"><a name="a19"></a><span class="src-doc">*</span></div></li> |
<li><div class="src-line"><a name="a20"></a><span class="src-doc">*/</span></div></li> |
<li><div class="src-line"><a name="a21"></a><span class="src-key">abstract </span><span class="src-key">class </span><a href="../Framework/Modele.html">Modele</a> <span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a22"></a> </div></li> |
<li><div class="src-line"><a name="a23"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a24"></a><span class="src-doc"> * registre global</span></div></li> |
<li><div class="src-line"><a name="a25"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a26"></a> <span class="src-key">private </span><span class="src-var">$registre</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a27"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a28"></a><span class="src-doc"> * DSN pour accéder à la base de données</span></div></li> |
<li><div class="src-line"><a name="a29"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a30"></a> <span class="src-key">private </span><span class="src-var">$dsn</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a31"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a32"></a><span class="src-doc"> * Type de base de données (mysql, mysqli, etc ...)</span></div></li> |
<li><div class="src-line"><a name="a33"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a34"></a> <span class="src-key">private </span><span class="src-var">$type</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a35"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a36"></a><span class="src-doc"> * Hote herbergeant la base de données</span></div></li> |
<li><div class="src-line"><a name="a37"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a38"></a> <span class="src-key">private </span><span class="src-var">$hote</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a39"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a40"></a><span class="src-doc"> * Nom de la base de données à laquelle le modèle doit se connecter</span></div></li> |
<li><div class="src-line"><a name="a41"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a42"></a> <span class="src-key">private </span><span class="src-var">$bdd_nom</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a43"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a44"></a><span class="src-doc"> * Nom d'utilisateur</span></div></li> |
<li><div class="src-line"><a name="a45"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a46"></a> <span class="src-key">private </span><span class="src-var">$utilisateur</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a47"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a48"></a><span class="src-doc"> * Mot de passe</span></div></li> |
<li><div class="src-line"><a name="a49"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a50"></a> <span class="src-key">private </span><span class="src-var">$pass</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a51"></a> </div></li> |
<li><div class="src-line"><a name="a52"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a53"></a><span class="src-doc"> * Encodage de la base de données</span></div></li> |
<li><div class="src-line"><a name="a54"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a55"></a> <span class="src-key">private </span><span class="src-var">$encodage </span>= <span class="src-id">null</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a56"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a57"></a><span class="src-doc"> * Connexion à la base de données</span></div></li> |
<li><div class="src-line"><a name="a58"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a59"></a> <span class="src-key">private </span><span class="src-var">$connexion </span>= <span class="src-id">null</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a60"></a> </div></li> |
<li><div class="src-line"><a name="a61"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a62"></a><span class="src-doc"> * Constructeur par défaut, appelé à l'initialisation.</span></div></li> |
<li><div class="src-line"><a name="a63"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a64"></a> <span class="src-key">final </span><span class="src-key">public </span><span class="src-key">function </span><a href="../Framework/Modele.html#method__construct">__construct</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a65"></a> <span class="src-comm">// les différents paramètres nécessaires sont lus à partir du registre</span></div></li> |
<li><div class="src-line"><a name="a66"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">registre </span>= <span class="src-id"><a href="../Framework/Registre.html">Registre</a></span><span class="src-sym">::</span><a href="../Framework/Registre.html#methodgetInstance">getInstance</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a67"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">type </span>= <span class="src-id"><a href="../Framework/Config.html">Config</a></span><span class="src-sym">::</span><a href="../Framework/Config.html#methodget">get</a><span class="src-sym">(</span><span class="src-str">'bdd_protocole'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a68"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">hote </span>= <span class="src-id"><a href="../Framework/Config.html">Config</a></span><span class="src-sym">::</span><a href="../Framework/Config.html#methodget">get</a><span class="src-sym">(</span><span class="src-str">'bdd_serveur'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a69"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">bdd_nom </span>= <span class="src-id"><a href="../Framework/Config.html">Config</a></span><span class="src-sym">::</span><a href="../Framework/Config.html#methodget">get</a><span class="src-sym">(</span><span class="src-str">'bdd_nom'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a70"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">utilisateur </span>= <span class="src-id"><a href="../Framework/Config.html">Config</a></span><span class="src-sym">::</span><a href="../Framework/Config.html#methodget">get</a><span class="src-sym">(</span><span class="src-str">'bdd_utilisateur'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a71"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">pass </span>= <span class="src-id"><a href="../Framework/Config.html">Config</a></span><span class="src-sym">::</span><a href="../Framework/Config.html#methodget">get</a><span class="src-sym">(</span><span class="src-str">'bdd_mot_de_passe'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a72"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">encodage </span>= <span class="src-id"><a href="../Framework/Config.html">Config</a></span><span class="src-sym">::</span><a href="../Framework/Config.html#methodget">get</a><span class="src-sym">(</span><span class="src-str">'bdd_encodage'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a73"></a> </div></li> |
<li><div class="src-line"><a name="a74"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">dsn </span>= <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">type</span>.<span class="src-str">':dbname='</span>.<span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">bdd_nom</span>.<span class="src-str">';host='</span>.<span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">hote</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a75"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a76"></a> </div></li> |
<li><div class="src-line"><a name="a77"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a78"></a><span class="src-doc"> * Fonction qui appelle la bonne fonction de requete suivant le type de bdd.</span></div></li> |
<li><div class="src-line"><a name="a79"></a><span class="src-doc"> *</span></div></li> |
<li><div class="src-line"><a name="a80"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc">la requete à effectuer</span></div></li> |
<li><div class="src-line"><a name="a81"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">PDOStatement </span><span class="src-doc">un objet contenant le résultat de la requête</span></div></li> |
<li><div class="src-line"><a name="a82"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a83"></a> <span class="src-key">final </span><span class="src-key">protected </span><span class="src-key">function </span><a href="../Framework/Modele.html#methodrequete">requete</a><span class="src-sym">(</span><span class="src-var">$requete</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a84"></a> <span class="src-comm">// on ne se connecte que lors du premier appel à une requete (lazy connexion)</span></div></li> |
<li><div class="src-line"><a name="a85"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">connexion </span>== <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a86"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-id">connecter</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a87"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a88"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">connexion</span><span class="src-sym">-></span><span class="src-id">query</span><span class="src-sym">(</span><span class="src-var">$requete</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a89"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a90"></a> </div></li> |
<li><div class="src-line"><a name="a91"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a92"></a><span class="src-doc"> * Connection à la base de données en utilisant les informations fournies par</span></div></li> |
<li><div class="src-line"><a name="a93"></a><span class="src-doc"> * le fichier de configuration.</span></div></li> |
<li><div class="src-line"><a name="a94"></a><span class="src-doc"> * private et final car n'a pas vocation a être appelée par l'utilisateur.</span></div></li> |
<li><div class="src-line"><a name="a95"></a><span class="src-doc"> *</span></div></li> |
<li><div class="src-line"><a name="a96"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@throws</span><span class="src-doc"> PDOException une exception dans le cas ou là connexion échoue</span></div></li> |
<li><div class="src-line"><a name="a97"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a98"></a> <span class="src-key">final </span><span class="src-key">private </span><span class="src-key">function </span><span class="src-id">connecter</span><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a99"></a> </div></li> |
<li><div class="src-line"><a name="a100"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">connexion </span>= <span class="src-key">new </span><span class="src-id">PDO</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">dsn</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">utilisateur</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">pass</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a101"></a> <span class="src-key">if</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">encodage </span>!= <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a102"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Framework/Modele.html#methodrequete">requete</a><span class="src-sym">(</span><span class="src-str">"SET names '"</span>.<span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">encodage</span>.<span class="src-str">"'"</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a103"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a104"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a105"></a> </div></li> |
<li><div class="src-line"><a name="a106"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a107"></a><span class="src-doc"> * protège une chaine de caractères avant l'insertion dans la base de données</span></div></li> |
<li><div class="src-line"><a name="a108"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a109"></a> <span class="src-key">final </span><span class="src-key">protected </span><span class="src-key">function </span><a href="../Framework/Modele.html#methodproteger">proteger</a><span class="src-sym">(</span><span class="src-var">$chaine</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a110"></a> <span class="src-comm">// on ne se connecte que lors du premier appel à une requete</span></div></li> |
<li><div class="src-line"><a name="a111"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">connexion </span>== <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a112"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-id">connecter</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a113"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a114"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">connexion</span><span class="src-sym">-></span><span class="src-id">quote</span><span class="src-sym">(</span><span class="src-var">$chaine</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a115"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a116"></a> </div></li> |
<li><div class="src-line"><a name="a117"></a> <span class="src-doc">/**</span></div></li> |
<li><div class="src-line"><a name="a118"></a><span class="src-doc"> * Destructeur de classe, se contente de fermer explicitement la connexion</span></div></li> |
<li><div class="src-line"><a name="a119"></a><span class="src-doc"> */</span></div></li> |
<li><div class="src-line"><a name="a120"></a> <span class="src-key">final </span><span class="src-key">public </span><span class="src-key">function </span><a href="../Framework/Modele.html#method__destruct">__destruct</a><span class="src-sym">(</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a121"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">connexion </span>!= <span class="src-id">null</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li> |
<li><div class="src-line"><a name="a122"></a> <span class="src-var">$this</span><span class="src-sym">-></span><span class="src-var">connexion </span>= <span class="src-id">null </span><span class="src-sym">;</span></div></li> |
<li><div class="src-line"><a name="a123"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a124"></a> <span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a125"></a><span class="src-sym">}</span></div></li> |
<li><div class="src-line"><a name="a126"></a><span class="src-php">?></span></div></li> |
</ol></div> |
</div> |
<p class="notes" id="credit"> |
Documentation generated on Wed, 02 Sep 2009 15:47:40 +0200 by <a href="http://www.phpdoc.org" target="_blank">phpDocumentor 1.4.1</a> |
</p> |
</body> |
</html> |