Écrire un CMS en PHP

Création d'un compte utilisateur

Créez site18 en copiant site17.

/cms
1. ...
2. site17
3. site18

Dans ce chapitre, nous allons programmer la création d'un nouveau compte utilisateur avec l'envoi d'un mot de passe par email dans un cryptogramme en pièce jointe.

Pour tester le résultat en ligne, entrez http://www.frasq.org/cms/site18 dans la barre d'adresse de votre navigateur. Allez sur la page d'identification. Cliquez sur le lien Pour créer votre compte personnel en fin de page. Entrez un nom de connexion et une adresse d'email, cochez la case de confirmation, tapez le code de vérification et appuyez sur Envoyer. Un email avec un mot de passe dans un cryptogramme en pièce jointe a été envoyé à l'adresse spécifiée. NOTE : Dans cette version de démonstration, le compte n'est pas créé.

Commencez par créer l'action newuser en ajoutant le fichier newuser.php dans le dossier actions avec le contenu suivant :

/cms/site18
1. actions
  1. newuser.php

newuser.php

function newuser($lang) {
head('title', translate('newuser:title', $lang));
head('description', false);
head('keywords', false);
head('robots', 'noindex, nofollow');
$banner = build('banner', $lang);
$register = build('register', $lang);
$content = view('newuser', $lang, compact('register'));
$output = layout('standard', compact('banner', 'content'));
return $output;
}

L'action newuser retourne une page avec un bandeau simple et le formulaire construit par le bloc register.

Pour donner accès à l'action newuser, ajoutez un alias par langue dans le fichier includes/aliases.inc :

aliases.inc

'nouvel-utilisateur' => 'newuser',

'new-user' => 'newuser',

Ajoutez le titre de la page de création d'un compte dans le fichier includes/strings.inc :

strings.inc

En français dans le tableau 'fr' :

'newuser:title' => 'Inscription',

En anglais dans le tableau 'en' :

'newuser:title' => 'Registration',

Ajoutez la vue de la page de création d'un compte dans les dossiers views/fr pour la version en français et views/en pour la version en anglais :

/cms/site18
1. views
  1. fr
    1. newuser.phtml
  2. en
    1. newuser.phtml

newuser_fr.phtml

<h3>Création d'un compte</h3>
<?php echo $register; ?>

newuser_en.phtml

<h3>New account</h3>
<?php echo $register; ?>

Le formulaire de création d'un compte est dans un bloc. Commencez par écrire la vue, d'abord dans une langue :

/cms/site18
1. views
  1. fr
    1. newuser.phtml
    2. register.phtml

register_fr.phtml

<div class="form">
<form action="" method="post">
<input type="hidden" name="register_token" value="<?php echo $token; ?>" />
<div class="fields">
<?php if ($account_created): ?>
<?php if (!empty($name)): ?>
<p class="right"><img src="<?php echo $base_path; ?>/avatars/<?php echo $name; ?>.png" title="<?php echo $name; ?>" /></p>
<?php endif; ?>
<?php endif; ?>
<p class="label">Quel nom de connexion voulez-vous ?</p>
<p class="input"><input type="text" name="register_name" id="register_name" size="20" maxlength="20" title="Identifiant" onkeypress="return focusonenter(event, 'register_mail')" value="<?php echo htmlspecialchars($name, ENT_COMPAT, 'UTF-8'); ?>" /></p>
<p class="info">Choisissez un pseudo de 2 à 20 lettres.</p>
<p class="label">Quelle est votre adresse d'email ?</p>
<p class="input"><input type="text" name="register_mail" id="register_mail" size="50" maxlength="100" title="Email" onkeypress="return focusonenter(event, 'register_code')" value="<?php echo htmlspecialchars($mail, ENT_COMPAT, 'UTF-8'); ?>" /></p>
<p class="info">Votre mot de passe sera envoyé à cette adresse.</p>
<p class="label"><input type="checkbox" name="register_confirmed" id="register_confirmed" title="Confirmation" <?php if ($confirmed) echo 'checked="checked"'; ?> onkeypress="return focusonenter(event, 'register_code')"/> Je souhaite créer un compte</p>
<?php if ($with_captcha): ?>
<p class="input">
<img src="<?php echo $base_path; ?>/captcha/register" alt="" title="Code de vérification" />
 : 
<input type="text" name="register_code" id="register_code" size="4" maxlength="4" title="4 lettres" onkeypress="return submitonenter(event, 'register_register')" value="" />
</p>
<?php endif; ?>
<p class="submit"><button type="submit" name="register_register" id="register_register">Envoyer</button></p>
</div>
</form>

Le formulaire comprend 4 champs de saisie : identifiant, email, confirmation et code de vérification. En plus de $token, 3 variables sont nécessaires : $name, $mail et $confirmed. Le paramètre $captcha détermine si un captcha est affiché. Tous les noms des champs sont préfixés par register_. Le formulaire a un seul bouton appelé register_register.

Le reste de la vue gère tous les messages d'erreur. Les erreurs possibles sont $missing_code, $bad_code, $missing_name, $bad_name, $missing_mail, $bad_mail, $missing_confirmation, $duplicated_name, $duplicated_mail, $internal_error et $contact_page. Si $account_created est true, on signale à l'utilisateur que le mot de passe lui a été envoyé par email et on lui propose un lien sur la page d'identification $user_page.

<?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_name): ?>
<p>Vous n'avez pas saisi votre identifiant.</p>
<?php elseif ($bad_name): ?>
<p>Un identifiant doit comporter entre 2 et 20 lettres.</p>
<?php endif; ?>
<?php if ($missing_mail): ?>
<p>N'oubliez pas votre adresse d'email.</p>
<?php elseif ($bad_mail): ?>
<p>L'adresse d'email est invalide.</p>
<?php endif; ?>
<?php if ($missing_confirmation): ?>
<p>Cochez la case de confirmation.</p>
<?php endif; ?>
<?php if ($duplicated_name): ?>
<p>Cet identifiant est déjà pris.</p>
<?php endif; ?>
<?php if ($duplicated_mail): ?>
<p>Cette adresse d'email est déjà utilisée.</p>
<?php endif; ?>
<?php if ($internal_error): ?>
<p>Une erreur interne s'est produite. Si vous pouvez décrire le problème, merci de <a href="<?php echo $contact_page; ?>">nous contacter</a>.
<?php endif; ?>
</div>
<?php endif; ?>
<?php if ($infos):
extract($infos);
?>
<div class="infos">
<?php if ($account_created): ?>
<p>Votre compte a bien été créé. Le mot de passe a été envoyé par email à votre adresse.<br />
Pour vous identifier, <a href="<?php echo $user_page; ?>">cliquez ici</a>.</p>
<?php endif; ?>
</div>
<?php endif; ?>
</div>

Pour valider la vue, écrivez une première version de la fonction register qui se limite à l'affichage du formulaire :

/cms/site18
1. blocks
  1. register.php

register1.php

require_once 'tokenid.php';
function register($lang) {
$name=$mail=$confirmed=$code=$token=false;
$missing_code=false;
$bad_code=false;
$bad_token=false;
$missing_name=false;
$bad_name=false;
$missing_mail=false;
$bad_mail=false;
$missing_confirmation=false;
$duplicated_name=false;
$duplicated_mail=false;
$account_created=false;
$user_page=false;
$internal_error=false;
$contact_page=false;
$with_captcha=true;
$_SESSION['register_token'] = $token = token_id();
$errors = compact('missing_name', 'bad_name', 'missing_mail', 'bad_mail', 'missing_confirmation', 'missing_code', 'bad_code', 'duplicated_name', 'duplicated_mail', 'internal_error', 'contact_page');
$infos = compact('user_page');
$output = view('register', $lang, compact('token', 'with_captcha', 'name', 'mail', 'confirmed', 'account_created', 'errors', 'infos'));
return $output;
}

Entrez http://localhost/cms/site18/fr/nouvel-utilisateur dans la barre d'adresse de votre navigateur. Éditez la fonction register. Donnez des valeurs aux variables des champs de saisie. Mettez toutes les variables d'erreur à true. Vérifiez les liens sur la page de contact et sur la page d'identification.

Ajoutez la vue en anglais :

/cms/site18
1. views
  1. en
    1. newuser.phtml
    2. register.phtml

register_en.phtml

<div class="form">
<form action="" method="post">
<input type="hidden" name="register_token" value="<?php echo $token; ?>" />
<div class="fields">
<?php if ($account_created): ?>
<?php if (!empty($name)): ?>
<p class="right"><img src="<?php echo $base_path; ?>/avatars/<?php echo $name; ?>.png" title="<?php echo $name; ?>" /></p>
<?php endif; ?>
<?php endif; ?>
<p class="label">What connection name do you want?</p>
<p class="input"><input type="text" name="register_name" id="register_name" size="20" maxlength="20" title="Identifier" onkeypress="return focusonenter(event, 'register_code')" value="<?php echo htmlspecialchars($name, ENT_COMPAT, 'UTF-8'); ?>" /></p>
<p class="info">Choose a pseudo with between 2 and 20 letters.</p>
<p class="label">What is your email address?</p>
<p class="input"><input type="text" name="register_mail" id="register_mail" size="50" maxlength="100" title="Email" onkeypress="return focusonenter(event, 'register_code')" value="<?php echo htmlspecialchars($mail, ENT_COMPAT, 'UTF-8'); ?>" /></p>
<p class="info">Your password will be sent at this address.</p>
<p class="input"><input name="register_confirmed" id="register_confirmed" type="checkbox" title="Confirmation" <?php if ($confirmed) echo 'checked="checked"'; ?> /> I wish to create an account</p>
<?php if ($with_captcha): ?>
<p class="input">
<img src="<?php echo $base_path; ?>/captcha/register" alt="" title="Verification code" />
 : 
<input type="text" name="register_code" id="register_code" size="4" maxlength="4" title="4 letters" onkeypress="return submitonenter(event, 'register_register')" value="" />
</p>
<?php endif; ?>
<p class="submit"><button type="submit" name="register_register" id="register_register">Send</button></p>
</div>
</form>
<?php
if ($errors):
extract($errors);
?>
<div class="error">
<?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_name): ?>
<p>You haven't typed your identifier.</p>
<?php elseif ($bad_name): ?>
<p>An identifier must contain between 2 and 20 letters.</p>
<?php endif; ?>
<?php if ($missing_mail): ?>
<p>Don't forget your email address.</p>
<?php elseif ($bad_mail): ?>
<p>The email address is invalid.</p>
<?php endif; ?>
<?php if ($missing_confirmation): ?>
<p>Check the confirmation box.</p>
<?php endif; ?>
<?php if ($duplicated_name): ?>
<p>This identifier is already taken.</p>
<?php endif; ?>
<?php if ($duplicated_mail): ?>
<p>This email address is already being used.</p>
<?php endif; ?>
<?php if ($internal_error): ?>
<p>An internal error has occurred. If you can describe the problem, please <a href="<?php echo $contact_page; ?>">contact us</a>.</p>
<?php endif; ?>
</div>
<?php endif; ?>
<?php if ($infos):
extract($infos);
?>
<div class="infos">
<?php if ($account_created): ?>
<p>Your account has been created. Your password has been emailed to your address.<br />
To identify yourself, <a href="<?php echo $user_page; ?>">click here</a>.</p>
<?php endif; ?>
</div>
<?php endif; ?>
</div>

Entrez http://localhost/cms/site18/en/newuser 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 register avec le code suivant :

require_once 'readarg.php';
require_once 'strflat.php';
require_once 'validateusername.php';
require_once 'validatemail.php';
require_once 'isusernameallowed.php';
require_once 'ismailallowed.php';
require_once 'tokenid.php';

Charge le code des fonctions readarg, strflat, validate_user_name, validate_mail, is_user_name_allowed, is_mail_allowed et token_id.

function register($lang) {
$action='init';
if (isset($_POST['register_register'])) {
$action='register';
}
$name=$mail=$confirmed=$code=$token=false;
switch($action) {
case 'register':
if (isset($_POST['register_name'])) {
$name=strtolower(strflat(readarg($_POST['register_name'], true)));
}
if (isset($_POST['register_mail'])) {
$mail=strtolower(strflat(readarg($_POST['register_mail'], true)));
}
if (isset($_POST['register_confirmed'])) {
$confirmed=$_POST['register_confirmed'] ? true : false;
}
if (isset($_POST['register_code'])) {
$code=readarg($_POST['register_code'], true);
}
if (isset($_POST['register_token'])) {
$token=readarg($_POST['register_token']);
}
break;
default:
break;
}

Lit le formulaire.

$missing_code=false;
$bad_code=false;
$bad_token=false;
$missing_name=false;
$bad_name=false;
$missing_mail=false;
$bad_mail=false;
$missing_confirmation=false;
$duplicated_name=false;
$duplicated_mail=false;
$account_created=false;
$user_page=false;
$internal_error=false;
$contact_page=false;
$with_captcha=true;
switch($action) {
case 'register':
if (!isset($_SESSION['register_token']) or $token != $_SESSION['register_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 (!$name) {
$missing_name=true;
}
else if (!validate_user_name($name) or !is_user_name_allowed($name)) {
$bad_name=true;
}
if (!$mail) {
$missing_mail=true;
}
else if (!validate_mail($mail) or !is_mail_allowed($mail)) {
$bad_mail=true;
}
if (!$confirmed) {
$missing_confirmation=true;
}
break;
default:
break;
}

Contrôle les données saisies, en particulier si le nom de connexion et l'adresse d'email sont valides et autorisés. Vérifie si la case de confirmation a été cochée.

switch($action) {
case 'register':
if ($bad_token or $missing_code or $bad_code or $missing_name or $bad_name or $missing_mail or $bad_mail or $missing_confirmation) {
break;
}
require_once 'newpassword.php';
$password=newpassword();
require_once 'models/user.inc';
$r = user_check_name($name);
if (!$r) {
$duplicated_name=true;
break;
}
$r = user_check_mail($mail);
if (!$r) {
$duplicated_mail=true;
break;
}
$r = user_create($name, $password, $mail);
if (!$r) {
$contact_page=url('contact', $lang);
$internal_error=true;
break;
}
require_once 'emailcrypto.php';
global $sitename, $webmaster;
$to=$mail;
$subject = translate('email:new_user_subject', $lang);
$msg = translate('email:new_user_text', $lang) . "\n\n" . translate('email:salutations', $lang);
if (!emailcrypto($msg, $password, $to, $subject, $webmaster)) {
$contact_page=url('contact', $lang);
$internal_error=true;
break;
}
require_once 'emailme.php';
$timestamp=strftime('%d-%m-%Y %H:%M:%S', time());
$subject = 'frasq.org:new_account.';
$msg = $timestamp . ' ' . $lang . ' ' . $name . ' ' . $mail;
emailme($subject, $msg);
$account_created=true;
$confirmed=false;
break;
default:
break;
}

Vérifie qu'aucune erreur n'a été détectée, génère un nouveau mot de passe avec newpassword, charge le modèle user.inc et contrôle que le nom et l'adresse d'email ne sont pas déjà pris avec user_check_name et user_check_mail. Une fois le compte créé, un email est envoyé avec emailcrypto au nouvel utilisateur avec son mot de passe dans un cryptogramme en pièce jointe. Enfin, les informations de création du compte sont notifiées par email au webmestre avec emailme.

if ($internal_error) {
$contact_page=url('contact', $lang);
}
else if ($account_created) {
$user_page=url('user', $lang);
}
$_SESSION['register_token'] = $token = token_id();
$errors = compact('missing_name', 'bad_name', 'missing_mail', 'bad_mail', 'missing_confirmation', 'missing_code', 'bad_code', 'duplicated_name', 'duplicated_mail', 'internal_error', 'contact_page');
$infos = compact('user_page');
$output = view('register', $lang, compact('token', 'with_captcha', 'name', 'mail', 'confirmed', 'account_created', 'errors', 'infos'));
return $output;
}

Le reste du code prépare tous les paramètres de la vue, dont le jeton qui est mémorisé dans la variable de session $_SESSION['register_token'], la génère et retourne son contenu.

Définissez le sujet et le texte de l'email en ajoutant les paramètres email:new_user_subject et email:new_user_text dans le fichier includes/strings.inc, en français et en anglais :

strings.inc

'email:new_user_subject' => 'frasq.org : Votre compte.',
'email:new_user_text' => "Bienvenue !\n\nVotre mot de passe est dans le cryptogramme en pièce jointe.",

'email:new_user_subject' => 'frasq.org : Your account.',
'email:new_user_text' => "Welcome!\n\nYour password is in the attached cryptogram.",

Éditez le fichier user.inc dans le dossier models et ajoutez les fonctions suivantes :

user.inc

function user_check_name($name) {
$sqlname=db_sql_arg($name, true);
$tabuser=db_prefix_table('user');
$sql="SELECT user_id FROM $tabuser WHERE name=$sqlname LIMIT 1";
$r = db_query($sql);
return $r ? false : true;
}

user_check_name retourne false si $name est un nom de connexion déjà pris, true si $name est disponible.

function user_check_mail($mail) {
$sqlmail=db_sql_arg($mail, true);
$tabuser=db_prefix_table('user');
$sql="SELECT user_id FROM $tabuser WHERE mail=$sqlmail LIMIT 1";
$r = db_query($sql);
return $r ? false : true;
}

user_check_mail retourne false si $mail est une adresse d'email qui est déjà utilisée, true si $mail est libre.

define('AVATAR_SIZE', 40);
define('AVATARS_DIR', ROOT_DIR . DIRECTORY_SEPARATOR . 'avatars');
function user_create_avatar($name) {
require_once 'identicon.php';
$img=identicon($name, AVATAR_SIZE);
$r = imagepng($img, AVATARS_DIR . DIRECTORY_SEPARATOR . $name . '.png');
return $r;
}
function user_delete_avatar($name) {
@unlink(AVATARS_DIR . DIRECTORY_SEPARATOR . $name . '.png');
}

user_create_avatar crée une icône de AVATAR_SIZE pixels pour le nom de connexion $name et la place dans le dossier AVATAR_DIR à la racine du site.

user_delete_avatar détruit le fichier $name dans le dossier AVATAR_DIR à la racine du site.

function user_create($name, $password, $mail, $locale='fr') {
$sqlname=db_sql_arg($name, true);
$sqlmail=db_sql_arg($mail, true);
$sqllocale=db_sql_arg($locale);
$sqlpassword=$password ? '\'' . md5($password) . '\'' : NULL;
$tabuser=db_prefix_table('user');
$sql="INSERT IGNORE $tabuser (name, password, mail, created, locale) VALUES ($sqlname, $sqlpassword, $sqlmail, NOW(), $sqllocale)";
$r = db_insert($sql);
if (!$r) {
return false;
}
$user_id = db_insert_id();
user_create_avatar($name);
return $user_id;
}

user_create crée l'utilisateur $name avec le mot de passe $password, l'adresse d'email $mail et la langue $locale, puis crée son avatar. user_create retourne le numéro de l'utilisateur ou false en cas d'erreur.

Ajoutez un lien sur la page de création d'un compte dans la vue de la page d'identification :

login_fr.phtml

<p class="info link">Pour créer votre compte personnel, <a href="<?php echo $newuser_page; ?>">cliquez ici</a>.</p>

login_en.phtml

<p class="info link">To create your personal account, <a href="<?php echo $newuser_page; ?>">click here</a>.</p>

Assignez l'URL de la page de création d'un compte à la variable $newuser_page des vues dans la fonction login :

$newuser_page=url('newuser', $lang);
$output = view('login', $lang, compact('token', 'with_captcha', 'password_page', 'newuser_page', 'login', 'errors'));

Entrez http://localhost/cms/site18 dans la barre d'adresse de votre navigateur. Allez sur la page d'identification. Cliquez sur le lien Pour créer votre compte personnel. Entrez un nom de connexion et votre adresse d'email, cochez la case de confirmation, tapez le code de vérification et appuyez sur Envoyer. Lisez votre courrier. Identifiez-vous avec votre nom de connexion et le mot de passe en pièce jointe.

site18.zip

frasq.org

Création d'un compte utilisateur

Commentaires

Votre commentaire :