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 échoue lors de l’import de fichiers GEDCOM de taille importante?

Il y deux raisons qui peuvent expliquer ce problème avec des fichiers GEDCOM de taille importante (>2MB): mémoire insuffisante et temps d’exécution insuffisante.

Mémoire insuffisante

Afin de rechercher les informations dans un fichier GEDCOM, ce fichier doit être ouvert et lu par la mémoire du serveur web. PHP a une limite par défaut de la taille mémoire de 8MB. Cette limite constitue une protection contre les scripts malicieux qui essaient d’accaparer toutes les ressources de la machine et de la bloquer. En fonction de la version/configuration de votre PHP et si vous importez une fichier GEDCOM de taille importante, vous devrez probablement doubler cette valeur limite, notamment pendant la phase d’import.

Un bonne règle est d’allouer 4 fois la taille de votre fichier GEDCOM. En règle générale, un fichier GEDCOM de 4MB gedcom ne devrait pas avoir besoin de plus de 16MB de mémoire dans PHP. Cependant un fichier GEDCOM de 8MB peut demander jusqu’à 32MB de mémoire PHP. A titre d’exemple, un fichier GEDCOM de 11MB d’un utilisateur a nécessité environ 150 MB de mémoire PHP.

Lorsque PHP fonctionne dans un environnement Windows, il n’y a pas de limite de mémoire (memory_limit”).'

Editer le fichier php.ini

L’option la plus simple pour augmenter la mémoire est d’éditer le fichier edit php.ini. Cependant, cela n’est possible que si vous êtes administrateur du serveur. Pour modifier le montant de la mémoire allouée à PHP, éditez le fichier php.ini (qui est en général situé dans le répertoire /etc/php.ini sur Unix) et modifiez la ligne suivante:

memory_limit = 8M

comme suit :

memory_limit = 16M

Après modification de ce fichier php.ini vous avez besoin de redémarrer votre serveur web.

Editer les fichiers source de phpGedView

Si vous n’avez pas le droit de modifier le fichier edit the php.ini file, vous pouvez éditer le fichier "include/functions.php" ainsi que le fichier "importgedcom.php" et ajouter sur la seconde ligne dans ces deux fichiers la ligne suivante : ini_set("memory_limit", "16M")

Alternative

Comme alternative pour augmenter le maéloire, essayez en premier lieu les options de nettoyage indiquées à l’étape #3. Si cela ne fonctionne pas, essayez de découper votre fichier GEDCOM de taille importante en plusieurs fichiers de taille plus petite.

Temps insuffisant

Un autre problème qui peut arriver, notamment sur les machines qui fonctionnent sous Windows, est la limite de temps d’exécution qui peut être dépassée (run out). PHP a par défaut un temps limite d’exécution des scripts de 30 secondes. A nouveau, il s’agit d’une mesure de sécurité pour prévenir les scripts malicieux et pour éviter que les hackers ne puissent bloquer votre serveur. Vous obtiendrez habituellement un message d’erreur si vous dépassez ce temps limite. Vous pouvez modifier ce temps limite en éditant le paramètre « temps limite » dans le menu de configuration du fichier GEDCOM.

Cela ne devrait jamais vous prendre plus de 10 minutes. Une fois que vous avez importé votre fichier GEDCOM dans votre base de données, vous pouvez restaurer cette limite de temps à 30 secondes afin d’éviter que quelqu’un essaie d’afficher un diagramme d’ascendance ou de descendance sur 40 générations et bloque ainsi votre serveur 10 minutes.

J’ai importé des noms de mariage durant la phase d’import. Pourquoi alors ne puis-je pas les afficher?

Vous devez paramétrer "Montrer le nom des femmes mariées dans les listes" à Oui. Pour le faire, allez à :
Administration > Gérer les fichiers GEDCOMs > Configuration GEDCOM > Options d’affichage > Affichage des noms >

J’ai installé phpGedView mais les diagrammes sont vides et/ou j’obtiens des messages d’erreurs?

Cela signifie habituellement que l’import de votre GEDCOM ne s’est pas achevé correctement. Vous devez essayer d’importer une nouvelle fois votre GEDCOM en vous connectant en tant qu’administrateur puis vous diriger sur la page d’administration puis sur la page de configuration du GEDCOM. Ensuite, cliquez le lien d’import du fichier GEDCOM que vous voulez importer. S’il vous est proposé de supprimer votre GEDCOM, vous devez cliquer sur le bouton «supprimer ». S’il vous est proposé de vider la base de données, cliquez sur « Oui ».

Durant la phase d’import de votre GEDCOM, vous verrez une barre de progression qui vous indique qul pourcentage de votre GEDCOM a été importé, ainsi qu’une barre de pourcentage qui vous affiche le pourcentage de temps d’exécution utilisé. Lorsque votre import est terminé, vous devez voir affichés quelques informations statistiques ainsi que des liens sur la droite de l’écran qui vous dirigent sur d’autres pages.

Si ces informations n’apparaissent pas à l’écran ou si vous obtenez des messages d’erreurs, vous devez alors rechercher dans la section FAQ de ce PGWiki les informations qui vous guideront sur la démarche à suivre pour résoudre votre problème. Si vous ne trouvez pas la réponse à votre question ici, vous devez alors poster un message sur le forum d’entraide : http://forum.fr.phpgedview.free.fr/phpBB2/index.php.