Cahier de Prépa - Installation du logiciel

Le logiciel Cahier de Prépa

Cahier de Prépa est un logiciel libre. Il est développé avec passion par un prof de CPGE depuis l'été 2011.

L'histoire du développement de Cahier de Prépa

Toutes les modifications, version par version (« Changelog »)

L'installation et la configuration de Cahier de Prépa sur un serveur

Télécharger le logiciel Cahier de Prépa

Cahier de Prépa est un logiciel libre, que vous pouvez télécharger si vous souhaitez l'installer sur votre propre serveur.

L'évolution de ses fonctionnalités est décrite depuis le début de l'aventure dans le « changelog », ou avec un peu plus de détails dans l'historique.

Installation

Si vous souhaitez installer Cahier de Prépa sur un serveur, vous devez

Télécharger le fichier zip et le dézipper sur votre serveur web.
Éditer le fichier de configuration config.php : il suffit d'y mettre l'adresse du site et un accès à une base de données.
Rendre accessible en écriture les répertoires documents, sauvegarde et rss pour l'utilisateur d'Apache. Il suffit de taper dans une console, à la racine du site web :
sudo chgrp www-data documents sauvegarde rss && sudo chmod g+w documents sauvegarde rss
Se connecter, avec votre navigateur, sur votre « Cahier » et suivre les instructions. Voilà, c'est bon !

Spécifications requises

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

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>