Communauté Elgg francophone

Créer un compteAide  
Connexion

Installation en français

Mode d'emploi de l'installation d'Elgg en français

 

Pré-requis techniques

Elgg tourne sur une combinaison de serveur Web Apache, base de données MySQL et le langage de script PHP interprété. Il s'agit de l'environnement de serveur web le plus populaire au monde.

Pour utiliser les fonctionnalités avancées de Elgg, quelques fonctionnalités sont requises :

  • Le serveur web Apache doit être installé avec la suite de modules :
    • mod_rewrite
    • PHP
  • MySQL 5 est nécessaire pour le stockage des données
  • PHP 5.2 doit être installé en tant que module Apache (et non en mode CGI ou mode sans échec) avec les bibliothèques suivantes :
    • GD (pour les processeurs graphiques, par exemple, l'utilisateur icône de rééchelonnement)
    • JSON (pour les fonctions API)


Il est recommandé d'augmenter la mémoire disponible pour PHP au-delà de la norme 8 ou 12M, et d'augmenter la taille maximum des fichiers téléchargés (par défaut à 2Mo). Dans les deux cas, cela peut être fait via votre fichier php.ini (ou .htaccess sur un serveur mutualisé).

  • Les bibliothèques PHP suivantes sont également recommandés pour certains plugins et des fonctionnalités supplémentaires:
    • mbstring (pour permettre l'envoi de mails avec des caractères non-latins)
    • SOAP
    • DOM

 

Installation de Elgg

Avant de commencer, assurez-vous que vous avez lu les pré-requis techniques d'Elgg. Si vous constatez des problèmes après avoir suivi ces instructions, consultez la page de dépannage http://docs.elgg.org/wiki/Troubleshooting

  1. Téléchargez Elgg
    • Décompressez Elgg et transférez-le (via FTP) sur votre site : soit à la racine de votre site web, soit dans un sous-dossier spécifique
  2. Créer une dossier de données
    • Elgg a besoin d'un dossier pour stocker les fichiers téléchargés, ainsi que les icônes et photos de profil. Vous aurez besoin de créer un dossier spécifique pour cela. Nous recommandons que ce dossier soit appelé data, et stocké hors du dossier d'installation de Elgg. Par exemple, si Elgg est installé dans /home/Elgg/html/, vous pouvez créer le dossier de données dans /home/Elgg/data.
    • Une fois que ce dossier a été créé, vous devez vous assurer que Elgg a l'autorisation d'y écrire.
      • Cela ne devrait pas être un problème sur les serveurs à base de Windows mais si votre serveur fonctionne sous Linux ou une variante d'Unix, vous aurez besoin de taper quelque chose comme : chmod 777 /home/Elgg/data/
      • N'oubliez pas de configurer votre open_dir si vous l'utilisez, pour permettre l'écriture dans ce dossier.
      • Si vous utilisez un client graphique pour télécharger des fichiers, vous pouvez habituellement modifier ce droit ou shift-clic sur le dossier et la sélection «propriétés»
  3. Créer une base de données
    • En utilisant votre outil habituel d'administration de base de données - par ex. cPanel, phpMyAdmin, MySQL commandline client (si vous n'êtes pas sûr à ce sujet, demandez à votre administrateur système), créez une nouvelle base de données pour Elgg. Assurez-vous de connaître le nom d'utilisateur et votre mot de passe nécessaire pour accéder à cette base.
  4. Installez votre crontab (Unix uniquement)
    • Cron est une commande Unix qui permet d'exécuter dfes programmes à divers moments de la journée (c'est un programmateur).
    • Si vous voulez profiter de certaines des fonctions d'entretien telles que la rotation du fichier log ou la "collecte des ordures" (garbage collector), vous devez installer un plugin cron qui permet de déclencher ces événements.
    • Nous avons fourni un exemple de crontab/crontab.example. Vous pouvez dupliquer ce fichier pour le modifier avec un éditeur de texte afin de lui fournir les détails de votre site, puis l'installer avec la commande suivante : Crontab crontab.mine (si vous avez nommé votre cron crontab.mine)
  5. Visitez votre site Elgg
    • Une fois que vous avez effectué ces étapes, consultez votre Elgg dans votre navigateur. Elgg vous guidera à travers la suite du processus d'installation. Le premier utilisateur que vous créez sera votre compte administrateur : conservez bien le mot de passe que vous lui donnez : il ne sera jamais transmis par mail.

 

Fichiers de paramètres et .htaccess

L'installateur Elgg va essayer de créer deux fichiers pour vous :

  • engine/settings.php, qui contient les paramètres de base de données de votre installation
  • .htaccess, Elgg qui permet de générer des URL dynamiques


Si ces fichiers ne peuvent pas être générés automatiquement, par exemple pour un problème de droits d'écriture sur les répertoires, voici comment procéder manuellement :

  • Copiez /engine/settings.example.php vers engine/settings.php, ouvert dans un éditeur de texte et de remplir votre base de données d'informations
  • Copiez /htaccess_dist vers /.htaccess

 

Installation sur un serveur virtuel (par ex. Rackspace, Amazon EC2)

 

Pour terminer correctement l'installation, modifiez le fichier .htaccess : trouvez # RewriteBase / et "dé-commentez" la ligne pour ne laisser que RewriteBase /

 

Instructions spécifiques pour divers systèmes d'exploitation (OS)

à traduire...

 

La version à jour de ce document est disponible sur : http://docs.elgg.org/wiki/Installation - n'hésitez pas à ajouter et traduire ici toutes informations utiles pour compléter ce guide d'installation !

 

Commentaires