Identification des utilisateurs
Créez site14 en copiant site13.
- /cms
- ...
- site13
- site14
Dans ce chapitre, nous allons ajouter un formulaire permettant d'authentifier les utilisateurs.
Pour tester le résultat en ligne, entrez http://www.frasq.org/cms/site14 dans la barre d'adresse de votre navigateur.
Dans le bandeau de la page d'accueil, cliquez sur l'icône qui montre un couple d'utilisateurs.
Remplissez le formulaire avec foobar
pour le nom et f00bar
pour le mot de passe.
Entrez le code de vérification. Appuyez sur Entrée.
Cliquez sur l'icône rouge avec une croix dans le bandeau de la page d'accueil ou de la page de contact pour vous déconnecter.
Commencez par créer les actions user
et nobody
en ajoutant les fichiers user.php et nobody.php dans le dossier actions avec les contenus suivants :
- /cms/site14
- actions
- user.php
- nobody.php
- actions
- function user($lang) {
- $login = build('login', $lang);
- if (true === $login) {
- $next_page = url('home', $lang);
- header("Location: $next_page");
- return false;
- }
- $banner = build('banner', $lang);
- $content = view('user', $lang, compact('login'));
- head('title', translate('user:title', $lang));
- head('description', false);
- head('keywords', false);
- head('robots', 'noindex, nofollow');
- $output = layout('standard', compact('banner', 'content'));
- return $output;
- }
L'action user
commence par construire le bloc du formulaire.
login
retourne true
si l'exécution du formulaire a connecté l'utilisateur auquel cas user
renvoie à la page d'accueil.
Notez que la page d'identification n'a pas de description ni de mots clés et que les moteurs de recherche ne doivent pas l'indexer ni suivre les liens qu'elle contient.
- function nobody($lang) {
- unset($_SESSION['user']);
- $next_page=url('home', $lang);
- header("Location: $next_page");
- return false;
- }
L'action nobody
déconnecte l'utilisateur et renvoie à la page d'accueil.
Pour donner accès aux actions user
et nobody
, ajoutez dans le fichier includes/aliases.inc un alias par langue pour chaque action :
- 'utilisateur' => 'user',
- 'deconnexion' => 'nobody',
- 'user' => 'user',
- 'disconnect' => 'nobody',
Ajoutez le titre de la page d'identification dans le fichier includes/strings.inc.
En français dans le tableau 'fr' :
- 'user:title' => 'Identification',
En anglais dans le tableau 'en' :
- 'user:title' => 'Identification',
Ajoutez la vue de la page d'identification dans les dossiers views/fr pour la version en français et views/en pour la version en anglais.
- /cms/site14
- views
- fr
- user.phtml
- en
- user.phtml
- fr
- views
- <h3>Accès privilégié</h3>
- <?php echo $login; ?>
- <h3>Privileged access</h3>
- <?php echo $login; ?>
Le formulaire d'identification d'un utilisateur est dans un bloc. Commencez par écrire la vue, d'abord dans une langue :
- /cms/site14
- views
- fr
- user.phtml
- login.phtml
- fr
- views
- <div class="form">
- <form action="" method="post">
- <input type="hidden" name="login_token" value="<?php echo $token; ?>" />
- <div class="fields">
- <p class="label">Quel est votre nom de connexion ?</p>
- <p class="input"><input type="text" name="login_login" id="login_login" size="40" maxlength="100" title="Identifiant" onkeypress="return focusonenter(event, 'login_password')" value="<?php echo htmlspecialchars($login, ENT_COMPAT, 'UTF-8'); ?>" /></p>
- <p class="info">Vous pouvez aussi entrer votre adresse d'email.</p>
- <p class="label">Et votre clé d'accès ?</p>
- <p class="input"><input type="password" name="login_password" id="login_password" size="20" maxlength="20" title="Mot de passe" onkeypress="return focusonenter(event, 'login_code')" /></p>
- <?php if ($with_captcha): ?>
- <p class="input">
- <img src="<?php echo $base_path; ?>/captcha" alt="" title="Code de vérification" />
- :
- <input type="text" name="login_code" id="login_code" size="4" maxlength="4" title="4 lettres" onkeypress="return submitonenter(event, 'login_enter')" value="" />
- </p>
- <?php endif; ?>
- <p class="submit"><button type="submit" name="login_enter" id="login_enter">Entrer</button></p>
- </div>
- </form>
Le formulaire comprend 3 champs de saisie : identifiant, mot de passe et code de vérification. En plus de $token
, 1 variable est nécessaire : $login
. Le paramètre $captcha
détermine si un captcha est affiché. Tous les noms des champs sont préfixés par login_
. Le formulaire a un seul bouton appelé login_enter
.
Le reste de la vue gère tous les messages d'erreur.
Les erreurs possibles sont $missing_code
, $bad_code
, $missing_login
, $missing_password
, $bad_login
, $bad_password
et $access_denied
.
- <?php if ($errors):
- extract($errors);
- ?>
- <div class="errors">
- <?php if ($missing_code): ?>
- <p>Entrez le code de vérification affiché dans l'image.</p>
- <?php elseif ($bad_code): ?>
- <p>Le code de vérification est incorrect.</p>
- <?php endif; ?>
- <?php if ($missing_login or $missing_password): ?>
- <p>Entrez votre identifiant et votre mot de passe.</p>
- <?php elseif ($bad_login): ?>
- <p>L'identifiant est invalide.</p>
- <?php elseif ($bad_password): ?>
- <p>Le mot de passe est invalide.</p>
- <?php elseif ($access_denied): ?>
- <p>Accès refusé.</p>
- <?php endif; ?>
- </div>
- <?php endif; ?>
- </div>
Pour valider la vue, écrivez une première version de la fonction login
qui se limite à l'affichage du formulaire :
- /cms/site14
- blocks
- login.php
- blocks
- require_once 'tokenid.php';
- function login($lang) {
- $login=$password=$code=$token=false;
- $missing_code=false;
- $bad_code=false;
- $bad_token=false;
- $missing_login=false;
- $bad_login=false;
- $missing_password=false;
- $bad_password=false;
- $access_denied=false;
- $with_captcha=true;
- $_SESSION['login_token'] = $token = token_id();
- $errors = compact('missing_code', 'bad_code', 'missing_login', 'bad_login', 'missing_password', 'bad_password', 'access_denied');
- $output = view('login', $lang, compact('token', 'with_captcha', 'login', 'errors'));
- return $output;
- }
Entrez http://localhost/cms/site14/fr/utilisateur dans la barre d'adresse de votre navigateur.
Éditez la fonction login
. Donnez des valeurs aux variables des champs de saisie. Mettez toutes les variables d'erreur à true
.
Ajoutez la vue en anglais :
- /cms/site14
- views
- en
- user.phtml
- login.phtml
- en
- views
- <div class="form">
- <form action="" method="post">
- <input type="hidden" name="login_token" value="<?php echo $token; ?>" />
- <div class="fields">
- <p class="label">What is your connection name?</p>
- <p class="input"><input type="text" name="login_login" id="login_login" size="40" maxlength="100" title="Identifier" onkeypress="return focusonenter(event, 'login_password')" value="<?php echo htmlspecialchars($login, ENT_COMPAT, 'UTF-8'); ?>" /></p>
- <p class="info">You may also enter your email address.</p>
- <p class="label">And your access key?</p>
- <p class="input"><input type="password" name="login_password" id="login_password" size="20" maxlength="20" title="Password" onkeypress="return focusonenter(event, 'login_code')" /></p>
- <?php if ($with_captcha): ?>
- <p class="input">
- <img src="<?php echo $base_path; ?>/captcha" alt="" title="Verification code" />
- :
- <input type="text" name="login_code" id="login_code" size="4" maxlength="4" title="4 letters" onkeypress="return submitonenter(event, 'login_enter')" value="" />
- </p>
- <?php endif; ?>
- <p class="submit"><button type="submit" name="login_enter" id="login_enter">Enter</button></p>
- </div>
- </form>
- <?php if ($errors):
- extract($errors);
- ?>
- <div class="errors">
- <?php if ($missing_code): ?>
- <p>Enter the verification code displayed in the image.</p>
- <?php elseif ($bad_code): ?>
- <p>The verification code is incorrect.</p>
- <?php endif; ?>
- <?php if ($missing_login or $missing_password): ?>
- <p>Enter your identifier and your password.</p>
- <?php elseif ($bad_login): ?>
- <p>The identifier is invalid.</p>
- <?php elseif ($bad_password): ?>
- <p>The password is invalid.</p>
- <?php elseif ($access_denied): ?>
- <p>Access denied.</p>
- <?php endif; ?>
- </div>
- <?php endif; ?>
- </div>
Entrez http://localhost/cms/site14/en/user dans la barre d'adresse de votre navigateur pour valider la version anglaise.
Une fois la mise au point des vues terminée, complétez login
avec le code suivant :
- require_once 'readarg.php';
- require_once 'strflat.php';
- require_once 'validateusername.php';
- require_once 'validatepassword.php';
- require_once 'validatemail.php';
- require_once 'tokenid.php';
Charge le code des fonctions readarg
, strflat
, validate_user_name
, validate_password
, validate_mail
et token_id
.
Ajoutez les fichiers validateusername.php et validatepassword.php dans le dossier library avec les contenus suivants :
- /cms/site14
- library
- validateusername.php
- validatepassword.php
- library
- function validate_user_name($name) {
- return preg_match('/^[a-z]{2,20}$/', $name);
- }
validate_user_name
retourne true
si $name
contient entre 2 et 20 lettres minuscules, false
dans le cas contraire.
- function validate_password($s) {
- $regexp='/(?=[a-zA-Z0-9]*?[A-Za-z])(?=[a-zA-Z0-9]*?[0-9])[a-zA-Z0-9]{6,}/';
- return preg_match($regexp, $s);
- }
validate_password
retourne true
si $password
contient au moins 6 lettres minuscules ou majuscules et des chiffres avec au moins un chiffre et une lettre, false
dans le cas contraire.
- function login($lang) {
- $action='init';
- if (isset($_POST['login_enter'])) {
- $action='enter';
- }
- $login=$password=$code=$token=false;
login
commence par initialiser $action
à 'enter'
si l'utilisateur a appuyé sur le bouton Entrer ou à 'init'
par défaut si le formulaire est juste affiché.
- switch($action) {
- case 'enter':
- if (isset($_POST['login_login'])) {
- $login=strtolower(strflat(readarg($_POST['login_login'], true)));
- }
- if (isset($_POST['login_password'])) {
- $password=readarg($_POST['login_password'], true);
- }
- if (isset($_POST['login_code'])) {
- $code=readarg($_POST['login_code'], true);
- }
- if (isset($_POST['login_token'])) {
- $token=readarg($_POST['login_token']);
- }
- break;
- default:
- break;
- }
Lit les champs de saisie et les filtre avec readarg
. strtag
retire les accents de $login
qui est ensuite converti en minuscules.
- $missing_code=false;
- $bad_code=false;
- $bad_token=false;
- $missing_login=false;
- $bad_login=false;
- $missing_password=false;
- $bad_password=false;
- $access_denied=false;
- $with_captcha=true;
Initialise toutes les variables d'erreur avant de valider les données envoyées par le formulaire. $with_captcha
opte pour l'affichage d'un captcha.
- switch($action) {
- case 'enter':
- if (!isset($_SESSION['login_token']) or $token != $_SESSION['login_token']) {
- $bad_token=true;
- break;
- }
- if ($with_captcha) {
- if (!$code) {
- $missing_code=true;
- break;
- }
- $captcha=isset($_SESSION['captcha']) ? $_SESSION['captcha'] : false;
- if (!$captcha or $captcha != strtoupper($code)) {
- $bad_code=true;
- break;
- }
- }
- if (!$login) {
- $missing_login=true;
- }
- else if (!validate_user_name($login) and !validate_mail($login)) {
- $bad_login=true;
- }
- if (!$password) {
- $missing_password=true;
- }
- else if (!validate_password($password)) {
- $bad_password = true;
- }
- break;
- default:
- break;
- }
Contrôle le jeton, vérifie si le captcha correspond si $with_captcha
est true
, puis valide les saisies de l'identifiant et du mot de passe.
- switch($action) {
- case 'enter':
- if ($bad_token or $missing_code or $bad_code or $missing_login or $bad_login or $missing_password or $bad_password) {
- break;
- }
- require_once 'models/user.inc';
- $user = user_login($login, $password);
- if (!$user) {
- $access_denied=true;
- require_once 'log.php';
- write_log('enter.err', substr($login, 0, 40));
- break;
- }
- $user['ip'] = client_ip_address();
- $_SESSION['user'] = $user;
- unset($_SESSION['login_token']);
- return true;
- default:
- break;
- }
Vérifie qu'aucune erreur n'a été détectée, charge le modèle user.inc et appelle la fonction user_login
avec les paramètres $login
et $password
.
Si user_login
retourne false
, l'erreur est notée dans le journal enter.err.
Si l'identifiant et le mot de passe sont reconnus, les informations retournées par user_login
ainsi que l'adresse IP du client sont mémorisées dans la variable de session $_SESSION['user']
et login
retourne true
après avoir effacé le jeton.
Rappelez-vous que dans ce cas, l'action user
renvoie à la page d'accueil.
- $_SESSION['login_token'] = $token = token_id();
- $errors = compact('missing_code', 'bad_code', 'missing_login', 'bad_login', 'missing_password', 'bad_password', 'access_denied');
- $output = view('login', $lang, compact('token', 'with_captcha', 'login', 'errors'));
- return $output;
- }
Prépare tous les paramètres de la vue, dont le jeton qui est mémorisé dans la variable de session $_SESSION['login_token']
, avant de générer la vue et de retourner son contenu.
Ajoutez le dossier models directement à la racine du site, puis le fichier user.inc dans models avec le contenu suivant :
- /cms/site14
- models
- user.inc
- models
- function user_login($login, $password) {
- if ( ! ($login == 'foobar' and $password == 'f00bar') ) {
- return false;
- }
- $now=time();
- $user = array();
- $user['id'] = 0;
- $user['name'] = $login;
- $user['access'] = $now;
- return $user;
- }
user_login
retourne un tableau contenant des informations sur le compte de l'utilisateur dont l'identifiant est $login
et le mot de passe $password
.
Si l'utilisateur n'est pas reconnu, user_login
retourne false
.
NOTE : Le modèle est pour l'instant réduit au strict minimum afin de permettre la mise au point de la page d'identification.
Entrez http://localhost/cms/site14/fr/utilisateur et http://localhost/cms/site14/en/user pour tester le formulaire en français et en anglais. Vérifiez que les contrôles sur les champs fonctionnent. Connectez-vous.
Pour accéder à la page d'identification, ajoutez un lien dans le bandeau de la page d'accueil :
- $contact=$account=true;
- $banner = build('banner', $lang, compact('languages', 'contact', 'account'));
home
passe 'account'
à true
à banner
.
- $menu=$login=$logout=$contact=false;
- $languages=false;
- $user_page=$nobody_page=$contact_page=false;
- $is_identified = user_is_identified();
- if ($is_identified) {
- $nobody_page=url('nobody', $lang);
- $logout = true;
- }
- if ($components) {
- foreach ($components as $v => $param) {
- switch ($v) {
- case 'account':
- if ($param) {
- if (!$is_identified) {
- $user_page=url('user', $lang);
- $login = true;
- }
- }
- break;
Dans tous les cas, si l'utilisateur est identifié, banner
ajoute un lien sur la page de déconnexion.
Si $components
contient 'account'
à true
et si l'utilisateur n'est pas identifié, banner
ajoute un lien sur la page d'identification.
- if ($logout or $contact) {
- $menu = view('bannermenu', $lang, compact('contact', 'contact_page', 'logout', 'nobody_page', 'login', 'user_page'));
- }
Ajoutez le fichier userisidentified.php dans le dossier library avec le contenu suivant :
- /cms/site14
- library
- userisidentified.php
- library
- function user_is_identified() {
- return isset($_SESSION['user']);
- }
user_is_identified
retourne true
si la description de l'utilisateur est dans la session.
Ajoutez les liens dans le menu du bandeau dans les fichiers views/fr/bannermenu.phtml et views/en/bannermenu.phtml.
- <?php if (isset($logout) and $logout): ?>
- <li><a id="exit" href="<?php echo $nobody_page; ?>" title="Déconnexion"><span>Déconnexion</span></a></li>
- <?php endif; ?>
- <?php if (isset($login) and $login): ?>
- <li><a id="enter" href="<?php echo $user_page; ?>" title="Votre compte"><span>Compte</span></a></li>
- <?php endif; ?>
- <?php if (isset($logout) and $logout): ?>
- <li><a id="exit" href="<?php echo $nobody_page; ?>" title="Disconnect"><span>Disconnect</span></a></li>
- <?php endif; ?>
- <?php if (isset($login) and $login): ?>
- <li><a id="enter" href="<?php echo $user_page; ?>" title="Your account"><span>Account</span></a></li>
- <?php endif; ?>
Modifiez la feuille de style pour afficher des boutons à la place des liens :
- #bannermenu {width:160px;float:left;margin-top:13px;margin-left:40px;}
- #bannermenu #mail {width:24px;height:24px;float:right;margin-left:6px;background:transparent url(../buttons/mail.png) no-repeat center center;}
- #bannermenu #exit {width:24px;height:24px;float:left;margin-right:6px;background:transparent url(../buttons/cancel.png) no-repeat center center;}
- #bannermenu #enter {width:24px;height:24px;float:right;margin-right:6px;background:transparent url(../buttons/user.png) no-repeat center center;}
Copiez les icônes des boutons dans le dossier buttons :
- /cms/site14
- buttons
- cancel.png
- user.png
- buttons
Entrez http://localhost/cms/site14 dans la barre d'adresse de votre navigateur. Allez à la page d'identification. Affichez le code source. Désactivez le CSS pour juger de la qualité du document généré. Remplissez le formulaire en validant les champs avec Entrée. Vérifiez que le bouton de déconnexion est bien affiché sur la page de contact. Déconnectez-vous.
Commentaires