Manuel Pear

Niveau superieur
Sommaire

Tutoriel

Tutoriel -- Un petit guide d'utilisation de Auth_PrefManager

Mettre en place la base de données

La première étape est de mettre en place la base de données qui va acceuillir les données. Pour ce tutorial, on considére que vous connaissez déjà les bases de l'utilisation de la classe PEAR DB.

Pour créer la table par défaut, exécutez la requète sql suivante :

Exemple 34-1. SQL pour créer la table

CREATE TABLE `preferences` (
`user_id` varchar( 255 ) NOT NULL default '',
`pref_id` varchar( 32 ) NOT NULL default '',
`pref_value` longtext NOT NULL ,
PRIMARY KEY ( `user_id` , `pref_id` )
);

Mettre en place votre premier objet PrefManager

Pour utiliser Auth_PrefManager, nous devons d'abord créér une instance de l'objet de base, comme présenté ci-dessous.

Exemple 34-2. Mettre en place l'objet

  1. <?php
  2.    require_once('Auth/PrefManager.php'); 
  3.    $dsn = 'mysql://utilisateur:motdepasse@localhost/database'; // Changez le DSN selon votre SGBD.
  4.    $options = array('serialize' => true);               // Activer la sérialisation des données sauvegardée, cela assure qu'elle seront retrouvée proprement.
  5. $prefmanager = new Auth_PrefManager($dsn, $options); // Création de l'objet.
  6.  
  7. ?> 

Fixer et mettre en place les preferences par défaut

Maintenant que nous avons l'objet PrefManager, nous pouvons l'utiliser pour fixer certaines valeurs.

Pour ce tutorial nous allons permettre aux utilisateurs de spécifier leur pays, et considérer que tout utilisateur qui n'a pas choisi de pays est quelque part sur la terre.

Premièrement nous devons fixer les valeurs en utilisant setDefaultPref.

Exemple 34-3. Mettre en place l'objet

  1. <?php
  2. // Continued from example 1.
  3. $prefmanager->setDefaultPref("country", "Earth");  
  4.  
  5. ?> 

Maintenant que les valeurs par défaut sont données, nous pouvons créer une page (très) basique, pour accueillir les utilisateurs avec un message personalisé.

Actuellement le message "Bienvenue aux habitant de la planète!" ne sera plus affiché qu'aux utilisateurs n'ayant pas configuré leur pays.

Exemple 34-4. Utilisation de la personalisation

  1. <?php
  2. $username = "guest";  
  3. <h1>Bienvenue aux habitant du/de  
  4. <?php echo $prefmanager->getPref($username, 'country')?>!</h
  5. ?> 

Fixer les préférences d'un utilisateur

Finalement, nous avons besoin de donner aux gens un moyen de choisir le pays dans le quel ils sont.

Cela va être fait avec un simple text box, et vous devriez évidemment faire un peu plus attention dans une vraie application au sujet des permissions aux utilisateurs de fixer les préférences des autres personnes!

Le bouton "Reset Country" va éffacer la personalisation de l'utilisateur, et provoquer le réaffichage du message par défaut.

Exemple 34-5. Définition des préférences

  1. <?php
  2. <h1>Attribuer un pays</h1>  
  3. // Permettre aux utilisateurs de choisir leur pays et nom d'utilisateur.
  4. if (isset($_POST['submit'])) {  
  5. $username = htmlspecialchars($_POST['username']);  
  6. $prefmanager->setPref($username, 'country', $_POST['country']);  
  7. } else if (isset($_POST['reset'])) {  
  8. $username = htmlspecialchars($_POST['username']);  
  9. $prefmanager->deletePref($username, 'country');  
  10. } else {  
  11. $username = 'invité';  
  12. }  
  13. ?>
  14. <h1>
  15. Bienvenue aux habitants de/du
  16. <?php echo $prefmanager->getPref($username, 'country')?>!
  17. </h1>
  18. <h2>Indiquez votre nom d'utilisateur et votre pays</h2>
  19. <form method="post" action="<?php echo htmlspecialchars($_SERVER['PHP_SELF']) ?>">
  20. <label for="username">Nom d'utilisateur</label>
  21. <input name="username" value="<?php echo $username?>" />
  22. <br />
  23. <label for="country">Pays</label>
  24. <input name="country" value="<?php echo $prefmanager->getPref($username, 'country')?>"/><br />
  25.  
  26. <input type="submit" name="submit" value="Choisi le pays" />
  27. <input type="submit" name="reset" value="Reset le pays" />
  28. </for
  29. ?> 

Maintenant, chaque nouvel utilisateur encodera son nom d'utilisateur, et son pays, Et quand il se connectera, il recevra un accueil personnalisé.

Le code source complet

Exemple 34-6. Le code source de la page d'exemple

  1. <?php
  2. <h1>Fixer le pays</h1>  
  3. <?php  
  4. require_once('Auth/PrefManager.php');  
  5.  
  6. // Création de l'objet PrefManager
  7. $dsn = 'mysql://user:password@localhost/database'; // Changer le dsn pour celui de votre base.
  8. $options = array('serialize' => true);         // Activer la linéarisation des données avant l'enregistrement, cela assure que les valeurs seront proprement récupérables.
  9. $prefmanager = new Auth_PrefManager($dsn, $options); // Créer l'objet.
  10.  
  11. // Fixer la valeur par défaut (cela ne doit pas être fait chaque fois que le script tourne).
  12. $prefmanager->setDefaultPref('country', 'Terre');  
  13.  
  14. // Permettre aux utilisateurs de spécifier leur pays et nom d'utilisateur.
  15. if (isset($_POST['submit'])) {  
  16. $username = htmlspecialchars($_POST['username']);  
  17. $prefmanager->setPref($username, 'country', $_POST['country']);  
  18. } else if (isset($_POST['reset'])) {  
  19. $username = htmlspecialchars($_POST['username']);  
  20. $prefmanager->deletePref($username, 'country');  
  21. } else {  
  22. $username = 'invité';  
  23. }  
  24. ?>
  25. <h1>Bienvenue aux personnes de<?php echo $prefmanager->getPref($username, "country")?>!</h1>
  26. <h2>Sélectionnez votre pays et nom d'utilisateur</h2>
  27. <form method="post" action="<?php echo htmlspecialchars($_SERVER['PHP_SELF']) ?>">
  28.  
  29. <label for="username">Nom d'utilisateur</label> :
  30. <input name="username" value="<?php echo $username?>" />
  31. <br />
  32. <label for="country">Pays</label> :
  33. <input name="country" value="<?php echo $prefmanager->getPref($username, 'country')?>"/>
  34. <br />
  35. <input type="submit" name="submit" value="Enregistrer" />
  36. <input type="submit" name="reset" value="Réinitialiser" />
  37. </for
  38. ?> 
Niveau superieur
Sommaire

Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique