FAQ: Questions sur l'installation de phpGedView

Questions sur l'installation de phpGedView

Comment puis-je savoir si j'ai PHP sur mon site web, ou si je peux faire fonctionner des fichiers php?

En premier lieu vérifiez la documentation en ligne de votre hébergeur web. Souvent, les hébergeurs offrent une variété d'offres très diverses.

Si votre hébergeur ne vous fournit pas cette information, vous pouvez vérifier par vous-même en créant un nouveau document texte que vous appelerez test.php et dans lequel vous copierez la ligne suivante:

<?php phpinfo() ?>

Transférez ce nouveau fichier test.php sur votre site et ouvez-le avec votre navigateur web. Si vous avez PHP, vous verrez une page web qui détaille la version de php ainsi que beaucoup d'autres informations - celà signifie alors que phpGedView devrait fonctionner. Si PHP n'est pas installé, vous devriez alors avoir un message qui ressemble à celui-ci:

Sorry, no php.

Si vous êtes l'administrateur du serveur web et que vous souhaitez unstalle PHP, il vous suffit de télécharger ce logiciel à l'adresse suivante: http://www.php.net.

Quelle version de PHP faut-il pour faire fonctionner phpGedView?

PhpGedView nécessite au minimum PHP version 4.3.x. Certaines personnes réussissent à faire fonctionner phpGedView en utilisant PHP v4.2.x mais cette version n'est pas supportée par l'équipe de développement.

Pour réaliser les rapports, PHP doit être compilé avec le support XML. XML est compilé par défaut à moins qu'il n'ait été volontairement désactivé. Vous pouvez obtenir plus de détails ici: http://us3.php.net/manual/en/ref.xml.php

Quelques fonctions de phpGedView nécessitent la bibliothèque GD library et nécessitent que PHP soit compilé avec le support GD. La plupart des versions précompilées de PHP incluent le support GD. Si vous compilez PHP vous-même, vous devrez le configurer avec l'option --with-gd. Vous pouvez obtenir plus de détails ici: http://us3.php.net/manual/en/ref.image.php

Les fonctions avancées du calendrier de phpGedView pour la conversion des dates Grégoriennes en dates Hébreues ou juives nécessitent que PHP soit compilé avec l'option de configuration --enable-calendar. Vous pouvez obtenir plus de détails ici: http://us2.php.net/manual/en/ref.calendar.php

Quels sont les fichiers pour lesquels je dois modifier les permissions ?

Tous les fichiers ont des besoins en lecture. Les fichiers suivants doivent avoir des autorisations en écriture: config.php

Le répertoire suivant et son contenu a des besoins d'autorisation en écriture: ./index/

Si vous voulez utiliser les fonctions d'édition des langues, vous devrez paramétrer les permissions de tous les fichiers dans le répertoire./langages.

Si vous voulez transférer des fichiers media en utilisant la section de transfert des media du menu d’administration, alors vous avez besoin d’autoriser en écriture les répertoires ./media et ./media/thumbs directory

Si vous voulez éditer votre fichier GEDCOM en ligne, ce fichier doit avoir les permissions d’écriture pour l’utilisateur.

Référez-vous à la section installation du fichier readme.txt pour plus d’information.

La méthode pour autoriser en écriture les fichiers dependent de la configuration de votre serveur. Si vous avez un serveur qui fonctionne sous Windows, vous n’avez pas besoin de faire quoi que ce soit. Si vous utilisez FTP pour vous connecter à votre serveur, vous devez alors utiliser les commandes"permissions" ou "chmod". La commande "chmod" prend une série de chiffres tel que 755. Les trois nombres indiquent quelles sont les permissions du propriétaire du fichier, du groupe auquel appartient le fichier et de tout autre utilisateur. Ainsi le paramétrage 755 se traduit comme suit: Propriétaire = 7, Groupe = 5, Tout le monde = 5. La table suivante vous indique ce chaque chiffre signifie:

7 Lire, Ecrire, Exécuter
6 Lire, Ecrire
5 Lire, Exécuter
4 Lire
3 Ecrire, Exécuter
2 Ecrire
1 Exécuter
0 Aucun accès

Ainsi le paramétrage des droits d’un fichier à la valeur 755 signifient que pour ce fichier, le propriétaire peut le lire, y écrire, et l’exécuter. Le groupe d’utilisateurs de ce fichier peut le lire et l’exécuter. Et chacun peut le lire et l’exécuter.

Vous devez en premier lieu essayer de modifier les droits du fichier en utilisant la commande "chmod 755". Si cela ne fonctionne pas, cela signifie que le serveur web n’est pas prêt à l’exécuter; le propriétaire du fichier et vous-même devez alors essayer la commande "chmod 775". Si cela ne fonctionne pas, cela signifie que le serveur web n’est pas dans le même groupe que celui du fichier. A ce stade vous pouvez changer le groupe (cela nécessite souvent des droits d’administrateur sur le serveur) ou vous pouvez essayer la commande "chmod 777". Cette commande donne à chacun les droits d’accès au fichier.

PhpGedView affiche des messages d'erreurs lorsque j'importe des fichiers GEDCOM de taille trop importante. Aide ?

Il y a deux types de problèmes qui peuvent être la conséquence de l'import de fichiers GEDCOM de taille trop importante (>2MB). Pour pouvoir lire les informations qui sont contenues dans un fichier GEDCOM, le fichier doit être lu dans l'espace mémoire. PHP a une limite de taille mémoire disponible pour l'utilisateur. Par défaut cette taille est fixée à 8MB. Cette limite est une protection de votre hébergeur internet afin de sauvegarder l'utilisation des ressources des machines de votre hébergeur par les différents utilisateurs et éviter par exemple une saturation des machines qui pourrait provoquer une indisponibilité par manque de ressource. Cette valeur dépend de la version det de la configuration de PHP. Si vous utilisez un fichier GEDCOM de taille importante, vous devrez probablement doubler cette valeur. Pour changer cette valeur de la taille mamoire qui est allouée par PHP, éditez le fichier php.ini (qui est en génral situé à l'emplacement /etc/php.ini dans un environnement UNIX ou LINUX ou à l'emplacement C:\WINNT\php.ini dans un environnement windows) et modifiez la ligne suivante:

memory_limit = 8M

comme suit:

memory_limit = 16M

Une bonne option serait d'allouer une taille mémoire égale à 4 fois la taille de votre fichier GEDCOM. Ainsi, un fichier GEDCOM de 4Mb devrait pouvoir fonctionner avec une taille mémoire 16Mb accordée par PHP. De même, un fichier GEDCOM de 8Mb pourrait avoir besoin de 32Mb de mémoire accordée par PHP.

Après avoir édité votre fichier php.ini vous aurez besoin de redémarrer votre serveur web.

Cette solution n'est envisageable que si vous avez accès au fichier php.ini file, ce qui n'est possible que si vous disposez des droits d'administrateur sur le serveur. Si vous n'y avez pas accès, vous pouvez essayer de découper votre fichier GEDCOM en plusieurs fichiers de taille plus réduite.

Un autre problème peut apparaître, en particulier sur les machines Windows: il s'agit de la limite de temps de calcule qui est accordée, appelée "time limit". PHP a par défaut un "time limit" de 30 secondes. De nouveau, il s'agit là d'une mesure de sécurité afin d'éviter qu'un programme d'un utilisateur puisse mobiliser pendant trop longtemps le serveur du fait de calculs trop longs. Cette protection est également efficace contre certains hackers. Vous aurez dans ce cas un message d'erreur qui vous indiquera que vous avez dépassé le "time limit". Vous pouvez changer cette valeur de "time limit" en éditant ce paramètre dans le menu de configuration du fichier GEDCOM. Ce paramètre ne doit pas excéder 10 minutes. Une fois que vous avez modifié ce paramètre pour pouvoir importer ce gros fichier GEDCOM, il est conseillé de le réduire afin d'éviter qu'un utilisateur, en essayant d'afficher un arbre généalogique sur 40 générations, bloque les ressources de votre serveur penadnt 10 minutes !