Guide pas à pas pour une demande d'aide

Ce guide pas à pas est fait pour expliquer de manière précise et complète quels sont les paramètres que vous devez appliquer lorsque vous sollicitez un soutien sur le forum d'aide de Coppermine.

Nous admettrons que vous avez appliqué les bons réglages au niveau des droits, donc nous allons reprendre de manière plus précise et compliquée que normalement nécessaire sur la plupart des paramètres de serveur: les instructions ci-dessous sont prévues pour permettre le dépannage par les supporteurs, même si les autres utilisateurs de votre galerie ne sont pas autorisés à télécharger ou si vous avez interdit les nouvelles inscriptions. Si vous savez comment faire, vous pouvez sauter les étapes qui expliquent comment créer un nouveau groupe si tous les utilisateurs enregistrés sont autorisés à télécharger de toute façon. En fin de compte, l'important, ce qui compte, c'est que le supporteur puisse faire des téléchargements jusqu'à ce qu'il / elle puisse voir ce qui se passe réellement pendant le processus de téléchargement.

• Identifiez-vous en tant qu'administrateur

  Allez dans votre galerie Coppermine et identifiez-vous comme administrateur

• Créez le groupe "téléchargeurs"

  Les instructions suivantes pour la création d'un groupe ne s’appliquent que si vous utilisez Coppermine en mode indépendant. Si vous avez une passerelle pour votre galerie Coppermine, utilisez l'application avec laquelle vous êtes intégré pour créer le groupe "téléchargeurs".

  • Allez dans le gestionnaire de groupes en cliquant sur le lien correspondant du menu administrateur
  • Descendez au bas de la page
  • Cliquez sur le bouton "Créer un nouveau groupe"
  • Une nouvelle ligne apparait au bas de la table du gestionnaire de groupe. Cliquez dans le champ nom et entrez un nom qui à du sens, par exemple: "téléchargeurs"
  • Descendez en bas de page
  • Validez le formulaire en cliquant sur le bouton "Appliquer les changements"

• Donnez les droits de téléchargement au groupe "téléchargeurs"

  Les instructions suivantes sur la manière de donner les droits à un groupe s'appliquent aussi bien aux galeries intégrées qu’aux indépendantes.

  • Aller dans le gestionnaire de groupes en cliquant sur le lien correspondant du menu administrateur
  • Pour le groupe "téléchargeurs" que vous avez créé à l'étape précédente, réglez l'option "Autorisé" à "Oui" dans la colonne "Téléchargements dans les albums publics". Paramétrez l'option "Approbation" sur "Non" dans cette cellule.
  • Descendez en bas de page
  • Validez le formulaire en cliquant sur le bouton "Appliquer les changements"

• Créez un compte utilisateur de test non administrateur

  Les instructions suivantes pour la création d'un utilisateur ne s'appliquent que si vous utilisez Coppermine en mode indépendant. Si vous avez une passerelle pour votre galerie Coppermine, utilisez l'application avec laquelle vous êtes intégré pour créer le nouvel utilisateur.

  • Aller dans le gestionnaire d'utilisateurs en cliquant sur le lien correspondant du menu administrateur
  • Descendez en bas de page
  • Cliquez sur le bouton "Créer un nouvel utilisateur"
  • Sur la page suivante, entrez un nom d'utilisateur facile à retenir et à entrer - nous recommandons quelque chose de simple comme "testeur", de préférence sans majuscules.
  • Donnez un mot de passe facile - ce peut être le même que le nom d'utilisateur.
  • Assignez cet utilisateur au groupe "téléchargeurs" que vous avez créer avant – assurez-vous que la valeur du champ de la liste déroulante des groupes est bien "téléchargeurs" (ou n'importe quel nom que vous avez choisi pour ce groupe supplémentaire).
  • Descendez en bas de page et validez le formulaire.

• Créez un album dans lequel les fichiers téléchargés pourront être placés

  Pour l'instant nous avons créé un groupe spécial qui est autorisé à télécharger dans les albums publics, mais nous n'avons pas défini dans lequel ces téléchargements sont autorisés. Nous devons tout d'abord créer cet album.

  • Aller dans le gestionnaire d'albums en cliquant sur le lien correspondant du menu administrateur
  • Choisissez une catégorie dans laquelle cet album test sera créer - choisissez la catégorie dans la liste déroulante du gestionnaire d'albums. Pour plus de facilité, il est recommandé de créer l'album à la racine de la galerie (sélectionnez "* Pas de catégorie *" dans la liste déroulante).
  • Cliquez sur le bouton "Nouvel album" au bas de la page du gestionnaire d'albums
  • Un champ de saisie s'affiche. Entrez le nom du nouvel album comme par exemple "album test" et validez le formulaire en cliquant sur le bouton OK

• Autorisez le téléchargement dans l'album test

  L'album dans lequel seront placés les téléchargements existe, mais pour l'instant personne, à part l'administrateur, n'a le droit d'y télécharger. Autorisons le téléchargement dans cet album.

  • Allez à l'index de la galerie ne cliquant sur le lien "Album" du menu général de la galerie
  • Allez à la catégorie dans laquelle vous avez crée l'album test (si vous avez fait comme nous l'avons suggéré et créer l'album à la racine de la galerie, vous devriez être au bon endroit, donc pas besoin de faire quoi que ce soit ici pour vous)
  • Cliquez sur le bouton "Propriétés" à côté de la vignette vide représentant l'album de test
  • Dans la page propriétés de l'album paramétrez "Les visiteurs peuvent télécharger des fichiers" sur "Oui"
  • Si votre galerie à beaucoup de trafic et que vous ne voulez pas prévenir vos visiteurs qu'il y a un album test choisissez "Membres du groupe 'téléchargeurs'" dans la liste déroulante "Les visiteurs peuvent télécharger des fichiers"
  • Allez en bas de page et validez le formulaire en cliquant sur le bouton "Mettre à jour l'album"

• Set "Méthode de téléchargement par défaut" sur "Simple"

  • Allez à la page de configuration
  • Descendez à la section "Paramètres des utilisateurs" et déployez-la en cliquant dessus
  • Réglez Méthode de téléchargement par défaut sur "Simple - un seul fichier à la fois"
  • Descendez en bas de page
  • Sauvegardez les nouveaux réglages en cliquant sur "Sauvegarder la nouvelle configuration"

• Activez le "mode de débogage"

  • Allez à la page de configuration
  • Descendez à la section "Paramètres de maintenance" et déployez-la en cliquant dessus
  • Activez le mode de débogage pour tout le monde en cliquant sur "Oui: Tout le monde" dans la ligne "Activez le mode de débogage"
  • Laissez l'affichage des avertissements placé sur off - si la case à cocher "Afficher les avertissements en mode de débogage" est cochée, décochez la (les avertissements ne s'adressent qu'aux développeurs - si vous ne savez pas ce qu'ils veulent dire, ne les affichez jamais)
  • Descendez en bas de page
  • Sauvegardez les nouveaux réglages en cliquant sur "Sauvegarder la nouvelle configuration"

• Testez le téléchargement en utilisant le compte de l'utilisateur test

  Vous pourriez être tenté d'aller directement demander de l'aide, mais attendez une minute: vous n'avez pas essayé par vous même si tout fonctionne correctement maintenant. Vous n'allez pas ouvrir un sujet de demande d'aide sur le forum juste pour vous entendre dire "faites d'abord vos devoirs" (parce que c'est ce qui va vous arriver si vous ne faites pas ce qui est demandé ici). Voici ce que vous devez faire:

  • Déconnectez-vous de Coppermine (ou utilisez un autre navigateur) si vous êtes connectés en tant qu'administrateur
  • Identifiez-vous en utilisant le compte de l'utilisateur test que vous avez créé précédemment (compte non-administrateur). Si la connexion échoue, vérifiez le détail de ce compte en étant identifié en tant qu'administrateur.
  • Cliquez sur lien du menu "Télécharger un fichier". Si vous n'avez pas ce line de téléchargement, vous avez mal paramétré les droits - vérifiez les étapes précédentes avec attention.
  • Sur la page de téléchargement, choisissez l'album test dans la liste déroulante "Album" Si vous ne pouvez pas sélectionner l'album test, vous avez du faire une erreur lors du paramétrage des droits
  • Cliquez sur le bouton "Parcourir..." et cherchez une petite image au format JPG réputée bonne sur votre disque dur. Ne croyez pas que n'importe quelle image fera l'affaire: dans le doute téléchargez une image depuis la galerie de démonstration de Coppermine
  • Validez le formulaire en cliquant sur le bouton "Télécharger un fichier"

  Dans un monde idéal, tout devrait marcher comme prévu - votre téléchargement devrait se passer sans problèmes et vous devriez voir l'image téléchargée dans une page Coppermine. Si c'est le cas, le téléchargement par HTTP fonctionne correctement. Si ce n'est pas le cas, vous devriez avoir un message d'erreur qui explique ce qui ne va pas. Si vous n'arrivez pas à comprendre ce que le message d'erreur veut dire, mais que vous avez pu faire toutes les étapes précédentes, y compris la dernière (la validation du formulaire), alors, allez y demandez de l'aide sur le forum de Coppermine. Vous serez aussi les bienvenus pour demander de l'aide si le téléchargement par HTTP fonctionne correctement et que vous souhaitez de l'aide pour une autre méthode de téléchargement.

• Postez votre demande d'aide sur le forum de Coppermine

  • Allez sur le Forum d'aide de Coppermine
  • Créez un nouveau compte sur le forum si vous n'en avez pas déjà un et identifiez-vous.
  • Assurez-vous d'avoir bien lu les règles du forum avant de poster (il y a un lien vers les règles du forum dans le menu de celui-ci)
  • Commencez un nouveau sujet dans le forum correspondant à votre version de Coppermine. Comme vous venez de lire la documentation de cpg1.5.x, vous utilisez certainement celle-ci, vous devrez donc commencer votre nouveau sujet dans la section correspondant à cette version (ou sur le forum francophone si vous ne parlez pas ou mal l'anglais). Poster dans la section d'une autre version n'est pas une bonne idée, cela n'apportera que de l'irritation de la part des supporteurs et de vous même. Comme vous avez des problèmes avec le téléchargement, vous devriez poster dans la section qui s'y rapporte.
  • Dans votre message, assurez-vous de mettre un lien vers votre galerie. Si votre galerie à un contenu destiné aux adultes (le nu soft entre dans cette catégorie) n'oubliez pas de le signaler de manière claire avec votre lien
  • Postez les détails du compte de l'utilisateur test (nom d'utilisateur et mot de passe) que vous avez défini précédemment
  • C'est une bonne idée de montrer aux supporteurs que vous avez essayé par vous même avant de demander de l'aide - expliquez ce qui ne fonctionne pas correctement jusqu'ou vous avez pu aller, quel message d'erreur vous avez eu etc...

Exemple de demande d'aide

Messages d'erreur: failed to create stream: Operation not permitted

Impossible to move somepic.jpg to albums/userpics/
Warning: move_uploaded_file(/tmp/phpezCYKr)
[function.move-uploaded-file]: failed to create stream: Operation not permitted

Impossible to move X to Y

Impossible to move somepic.jpg to albums/userpics/XXXXX/

Messages d'erreur: failed to open dir: No such file or directory

Warning: opendir(./albums/edit): failed to open dir: No such file or directory

Messages d'erreur: Sorry there is no album where you are allowed to upload files

Sorry there is no album where you are allowed to upload files

Messages d'erreur: Allowed memory size of X bytes exhausted

Fatal error: Allowed memory size of XXXXXXX bytes exhausted at (null):0 (tried to allocate XXXX bytes) in /var/www/html/include/picmgmt.inc.php

Messages d'erreur: Exec() has been disabled

Exec() has been disabled

Messages d'erreur: Not a GD extension

Not a GD extension

Messages d'erreur: Error executing ImageMagick - Return value 127

The file 'albums/userpics/10001/somepic.jpg' can't be inserted in the album. Error executing ImageMagick - Return value 127

Messages d'erreur: PHP running on your server does not support the GD image library

PHP running on your server does not support the GD image library, check with your webhost if ImageMagick is installed.

Messages d'erreur: No file was uploaded !

No file was uploaded ! If you have really selected a file to upload, check that the server allows file uploads...

Messages d'erreur: Destination directory X is not writable by the script

Destination directory albums/userpics/XXXXX/ is not writable by the script

Le fichier de configuration de PHP php.ini

Les choses à vérifer

Si vous êtes hébergés, vous devrez consulter votre hébergeur à propos des paramètres suivants. Vous pouvez voir (mais pas modifier) ces paramètres sur votre page phpinfo.

1. max_input_time

   60 secondes est la limite de temps par défaut pour le téléchargement de fichiers.
   Cette limite de temps inclue le temps mis pour télécharger les fichiers, donc, si vous dépassez cette limite, le fichier ne sera même pas analysé, et le navigateur n'obtiendra pas de réponse. Vous pouvez contourner cette limite en essayant de télécharger des fichiers plus petits ou moins nombreux, ou vous pouvez essayer de télécharger sur une bande passante plus large. La meilleure solution, bien sur est d'augmenter la limite de temps à une valeur qui se rapproche de ce dont vous avez besoin.

2. upload_max_filesize

   2MB est la valeur par défaut de la limite pour chaque fichier.

3. post_max_size

   8MB est la limite oar défaut pout les requêtes postées.

4. memory_limit

   8MB est la taille par défaut. Lisez Utilisation de la mémoire pendant le redimensionnement pour les instructions sur la manière de changer ce paramètre et de contourner les messages d'erreurs relatifs au fait d'avoir atteins la limite de mémoire.

5. LimitRequestBody

   512KB est la limite par défaut. (Plutôt un problème sur les systèmes Redhat/Apache. Trouvez dans /etc/http/conf.d)
   En général, pour que les téléchargements fonctionnent correctement il faut que upload_max_filesize < post_max_size < memory_limit Coppermine peut vous prévenir lorsqu'un fichier est plus grand que upload_max_filesize, mais il ne peut pas vous prévenir si la taille totale des fichiers excède la limite de postage ou de mémoire.

6. file_uploads

   Détermine si PHP autorise ou non les téléchargements. La valeur de ce paramètre doit être "On".

7. upload_tmp_dir

   Détermine le répertoire temporaire dans lequel PHP stocke les fichiers téléchargés.
   Le problème le plus commun causé pas ce paramètre est une alerte open_basedir. Dans ce cas, l'administrateur de votre serveur a restreint les fichiers utilisables par PHP à un répertoire précis. S’il ne crée pas de répertoire temporaire spécifique dans la restriction open_basedir, PHP va essayer d'utiliser le répertoire temporaire de l'OS, et il sera rejeté par la restriction open_basedir.

Mécanismes/méthodes de téléchargement

Quelques notes à propos des différents types de mécanismes de téléchargement disponibles depuis cpg1.3.x (ou plus récent):

Les téléchargements multiples par HTTP sont prévus pour gérer un petit nombre de fichiers. Par conséquent, ils ne sont pas bien adaptés pour le téléchargement d'un grand nombre de fichiers, sauf si vous utilisez votre propre serveur web ou exercer un contrôle sur la configuration php.ini.

Si vous cherchez à télécharger plus que 15 ou 20 fichiers à la fois, vous devrez préférer l'ajout par lots ou l'utilitaire XP Publisher. Ils ont chacuns leurs avantages et leurs inconvénients.

Le processus d'ajout par lot est rapide, mais il crée une assez grosse charge sur le serveur, avec pour conséquence, d'éventuels timeouts qui termineront vos téléchargements prématurément. XP Publisher, de l'autre côté, est sensiblement plus lent, mais limite la charge du serveur. Elle contourne également bon nombre des écueils causés par les restrictions énoncées dans la configuration php.ini en téléchargeant chaque fichier du lot en cours de téléchargement comme une requête individuelle.

D'autres méthodes de téléchargement (comme JUpload ou autres) peuvent être proposées par des contributions tierces - Nous vous encourageons à y jeter un œil, mais gardez en mémoire que les développeurs de Coppermine ne peuvent apporter qu'une aide limitée aux contributions tierces.

N'oubliez pas non plus qu'avant d'utiliser une méthode de téléchargement alternative, vous devez vous assurer que la méthode initiale de téléchargement par "http" fonctionne correctement - si ce n'est pas le cas, vous devez corriger cela d'abord; cela n'a pas de sens d'essayer une méthode alternative si la méthode originelle ne fonctionne pas.

Utilisation de la mémoire pendant le redimensionnement

Il n'y a (en principe) aucune limite dans Coppermine concernant la taille ou le poids des fichiers que le script peut gérer. Toutefois, il y a au moins une limite existante sur le serveur: le redimensionnement d'images (pour créer des images intermédiaires et/ou les vignettes) utiliser de la mémoire et des ressources processeur.

Si le processus de redimensionnement utilise trop de mémoire, vous aurez généralement un message d'erreur du type Fatal error: Allowed memory size of XXXXXXX bytes exhausted at (null):0 (tried to allocate XXXX bytes) in /var/www/html/include/picmgmt.inc.php ou similaire.

Pour prévenir les crashs du serveur, l'administrateur du serveur à limité le volume de la mémoire que PHP est autorisé à utiliser. C'est fait en utilisant le paramètre memory_limit.

Vous pouvez être tenté de croire que l'utilisation de la mémoire est égale la taille utilisée par une image dans le système de fichiers, mais ce n'est pas le cas: le format commun de fichier JPEG est compressé, donc si le serveur charge un fichier JPEG en mémoire, il consomme plus de RAM que la taille du fichier.

Pour calculer le volume de mémoire utilisé par une image, multipliez simplement la largeur et la hauteur en pixels, puis multipliez le résultat par le nombre de couleurs de base (RGB -> 3, CMYK -> 4). Finalement divisez le résultat par 1 048 576 (2²⁰) pour avoir un résultat en MB.

Voici quelques résolutions d'images habituelles et leur utilisation de mémoire avec GD (en RGB):

Rappelez-vous, lorsque vous utilisez les chiffres ci-dessus que la quantité de mémoire utilisée par le reste de Coppermine doit aussi être prise en compte.

Comme vous le voyez, la consommation de mémoire des images produites par les appareils photos numériques modernes peuvent facilement dépasser les possibilités de votre serveur, même en utilisant le téléchargement simple (ne parlons pas de la consommation de mémoire lorsque vous utilisez l'ajout par lot), il est donc recommandé de redimensionner vos images sur votre ordinateur avant de les télécharger: si le serveur ne peut simplement pas traiter les images téléchargées, il est difficile de blâmer le script (Coppermine) ou de demander de l'aide sur le forum de Coppermine: les développeurs de Coppermine ne peuvent pas trouver de remèdes pour la technologie utilisée sur votre serveur. Utilisez le serveur pour ce à quoi il a été destiné; réalisez les processus demandant de grosses ressources sur votre ordinateur (comme le redimensionnement d'images en haute résolution).

Pour augmenter la limite de mémoire allouée dans le php.ini, vous devez être l'administrateur du serveur. Donc, un fichier .htaccess ne changera pas ce paramètre, et il ne peut pas être changé en utilisant ini_set(). Ceci dit, la plupart des utilisateurs de Coppermine qui utilisent un serveur mutualisé ne sont pas en mesure de faire ces changements. Si vous êtes l'administrateur du serveur, voici comment augmenter la limite de mémoire:
Trouvez d'abord le bloc ci-dessous dans le fichier php.ini (si vous êtes l'administrateur du serveur):

;;;;;;;;;;;;;;;;;;;
; Resource Limits ;
;;;;;;;;;;;;;;;;;;;

max_execution_time = 30     ; Maximum execution time of each script, in seconds
max_input_time = 60        ; Maximum amount of time each script may spend parsing request data
memory_limit = 8M      ; Maximum amount of memory a script may consume (8MB)

Maintenant augmentez la limite de mémoire en fonction de vos besoins. Une valeur entre 9 et 16 MB devrait convenir à la plupart des besoins.