# Coppermine Photo Gallery v1.5.x: Documentation et manuel

# Dépannage du téléchargement

Si vous avez des problèmes de téléchargement, lisez cette page – entièrement ! L'équipe de développement de Coppermine considère cette page comme la plus importante de toute la documentation, simplement parce qu'il peut y avoir plusieurs choses qui peuvent mal se passer lors du processus de téléchargement. Ces problèmes sont le plus souvent causés par de mauvais paramétrages du serveur.

## Permissions

En premier lieu et avant tout: Vérifiez les paramètres des droits des répertoires `/albums`, `/albums/userpics`, et `/albums/edit`. Sur les serveurs tournant sous *nix le répertoire `/albums` et tous ses sous-répertoires doivent être sur 777 ou 755 (en fonction de la configuration du serveur). Si vous ne savez pas ce que nous voulons dire par 777 ou 755, vous devrez lire la section concernant les droits (si ça ne vous aide pas, faites une recherche Google sur les droits des fichiers UNIX). Windows a un système de droits similaire. Vous pouvez généralement paramétrer ces droits en utilisant un client FTP (Si vous ne savez pas ce qu'est un client FTP faites une recherche sur Google pour client FTP ou jetez un œil sur la liste des outils recommandés).

Pour ceux qui passent sur les déclarations écrites en rouge, nous allons nous répéter pour essayer d'attirer votre attention:
Oui, nous écrivons sur des choses qui peuvent facilement s'appliquer à vous

Nous le répétons - vérifiez/appliquez les permissions aux répertoires `/albums`, `/albums/userpics`, et `/albums/edit`. Tous devraient être sur 777 ou 755 (en fonction des paramètres de votre serveur) ou de manière à donner à Coppermine les droits d'accès en écriture.

Oui, nous voulons que vous appliquiez ces droits pour chaque répertoire, même si vous pensez que vous l'avez déjà fait. Oui nous le voulons Non, juste vérifier les droits (ex. regarder ce que votre client FTP déclare au niveau des droits) n'est pas suffisant. Comme nous l'avons déjà dit: paramétrez/appliquez les droits, ne faites pas juste une vérification.

## Activez les paramètres de dépannage

Si vous rencontrez des problèmes avec le processus de téléchargement de Coppermine, changez temporairement les paramètres de Coppermine comme expliqué plus bas pour avoir des messages d'erreurs plus détaillés. Cela s'applique à toutes les méthodes de téléchargement, pas uniquement aux téléchargements par HTTP.

Détails
Même si vous avez des problèmes avec l'ajout d'images par lots (ou pour toute autre méthode de téléchargement), vous devez suivre les étapes détaillées ci-après ce qui vérifient les téléchargements par HTTP, parce que le téléchargement par HTTP est la méthode de téléchargement la plus basique et qu'elle doit fonctionner dans toutes les circonstances.
Si vous êtes sur le point de demander de l'aide à propos de problèmes de téléchargement sur le forum de Coppermine, il est impératif que vous ayez suivi scrupuleusement les étapes détaillées ci-dessous.

Pour le dépannage de problèmes de téléchargement dans CPG 1.5, il vous est demandé d'activer le 'Mode de débogage' dans la page de configuration. Le changement de ce paramètre annule le masquage des erreurs lors des téléchargements multiples. Cela vous permettra d'avoir des messages d'erreurs plus détaillés.

- Identifiez-vous en tant qu'administrateur
  Allez sur votre galerie Coppermine et identifiez-vous en tant qu'administrateur
- Paramétrez "Méthode de téléchargement par défaut" à "Simple"
  - Allez sur la page de configuration
  - Descendez jusqu'à la section "Paramètre des utilisateurs" et développez là en cliquant dessus
  - Paramétrez Méthode de téléchargement par défaut à "Simple - un fichier à la fois"
  - Descendez jusqu'au bas de la page
  - Sauvegardez les nouveaux réglages en cliquant sur "Sauvegardez la nouvelle configuration"
- Activez le "mode de débogage"
  - Allez à la page de configuration
  - Descendez à la section "Paramètres de maintenance" et développez 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 sur off - si la case à cocher "Afficher les avertissements dans le mode de débogage" est cochée, décochez la (les avertissements ne sont là que vous les développeurs - si vous n'avez pas idée de ce qu'ils signifient, cachez-les de manière permanente)
  - Descendez jusqu'au bas de la page
  - Sauvegardez les nouveaux réglages en cliquant sur "Sauvegardez la nouvelle configuration"
- Allez à la page de téléchargement en cliquant sur le lien "télécharger un fichier" dans le menu principal de Coppermine
  La page de téléchargement par HTTP vous sera accessible, à vous en tant qu'administrateur, dans tous les cas. Ce n'est pas le cas pour les visiteurs non-administrateurs de votre galerie: l'affichage du lien dans le menu dépend des droits que vous leur avez assignés.
- Sur la page de téléchargement de fichiers, choisissez un album depuis la liste déroulante "Album"
  Si vous n'avez pas d'album sélectionnable dans la liste, vous n'avez pas encore créé d'album. Vous devez comprendre que vous devez avoir au moins un album ou vous pourrez placer vos images. Allez dans le gestionnaire d'albums et créez au moins un album, puis essayez à nouveau de télécharger.
- Cliquez sur le bouton "Parcourir..." et cherchez une petite image, connue sans problèmes et au format JPG sur votre disque dur.
  Ne croyez pas que n'importe quelle image ira - le terme "sans problèmes" signifie dans ce cas une image qui a déjà été traitée par Coppermine, afin d'être sur que Coppermine peut l'utiliser - cela peut être réalisé facilement en téléchargeant une image de la démo de Coppermine depuis la page initiale de Coppermine.
- Validez le formulaire en cliquant sur le bouton "Télécharger le fichier"
  En validant le formulaire, vous lancez le processus de téléchargement - tout ce que vous avez fait avant n'était qu'une préparation.

Vous devez essayer d'utiliser le téléchargement par HTTP, même si vous avez des problèmes avec une autre méthode. Vous aurez un message d'erreur plus détaillé, si quelque chose se passe mal et vous indiquera exactement ce qui ne fonctionne pas avec votre téléchargement. Si le message d'erreur ne signifie rien pour vous, cherchez sur le forum d'aide pour le message d'erreur que vous avez eu.

Si vous n'avez pas de message d'erreur, vous avez probablement surchargé le serveur avec vos essais précédents. Merci de regarder les limitations côté serveur qui peuvent s'appliquer à vous.

## Demander de l'aide pour des problèmes de téléchargement

Lorsque vous demandez de l'aide sur le forum de Coppermine, postez un lien vers votre site et un compte utilisateur de test (L'utilisateur de test ne doit pas avoir de droits d'administrateur !) avec des droits de téléchargement, et les réglages mentionnés plus haut en place - de cette manière, les supporteurs pourront aussi voir les messages d'erreurs. Ne postez pas la sortie de débogage sans y avoir été invité. Si vous voulez avoir des résultats rapides, vous devrez désactiver l'approbation des téléchargements par l'administrateur pour le groupe d'utilisateur de l'utilisateur test, ainsi les supporteurs pourront dire instantanément ce qui ne va pas sans une double vérification.

Lorsque des personnes ont des problèmes avec le téléchargement et décident de poster leurs questions sur le forum de Coppermine, il leur est souvent demander de lire cette section de dépannage des téléchargements. Beaucoup d'entre eux ne le font pas correctement, avec comme résultat des frustrations aussi bien du coté de l'utilisateur que du supporteur.
Pour être très clair: les étapes décrites ci-dessus sont absolument obligatoires, quelles que soient vos connaissances, quelle que soit la méthode de téléchargement qui vous pose problèmes. Ne pas faire exactement ce qui est demandé fera que vous n'obtiendrez pas d'aide. Oui cela s'applique aussi à vous. Nous vous l'assurons !

Pas sûr de savoir quoi faire maintenant ? Lisez la suite:

### 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

Voici comment votre demande d'aide devrait se présenter (assurez-vous de bien compléter les données en rouge avec vos données à vous):

J'ai un problème avec le téléchargement dans ma galerie Coppermine http://exemple.com/mon_dossier_coppermine/
Lors de l'utilisation du téléchargement par HTTP, avec les réglages recommandés pour le dépannage des téléchargements en place, j'ai le message d'erreur suivant
[code]Le texte de votre message d'erreur ici[/code]
Voici les données de mon compte utilisateur test:
Nom d'utilisateur: testeur
Mot de passe: truc
J'ai utilisé l'image prise ici http://exemple.com/chemin_vers_l_image/file.jpg comme exemple pour les tests.
En faisant comme indiqué dans http://forum.coppermine-gallery.net/un_sujet_du_forum ça ne fonctionne pas comme prévu: j’ai
[code]Un autre message d’erreur[/code]
en essayant ça. Je ne sais pas quoi faire d'autre.
Merci par avance pour vos suggestions

## Messages d'erreur

Voici une liste de messages d'erreur qui sont assez fréquents. S'il vous plaît examiner attentivement cette section si le message d'erreur que vous obtenez lors du transfert est mentionné ici. Si c'est le cas, essayez d'appliquer le correctif proposé.

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

#### Détails du message d’erreur

    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

Le message d'erreur ci-dessus sera légèrement différent d'une configuration à l'autre. Les sections dynamiques du message d'erreur (qui peuvent différer) sont surlignées en bleu dans l'exemple, par opposition à la statique (immuable) de la partie du message d'erreur qui est en noir.

#### Causes possible

Le répertoire temporaire de PHP est manquant ou n'a pas les permissions nécessaires.

#### Suggestion de correction

Vous devrez contacter l'administrateur de votre hébergeur car vous ne pouvez généralement pas changer l'emplacement du répertoire temporaire de votre site vous même (c'est une partie de la configuration de PHP).
Si la restriction open_basedir est effective sur votre site, alors le répertoire temporaire pour les fichiers téléchargés devrait être accessible.

### Impossible to move X to Y

#### Détails du message d’erreur

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

Le message d'erreur ci-dessus sera légèrement différent d'une configuration à l'autre. Les sections dynamiques du message d'erreur (qui peuvent différer) sont surlignées en bleu dans l'exemple, par opposition à la statique (immuable) de la partie du message d'erreur qui est en noir.

#### Causes possible

Le script Coppermine n'a pas les permissions de créer les vignettes ou les images intermédiaires dans le répertoire spécifié du système de fichier du serveur

#### Suggestion de correction

Appliquez les permissions au répertoire album et à l'ensemble de son contenu comme expliqué dans la section Configuration des permissions. Ce message d'erreur est le plus fréquent, parce que beaucoup d'utilisateurs du script ont fait l'impasse sur la lecture de la section concernant les droits. En premier lieu, si vous avez ce message d'erreur, vous devriez lire cette partie de la documentation très attentivement..

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

#### Détails du message d’erreur

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

#### Causes possible

- Le repertoire '`edit`' est manquant dans le répertoire album
- Le repertoire '`edit`' dans le répertoire album n'a pas les permissions rwx
- Une mauvaise mise à niveau depuis une version précédente de Coppermine

#### Suggestion de correction

- Assurez-vous d'avoir un dossier nommé '`edit`' dans votre répertoire albums.
- Assurez-vous que le dossier 'edit' ait bien un CHMOD à 777/755 (Ou plutôt: que vous avez appliqué les autorisations, comme le suggère la configuration des permissions)
- Assurez-vous d'avoir complètement fais la mise à jour vers Coppermine 1.5.x

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

#### Détails du message d’erreur

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

#### Causes possible

- Vous (en tant qu'administrateur) n'avez pas encore créé d'album.
- Vous (en tant qu'utilisateur non administrateur) n'avez pas les droits de téléchargement dans les albums publics
- Vous (en tant qu'utilisateur non administrateur) n'avez pas créé au moins un album dans votre galerie personnelle

#### Suggestion de correction

Ce message d'erreur vient d’une erreur logicielle, c'est à dire qu’il s’agit de quelque chose qui est lié à la configuration de votre Coppermine et signifie que vous n'avez pas fait quelque chose que vous auriez dû faire.

- Si vous obtenez ce message en étant identifié comme administrateur de votre galerie, vous devez alors créer au moins un album ou les fichiers peuvent être téléchargés
- Si vous obtenez ce message en étant identifié comme utilisateur non administrateur, vous devez vous assurer de bien avoir compris le concept des droits qui régissent Coppermine: dans le gestionnaire de groupes l'administrateur détermine quels utilisateurs peuvent créer leur galerie personnelles (ex: créer des albums dans leur espace personnel) ou s’ils sont autorisés à télécharger dans des albums publics crées par l'administrateur. Si l'utilisateur est autorisé à créer sa galerie personnelle et obtiens ce message, il doit créer tout d'abord au moins un album en cliquant sur "Créer / Gérer mes albums". Si l'utilisateur est seulement autorisé à télécharger dans les albums publics (qui doivent être créé par l'administrateur en premier) et qu'il obtient ce message d'erreur, l'administrateur doit d'abord autoriser le téléchargement dans les albums publics dans au moins un de ceux-ci, en utilisant la page de propriété des albums.
- Si vous obtenez ce message alors que vous n'êtes pas du tout identifié (en tant que visiteur par exemple), vous devrez revoir le concept des droits de Coppermine: Si vous voulez autoriser les visiteurs à télécharger (ce qui n'est pas recommandé à cause des abus potentiels), vous devez définir les autorisations de téléchargements dans le gestionnaire de groupes (pour le groupe visiteurs/anonymes) et vous devrez aussi modifier la page de propriétés des albums d'au moins un des albums et autoriser les téléchargements pour les visiteurs de cet album.

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

#### Détails du message d’erreur

    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

Le message d'erreur ci-dessus sera légèrement différent d'une configuration à l'autre. Les sections dynamiques du message d'erreur (qui peuvent différer) sont surlignées en bleu dans l'exemple, par opposition à la statique (immuable) de la partie du message d'erreur qui est en noir.

#### Causes possible

Cette erreur se produit en utilisant GD et en essayant de télécharger des images en haute résolution. Ce n'est pas la taille du fichier qui entre en compte, mais le nombre de pixels qui détermine la quantité de mémoire utilisée par GD. Ce n'est pas une petite erreur générée par Coppermine, mais une grosse erreur de PHP qui apparait au travers de Coppermine depuis PHP.

#### Suggestion de correction

Il n'y a pas (en tout cas en théorie) de limites dans Coppermine en ce qui concerne le poids ou les dimensions des fichiers que le script peut gérer. Il y a néanmoins une limite existante sur votre serveur: le redimensionnement d'images (pour créer les images intermédiaires et /ou les vignettes) consomme de la mémoire et des ressources processeur. Pour éviter le crash du serveur, l'administrateur a restreint le volume de mémoire que le script est autorisé à utiliser. Le message d'erreur mentionné plus haut indique que les limites imposées par l'administrateur du serveur sont atteintes, c'est à dire que l'image que le script essaye de traiter consomme trop de mémoire.

- Alternative 1 (idéale):
  Augmentez la limite de l'allocation de mémoire dans le php.ini comme expliqué dans Utilisation de la mémoire pendant le redimensionnement. Si vous ne pouvez pas modifier le php.ini, vous devriez lire les alternatives 2 et 3.
- Alternative 2 (sensible):
  Redimensionnez vos images avant de les télécharger si vous n'avez pas besoin d'images en haute résolution. Cela vous fera gagner de la bande passante en téléchargement et du temps.
- Alternative 3 (contournement):
  Vous devrez télécharger l’un des nombreux programmes gratuits qui redimensionne les images. Puis redimensionnez les images à une résolution plus petite (comme 800 x 600) et sauvegardez-les dans un autre dossier en gardant le même nom de fichier.
  Téléchargez les images redimensionnées dans Coppermine. Puis utilisez votre client FTP et remplacez les images avec celles de plus haute résolution.

### Messages d'erreur: Exec() has been disabled

#### Détails du message d’erreur

    Exec() has been disabled

#### Causes possible

php.ini permet à l'administrateur du serveur de désactiver certaines fonctions. Habituellement, c’est le cas si votre serveur fonctionne en safe_mode. Ce n'est pas une erreur logicielle déclenchée par Coppermine, mais une erreur grave de PHP visible à travers Coppermine utilisant PHP.

#### Suggestion de correction

Si l'administrateur du serveur a désactivé exec() vous ne pourrez pas utiliser ImageMagik.
Vous pouvez essayer de remplacer exec() par passthru() dans l'ensemble du code de Coppermine (non recommandé) si cette fonction n'a pas aussi été désactivée. Sinon, vous ne pourrez pas utiliser ImageMagik et devrez utiliser GD. Changez la Méthode de redimensionnement des images dans la configuration.

### Messages d'erreur: Not a GD extension

#### Détails du message d’erreur

    Not a GD extension

#### Causes possible

Le(s) fichier(s) que vous essayez de télécharger ne peuvent pas être gérés pas la librairie GD

#### Suggestion de correction

GD ne peut gérer que les fichiers JPEG, PNG et GIF, alors qu'ImageMagick supporte en plus BMP, PSD et certains autre types de fichiers (moins communs). Toutefois, ces fichiers ne sont pas adaptés pour une utilisation sur l'Internet. Vous trouverez des détails dans la section type d'images autorisés dans la page de la documentation consacrée à la configuration.

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

#### Détails du message d’erreur

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

Le message d'erreur ci-dessus sera légèrement différent d'une configuration à l'autre. Les sections dynamiques du message d'erreur (qui peuvent différer) sont surlignées en bleu dans l'exemple, par opposition à la statique (immuable) de la partie du message d'erreur qui est en noir.

#### Causes possible

Vous n'avez pas défini le bon chemin pour ImageMagick, ou ne disposez pas du tout d'ImageMagick. La première phrase du message d'erreur est une erreur logicielle déclenchée par Coppermine, mais la deuxième phrase est une grave erreur de PHP qui est visible à travers le code PHP de Coppermine, avec peu importance étant la valeur la dernière `phrase de retour 127`.

#### Suggestion de correction

Si vous êtes sur d'avoir ImageMagick sur votre serveur, regardez le chemin pour ImageMagick. Si ce chemin semble correct, assurez-vous que le script Coppermine a les droits de lecture et d'exécution de l'exécutable convert dans le répertoire d'ImageMagic. Si vous n'êtes pas sûr, basculez la Méthode de redimensionnent d'image de "ImageMagick" à "GD2", puis réessayez de télécharger.

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

#### Détails du message d’erreur

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

#### Causes possible

Votre serveur ne supporte pas la librairie graphique GD.

#### Suggestion de correction

Vérifiez de bien remplir toutes les conditions minimales requises pour faire tourner Coppermine. Si GD n'est pas disponibles sur votre serveur, vous devrez utiliser ImageMagick. Demandez à votre hébergeur si ImageMagick est disponible sur votre serveur.

### Messages d'erreur: No file was uploaded !

#### Détails du message d’erreur

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

#### Causes possible

Les téléchargements de fichiers sont désactivés dans le php.ini ou il y a un problème de droit avec le mécanisme de téléchargement de votre serveur.

#### Suggestion de correction

Il peut y avoir plusieurs raisons pour ce message d'erreur. Le fichier que vous essayez de télécharger n'a pas "atteint" le dossier du serveur ou il était sensé aller. Vérifiez s’il y a un problème avec le téléchargement HTTP sur votre serveur – cette fonction a peut être été désactivée ou mal configurée. Dans le phpinfo(), vérifiez que "file_uploads" est sur ON, "upload_max_filesize" a une valeur du genre 2M et "upload_tmp_dir" est un répertoire valide! Assurez-vous de bien vérifier une fois de plus les droits pour vos fichiers/répertoires.
Si ce n'est pas vous qui administrez le serveur, vous devrez demander de l'aide à votre hébergeur. Voici ce que vous devez vérifier:

- Fichier "trop gros"
  Si vous rencontrez ce message d'erreur pour la première fois, assurez vous que le fichier que vous essayez de télécharger n'est pas trop gros en terme de taille de fichier et de dimensions. Testez avec un fichier plus petit qui est réputé fonctionné. Vous pouvez utiliser sans problème une image téléchargée de la galerie de démonstration de Coppermine pour ce test.
- "file_uploads" activé
  Allez à votre page phpinfo() (accessible depuis le menu administrateur), cherchez`file_uploads` et assurez-vous que la valeur est bien "on". Si vous êtes sur un serveur mutualisé, seul l'administrateur peut modifier cette valeur.
- "upload_tmp_dir" doit être défini
  Sur la page phpinfo, assurez-vous que `upload_tmp_dir` est défini. Si vous êtes sur un serveur mutualisé, seul votre hébergeur peut le faire pour vous. Le script (c'est à dire l'utilisateur qui utilise le serveur) doit avoir les droits en écriture dans ce fichier.

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

#### Détails du message d’erreur

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

Le message d'erreur ci-dessus sera légèrement différent d'une configuration à l'autre. Les sections dynamiques du message d'erreur (qui peuvent différer) sont surlignées en bleu dans l'exemple, par opposition à la statique (immuable) de la partie du message d'erreur qui est en noir.

#### Causes possible

Les droits du système de fichiers ne sont pas corrects. En faite il s’agit du niveau des autorisations en haut de cette page...

#### Suggestion de correction

Vérifiez les droits des fichiers/répertoires. Si ça ne vous aide pas, demandez à votre hébergeur.

## Restrictions côté serveur

Toutes les méthodes de téléchargement, mais plus particulièrement les téléchargements par HTTP sont limités par des restrictions se trouvant dans la configuration de PHP.

### Le fichier de configuration de PHP php.ini

Comprenez bien que les paramètres dans le php.ini ne peuvent être modifiés que si vous êtes l'administrateur du serveur (si vous utilisez votre propre serveur). Si vous êtes hébergés, vous devrez demander à votre hébergeur s’il veut bien changer ces paramètres pour vous, ce qui revient en général à vous autoriser à utiliser plus de ressources sur le serveur. Généralement votre hébergeur n'acceptera pas cela pour des raisons économiques évidentes: accepter que vous utilisez plus de ressources l'obligera à héberger moins de sites sur son serveur mutualisé.
Merci de ne pas poser de questions concernant les réglages supposés du serveur, ni comment les changer, sur le forum de Coppermine - comme expliqué ci-dessus: vous n'êtes généralement pas en mesure de les changer si vous êtes hébergés.
Si vous êtes auto-hébergé (ce que nous ne pouvons pas recommander car faire tourner un serveur demande une attention constante pour le fonctionnement et la maintenance de celui-ci ainsi qu'une grande expérience et de bonnes connaissances), n'essayez pas de poser des questions idiotes comme "Ou est ce que je peux trouver mon fichier php.ini" - Si vous ne connaissez pas la réponse à cette question, vous entrez dans la catégorie "auto-hébergement non recommandé à cause du manque de connaissances" et serez ignoré sur le forum de Coppermine.

### 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 (220) pour avoir un résultat en MB.

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

Nom de la résolution de l'écran | Largeur |  | Hauteur | Utilisation de mémoire | Format
--- | --- | --- | --- | --- | ---
QVGA | 320 | x | 240 | 0.2 MB | 4 : 3
VGA | 640 | x | 480 | 0.9 MB | 4 : 3
SVGA | 800 | x | 600 | 1.4 MB | 4 : 3
XGA | 1024 | x | 768 | 2.3 MB | 4 : 3
WXGA | 1280 | x | 800 | 2.9 MB | 16 : 10
SXGA | 1280 | x | 1024 | 3.8 MB | 4 : 3
SXGA+ | 1400 | x | 1050 | 4.2 MB | 4 : 3
UXGA | 1600 | x | 1200 | 5.5 MB | 4 : 3
WUXGA | 1920 | x | 1200 | 6.5 MB | 16 : 10
QXGA | 2048 | x | 1536 | 9.0 MB | 4 : 3
WQXGA | 2560 | x | 1600 | 11.7 MB | 16 : 10
QUXGA | 3200 | x | 2400 | 22.0 MB | 4 : 3
QXGA | 4096 | x | 3072 | 36.0 MB | 4 : 3
HUXGA | 6400 | x | 4800 | 87.9 MB | 4 : 3
UHDTV | 7680 | x | 4320 | 94.9 MB | 16 : 9
WHUXGA | 7680 | x | 4800 | 105.5 MB | 16 : 10

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.

Si vous n'êtes pas en mesure de modifier le fichier php.ini vous même, vous pouvez toujours demander à l'administrateur de votre serveur de le faire pour vous. Toutefois, la plupart des administrateurs de serveurs (en particulier sur les hébergements mutualisés), sont réticents à le faire, du fait que ces modifications s'appliqueront à tous les utilisateurs du serveur. Une limite de mémoire plus grande réduit le nombre de personnes pouvant être hébergées sur le serveur afin de maintenir la stabilité de celui-ci. Cela réduit aussi les profits etc...
Ne posez pas de questions sur la manière de configurer le serveur sur le forum de Coppermine; ce n'est pas dans les attributions du forum de Coppermine d'expliquer les paramétrages des serveurs. Généralement (si vous êtes hébergés sur un serveur mutualisé, ce qui est le cas de la grande majorité des utilisateurs de Coppermine), vous ne pourrez de toute manière pas changer les paramètres de configuration du serveur. Seule la personne qui administre le serveur (l'administrateur du serveur) peut changer les paramètres de configuration du serveur.
C'est la raison pour laquelle il vaut mieux demander de l'aide à votre hébergeur si vous avez des problèmes avec les limitations en ressources ou avec toute question relative au paramétrage du serveur. Si vous êtes auto-hébergés (ce que l'équipe de développement de Coppermine de recommande pas), vous devrez chercher dans la documentation de votre serveur.