TP3

Techniques mises en oeuvre

lecture d'un fichier,
upload de fichier,
écriture dans un fichier,
manipulation de dates,
session

Expression des besoins

YAHP doit permettre la saisie web d'un ticket ... et sa sauvegarde sur le serveur!
Un administrateur doit pouvoir préciser la liste des applications gérées par le système sans modifier le code html ou php; cette liste est donc définie sur le serveur dans un fichier app.csv (exemple) et lue lors de la construction du formulaire.
Pour éviter des attaques malicieuses, seuls les utilisateurs authentifiés ont désormais la possibilité de se connecter.

En l'absence de base de données, les informations d'un ticket sont sauvegardées sur le serveur dans un fichier tickets.csv. Chaque ligne de ce fichier a la structure suivante :

	ID_ticket;nom_application;login;ID_priorité;type;date_de_création;résumé;description;nom_de_la_pièce_jointe

(où ID_ticket et ID_priorité sont des entiers, type peut prendre les valeurs 'anomalie' ou 'évolution', la priorité est un entier, la date est une chaîne de caractères au format jj/mm/yyyy)

Travail demandé

Génération dynamique de la liste des applications

Certains des éléments du formulaire de saisie de ticket devenant aussi dynamiques, on va remplacer le fichier statique saisieTicket.html par une page dynamique editTicketForm.php.
Le lien public permettant à un utilisateur de saisir un ticket devient editTicket.php. Ce fichier doit :

définir la fonction getAllApplisAsOptions() qui lit le fichier app.csv pour construire une chaîne contenant les éléments de la boîte à liste "Application:"
(utiliser les fonctions standard explode() puis trim() pour éliminer les espaces éventuels en début et fin des noms d'application),
utiliser la fonction getAllApplisAsOptions() : $allApplisAsOptions = getAllApplisAsOptions();
inclure (par include) la page dynamique editTicketForm.php qui remplace le fichier statique saisieTicket.html et utilise la variable $allApplisAsOptions précédente.

Précision : la fonction getAllApplisAsOptions() doit retourner une chaine de caractères de la forme :

        <option value="-1">--Autre--</option>
        <option>Application1</option>
        <option>Application2</option> ...

Sauvegarde des informations saisies dans le formulaire

Modifier le script de traitement du formulaire editTicketAction.php. Il doit définir et utiliser les fonctions suivantes:

printTicketAsTableRow()
saveTicket() qui doit sauver les champs du ticket créé dans le fichier tickets.csv (utiliser fwrite ou fputs),
(facultatif) saveAttachedFile() responsable de sauvegarder la pièce-jointe éventuelle sur le serveur dans un sous-répertoire appelé "attachements" (utiliser la fonction standard move_uploaded_file).

Précisions

Les fonctions saveTicket() et printTicketAsTableRow() doivent avoir les signatures suivantes:
. saveTicket($applicationName, $login, $priorityId, $type, $date, $oneLiner, $description, $attachmentName)
.printTicketAsTableRow($applicationName, $priorityText, $type, $date, $oneLiner, $description, $tableRecordClass)

La date de création du ticket doit aussi être enregistrée au format jj/mm/yyyy.
Par souci de simplification, on pourra considèrer dans cette étape que le champ description ne comporte qu'une seule ligne.

(Note : il peut s'avérer nécessaire de modifier les droits d'écriture du fichier tickets.csv.)

Gestion de session

On souhaite protéger l'accès à la page editTicket.php et aux autres pages: si l'utilisateur ne s'est pas identifié, (i.e.si un attribut userId (ou login) n'est pas présent dans la session), il est renvoyé sur un formulaire d'identification.
Suivre les étapes du tutoriel de contrôle d'accès aux pages pour mettre en place ce mécanisme de protection.