Installation
Depuis la version 2.3 de Zwe, une procédure d'installation simple et semi-automatisée vous aide dans l'installation de Zwe. Toutefois, il y a quelques étapes préliminaires à effectuer avant que cette procédure n'entre en jeu. Si vous connaissez ou avez déja réalisé tous les préliminaires à l'installation, vous pouvez passer directement à l'installation de Zwe.
Si vous avez le moindre problème ou que vous êtes bloqué quelque part, n'hésitez pas à me contacter (cf le fichier AUTHORS).
Ce dont vous aurez besoin
Pour faire fonctionner Zwe, il vous faut :
- Un serveur web (Apache 1.x ou 2.x par exemple)
- PHP 4.x ou 5.x
- MySQL 4.x ou 5.x
Zwe peut bien sûr fonctionner sur les services d'hébergement que l'on trouve sur Internet, mais il a besoin d'être testé sur ces hébergements. Si vous avez la possibilité de le faire, merci de me tenir au courant.
Download
La première chose à faire est de télécharger Zwe. Pour cela, deux méthodes sont à votre disposition :
Subversion
Si vous voulez disposer en permanence des toutes dernières nouveautés de Zwe, c'est cette option qu'il faut choisir. Néanmoins, je dois vous mettre en garde. Le dépôt Subversion est très instable. Étant donné que Bulix.org utilise directement le dépôt, vous devez vérifier avant de faire votre mise à jour que le site est bien fonctionnel, et encore, ce n'est pas dit que ça marche chez vous. Voilà, on ne pourra pas dire que je ne vous avais pas prévenus. Néanmoins, notez que je fais de temps en temps des tags (sortes de snapshots) du dépôt pour que Zwe soit disponible dans une version quasi fonctionnelle quelque part dans le dépôt Subversion. A vous donc de choisir :)
Pour la version expérimentale (trunk/)
% svn co https://ssl.bulix.org/svn/zwe/trunk zwe
Sinon, utilisez une version taggée. Pour la liste des tags, utilisez le Browser inclut dans Trac et rendez vous dans le répertoire tags/. Un nouveau tag est créé à chaque release. Utiliser un tag revient donc à downloader l'archive de Zwe correspondante.
% svn co https://ssl.bulix.org/svn/zwe/tags/<tag name>
Tarball
Téléchargez la dernière version de Zwe depuis les archives de Zwe, puis décompressez l'archive :
% wget http://zwe.bulix.org/pub/zwe-vX.Y-name.tar.gz [...] % tar xvzf zwe-vX.Y-name.tar.gz
Daily Snapshot
L'archive zwe-snaphost.tar.gz est un snapshot du trunk/ Subversion réalisé tous les matins par crontab. Ca vous permet d'avoir une version très récente sans passer par un checkout Subversion. Après la décompression, vous avez la même chose qu'après un checkout Subversion du trunk/.
Installation et configuration
Par défaut, Zwe sépare les includes du reste du site. Celà signifie que les répertoires htdocs/ (contenant les données interface) et php-include/ (contenant les includes) sont séparés, et donc que vous devrez aller à l'adresse http://.../htdocs/index.php pour accéder à votre site. Rassurez-vous, si vous ne souhaitez pas celà, il suffit de déplacer le contenu du répertoire htdocs/ à la racine de votre installation Zwe et la procédure d'installation détectera alors toute seule ce changement et configurera votre Zwe comme il faut directement.
Sur votre serveur
Si vous hébergez Zwe sur votre propre serveur, le plus simple est de laisser l'architecture des répertoires telle quelle et de faire pointer directement le DocumentRoot d'Apache (ou de votre serveur web) vers le répertoire htdocs/ :
DocumentRoot /la/ou/est/zwe/htdocs
Si vous ne pouvez pas changer la configuration du serveur, vous pouvez également suivre la procédure décrite dans la section suivante.
Chez un hébergeur (type Free/Online/?...)
Bien souvent, chez un hébergeur de site web, vous n'avez pas la même flexibilité que sur votre propre serveur, notamment au niveau de la configuration du serveur web. Ainsi, il est recommandé, si vous utilisez Zwe chez un hébergeur type Free ou Online.fr, de réaliser les opérations suivantes avant d'installer Zwe :
- créez un répertoire sessions à la racine de votre hébergement si il n'existe pas déjà ;
- envoyez les fichiers de Zwe vers votre hébergement ;
- déplacez le contenu du répertoire htdocs/ à la racine de votre hébergement.
Réécriture d'adresse
Par défaut, Zwe tentera d'utiliser des URL jolies, du type index.php/blog/42 plutôt qu'une requête barbare. Ceci est réalisé grace à PATH_INFO, qui est généralement intégré dans les serveurs web courants (Apache, lighttpd, ...), mais pas dans IIS par exemple. Si vous savez que votre hébergement ne supporte pas cette partie de la spécification CGI, n'oubliez pas de le désactiver pendant la procédure d'installation (la question vous sera posée).
Si vous souhaitez quand même avoir une ré-écriture d'adresse, voici le type de règle (à adapter à votre serveur et au fonctionnement de sa configuration) :
RewriteRule ^index.php/(.*)$ index.php?context=$1
Par exemple, avec Apache, il faudrait mettre cette ligne, accompagnée d'un RewriteEngine On dans un fichier .htaccess dans le répertoire htdocs/ de Zwe.
Première visite
Lors de votre première visite sur votre site, vous serez automatiquement redirigé vers la procédure d'installation intégrée à Zwe afin de permettre le fonctionnement du moteur (création des tables dans la base de données, prise d'informations, création du fichier de configuration). Quelque soit l'organisation de répertoires choisie (contenu de htdocs/ à la racine ou non), la procédure d'installation le détectera et configurera votre Zwe comme il faut.
Une fois cette procédure passée, votre site est prêt à fonctionner. Il est vivement conseillé de passer par le panneau d'administration de Zwe afin de finaliser la configuration.
Il est maintenant temps pour vous de voir comment utiliser votre Zwe !
