Cette page décrit comment installer, configurer, puis utiliser Papache 1.0 dans un environnement UNIX. Le seul prérequis est d'avoir installé Python. Sur la plupart des systèmes, Python est installé par défaut, si bien que vous n'avez pas à vous en soucier. Si vous rencontrez le moindre problème, n'hésitez pas à nous rejoindre sur #papache ou à envoyer un mail à krankkatze@gmail.com.

Installation

Tout d'abord, téléchargez les sources de Papache. Vous devez choisir entre deux solutions :

• Vous pouvez utiliser le dépôt Mercurial, en consultant le guide. Vous aurez des sources plus à jour, mais susceptibles d'être instables. Une fois le téléchargement terminé, entrez dans le répertoire extrait :

  cd http://delroth.is-a-geek.org:8080/
  

Puis continuez à l'exécution du script install.py.

• Autrement, vous pouvez télécharger le package :

  wget http://krankkatze.alwaysdata.net/papache/papache-1.0.tar.bz2
  

Décompressez les ensuite avec tar :

tar xvjpf papache-1.0.tar.bz2

Entrez dans le répertoire décompressé :

cd papache-1.0/

Maintenant, exécutez le script install.py. Plusieurs options s'ouvrent alors à vous :

• Si vous souhaitez tout installer dans le répertoire /usr/bin, vous n'avez pas besoin de spécifier d'argument :

  ./install.py
  

• Vous pouvez aussi choisir de ne pas installer de vérificateur de fichiers de configuration avec l'option -cfgck :

  ./install.py -cfgck
  

• Vous pouvez enfin choisir d'installer Papache dans un répertoire différent de /usr/bin. Dans ce cas, utilisez l'option PREFIX. Pour installer Papache dans /bin, utilisez :

  ./install.py PREFIX=/bin
  

Vous pouvez bien sûr combiner les arguments.

Papache est désormais installé, vous allez maintenant le configurer.

Configuration

Toute la configuration globale de Papache est située dans /etc/papache.conf. Vous pouvez néanmoins utiliser des fichiers de configuration locaux pour diffèrer de la configuration globale, en plaçant un fichier .papache dans le répertoire concerné. Nous allons éditer le fichier global, mais c'est le même principe pour les fichiers locaux.

Ouvrez le fichier avec un éditeur de texte : (ici, nous utilisons nano)

nano /etc/papache.conf

La syntaxe est la suivante :

• Les lignes de commentaires commencent par un #
• On spécifie une option, puis on donne sa valeur avec =
• Si la valeur est un chiffre, on la laisse telle quelle. Si c'est une chaine de caractères, on l'entoure de guillemets (").

Ainsi, pour entrer le nom du serveur, on écrit :

server_name = "krankkatze.alwaysdata.net"

Voici une liste des options :
Le texte en itallique spécifie le type de valeur attendue.

• server_name : chaine Le nom du serveur. Par défaut : "Papache HTTP Server"
• port : nombre Le port sur lequel le serveur écoute. Par défaut : 80
• host : chaine L'IP du serveur. Par défaut : "127.0.0.1"
• 404_page : chaine La page d'erreur 404. Par défaut : la page standart.
• server_type : chaine Le nom et la version du serveur HTTP. Par défaut : "Papache"
• log : nombre 0 : Logs non activés; 1 : Logs courts; 2 : Logs longs. Par défaut : 0
• log_path : chaine Chemin vers le fichier de log. Par défaut : "/var/log/papache.log"
• cgi : nombre 0 : Non activée. 1 : Activée. Cette fonctionnalité est encore instable. Par défaut : 0
• home_default : chaine Répertoire racine du site lorsque Host: n'est pas spécifié. Par défaut : "/var/www/"
• home_X : chaine Répertoire racine du site lorsque Host: vaut X. Par défaut : non existant.
• index : chaine Indexes des répertoires, séparés par des virgules. Par defaut : "index.html,index.htm"
• cgi_extentions : chaine Types de fichiers qui seront interprètés si la CGI est activée. Par défaut : ".py"

Vous pouvez utiliser la commande papache-cfgck pour vérifier la validité de vos fichiers de configuration.

Utilisation

Pour lancer Papache, il vous suffit de taper :

papache

Si tout se passe bien, les mots "Loading ... Ready" apparaissent à l'écran. Si le serveur n'a pas pu écouter sur le port spécifié avec l'IP donnée, il vous demande de les entrer à nouveau. Si vous n'entrez rien, il réessayera avec la valeur de base.

Pour stopper Papache, utiliser la combinaison Ctrl+C.