Cahier de Prépa - Détails techniques

Aspects techniques

Cahier de Prépa est un logiciel libre. Si cela vous intéresse, vous avez tout à fait la possibilité de le télécharger, de lire le code, de le modifier. Et même sans aller jusque là, voilà ce qu'il y a sous le capot !

Langages et spécificités du serveur

Sur un serveur, Cahier de Prépa a besoin de :

PHP 8 et MySQL 5.7 au moins
Configuration du serveur modifiable ou fichiers .htaccess activés
Accès en écriture possible par le serveur web sur trois répertoires
Option Multiviews d'Apache ou équivalent
Adresse web utilisable en http://votredomaine.fr ou http://undomaine.fr/votresite
Connexion en HTTPS
Envoi de mail possible en PHP
MathJax installé à la racine du site, comme indiqué sur la documentation, par exemple en tapant
svn checkout https://github.com/mathjax/MathJax/trunk /racine-du-site/MathJax
Basthon installé à la racine du site

Configuration d'Apache

Le Cahier de Prépa fraîchement installé sur un serveur doit pouvoir fonctionner immédiatement grâce à son script d'auto-installation. Néanmoins, il faut pour le sécuriser, interdire l'indexation du répertoire contenant les documents ainsi que l'exécution des documents. Pour cela, il faut entrer dans les fichiers de configuration d'Apache ou éventuellement dans un fichier .htaccess à la racine du site (les directives AllowOverride, Order et Allow ne sont pas autorisées dans les .htaccess :

  # Racine
  <Directory [chemin vers la racine du Cahier]>
    Options -Indexes FollowSymLinks MultiViews
    AddType application/x-font-ttf .ttf
    AddType application/x-font-eot .eot
    AddType application/x-font-otf .otf
    AddType application/x-font-woff .woff
  </Directory>

  # Documents : interdiction d'exécuter
  <Directory [chemin vers la racine du Cahier]/documents/>
    Options -Indexes FollowSymLinks -MultiViews
    AddType text/plain .html .htm .shtml .php .php3 .phtml .phtm .pl .py .cgi 
    RemoveHandler .php .phtml .php3
    RemoveType .php .phtml .php3
    php_flag engine off
    AllowOverride None
    Require all granted
  </Directory>

Il faut aussi augmenter la capacité d'envoi des documents, fixée habituellement à 2 Mo.

  # Pour pouvoir envoyer des documents plus lourds que 2 Mo
  <FilesMatch "^(ajax|docs|installation)\.php$">
    php_value post_max_size 110M
    php_value upload_max_filesize 100M
    php_value max_input_time 1000
  </FilesMatch>

Navigateurs

Le site fonctionne parfaitement sur tous les navigateurs modernes car il est conforme au standards HTML 5 et CSS 3. Pensez à avoir toujours un navigateur à jour, y compris sur votre téléphone : c'est le logiciel le plus en contact avec l'extérieur, le plus critique pour votre sécurité.