*** PHPRemise ***

# ----------
# PREREQUIS:
# ----------

# Ce programme fonctionne qu'avec PHP 4.x.  Il ne fonctionne pas correctement
# avec PHP version 3. Le module "calendar" doit tre activ.  Avec Redhat,
# cette option est active par dfaut.

# Ce programme a t test avec le serveur Apache sous Linux.

# ------------
# INSTALLATION
# ------------

# Il vous faut Apache avec PHP 4.x avec le module "calendar" d'activ.

# Copiez tous les fichiers dans un nouveau rpertoire du serveur Web.

# Le serveur doit avoir les droits de lecture et d'criture du rpertoire
# choisi.

# ------------
# INFORMATION:
# ------------

# Ce programme permet de crer des rpertoires de remise pour diffrents
# cours.  Chaque rpertoire de remise cr contient un fichier index.php
# qui offre aux tudiants de remettre des travaux par le Web.  Toute la
# configuration des rpertoires de remise se fait par formulaire.
# On peut aussi rcuprer tous les fichiers remis par transmission
# d'un fichier ZIP par le Web.

# Ce programme est un logiciel libre.
# Les logiciels libres sont des logiciels qui garantissent quatre
# liberts fondamentales: la libert de les utiliser, de les
# redistribuer, et mme de les modifier et de diffuser les versions
# modifies. Grce  cela, dans le monde entier, des utilisateurs
# peuvent traduire, amliorer et adapter leurs logiciels pour leurs
# propres besoins. Ainsi, le logiciel libre contribue  assurer la
# protection des cultures locales, le multilinguisme, le dveloppement
# et la conservation de l'information. 

# Le formulaire d'un rpertoire de remise oblige l'tudiant  entrer
# son no. d'tudiant (7 chiffres),
# son nom (obligatoire), son courriel (obligatoire) et une remarque
# (optionnelle).  Il doit ensuite entrer le chemin d'accs au fichier 
# transfrer (plus facile par le bouton Choose).  L'tudiant clique sur
# "Envoyer" et le transfert se fait.  Le systme copie le fichier dans le
# rpertoire o se trouve ce fichier PHP.  

# La remise du fichier cre un fichier ayant pour nom le no. d'tudiant de
# l'tudiant suivi d'un no. de transfert de 4 chiffres attribu au hazard.
# Ce nom a le type du fichier dtermin par le serveur.i

# Un fichier LOG crit en XML est cr et nomm par le no. d'tudiant.
# Ce fichier XML respecte la dfinition de type de document DTD generic.dtd.
# Dans ce fichier XML, on retrouve toutes les informations rcoltes par le serveur
# comme la taille du fichier, le nom d'origine, le type du fichier.  On y trouve
# aussi le no. de transfert qui est dtermin par hazard et est un entier en bas
# de dix milles.

# Le systme offre aprs le transfert du fichier, de retransfrer le fichier vers le
# client pour vrifier la qualit du transfert.  Ce transfert est possible pour 24 heures
# seulement.

# Aprs le transfert du fichier, un message courriel est envoy  l'administration du rpertoire
# de remise.  Si un fichier est transfr vers un client via l'option de vrification de
# la qualit de la remise, un message est envoy  l'administrateur.  Cela permet de
# retracer le vol de donnes.

# Un fichier XSL est disponible pour transformer les fichiers LOG en fichier HTML
# de prsentation sur le Web.

# Le fichier log XML est rendu disponible du Web pour que l'usager puisse voir
# l'ensemble des fichiers transfrs sur le serveur.

# La taille du fichiers  transfrer est fix  un maximum de 2 mga-octets.
# Ce maximum peut tre chang par la variable tailleMax.

# Pour augmenter la taille des fichiers, il se peut que l'administrateur du serveur
# doit modifier
# la variable $upload_max_filesize du fichier /etc/php.ini.  Il y a aussi la variable
# post_max_size qui fixe la taille d'un "POST" par HTTP.

# D'autres variables de configuration peuvent tre modifies  sa guise. Vous verrez
# aprs l'installation.

# --------------
# AVERTISSEMENT:
# --------------

# D'aprs les tests, le transfert de gros fichiers de plus de 10 mga-octets
# est souvent refus par Internet Explorer et Mozilla (Netscape).
# Il se peut que cela soit caus par le serveur proxy de votre institution.
# Il faut s'assurer de mettre des valeurs assez prcises des variables du fichier
# /etc/php.ini du serveur Apache.  Il est recommand de ne permettre des transferts
# de fichiers de moins 5 Mo seulement.

