Il existe trois types d'erreurs que vous pouvez rencontrer:

• Erreurs légères
• Erreurs graves
• Erreurs non traitées

Erreurs légères

Les erreurs légères se produisent généralement si vous (ou l'utilisateur final) faites une erreur de manipulation. Coppermine affichera un message d'erreur, mais vous pouvez continuer à naviguer dans la galerie. Les erreurs légères sont entièrement internationalisées (c'est à dire qu'elles seront affichées dans la langue que l'utilisateur a choisi), cela implique que les programmeurs de Coppermine s'attendent (plus ou moins) à ce qu’une telle erreur puisse se produire dans certaines circonstances.

Si vous obtenez une erreur légère et que vous ne savez pas quoi faire (peut-être parce que le message d'erreur ne signifie pas grand chose pour vous), lisez la section correspondante de cette documentation et recherchez sur le forum d'aide, car il est très probable que quelqu'un d'autre à déjà eu le même problème que vous.

Dans certaines sections de la documentation il y a des trucs de dépannage pour la question qui vous préoccupe, que vous devez lire en premier si vous obtenez un message d'erreur, par exemple lorsque vous avez des problèmes avec les téléchargements ou avec une passerelle (bridge).

Erreurs graves

Les erreurs graves sont des messages qui ne vont pas disparaître, généralement parce que quelque chose est corrompu et doit être réparé. C'est généralement le cas si quelque chose ne va pas avec la base de données. Par conséquent, vous pourriez voir le redoutable message "Erreur fatale" qui ne veut généralement pas dire grand-chose pour les utilisateurs inexpérimentés.

Si vous obtenez une erreur grave, vous devez agir immédiatement et réparer le plus vite possible la cause de l'erreur.

Une erreur grave indique généralement que quelque chose ne se passe pas correctement et que les programmeurs de Coppermine ne pouvaient pas prévoir, c'est pourquoi seul un message d'erreur générique est affiché. Lisez la suite pour savoir ce que vous devez faire.

Erreurs non traitées

Les erreurs non traitées sont celles qui sont habituellement les plus difficiles à résoudre, car Coppermine "plante" en plein fonctionnement, sans message d'erreur significatif qui pourrait indiquer aux utilisateurs ce qui ne va pas. C'est généralement le cas si vous obtenez une page blanche ou tout simplement une erreur de d'affichage (thèmes etc...).

Activation du mode débogage dans configuration

Afin d'activer le mode de débogage, aller dans la configuration de Coppermine et dans la section "Paramètres de maintenance", "activer le mode débogage". Laissez l'option "Afficher les avertissements dans le mode débogage" désactivée.

Dans certains cas, vous pourriez ne pas être en mesure d'accéder à la page de configuration suffisamment longtemps pour permettre d’activer le mode débogage, comme suggéré dans cette section, de sorte que vous devrez activer manuellement le mode débogage. Reportez-vous à la section suivante pour savoir comment faire.

Activer manuellement le mode débogage

Si vous avez besoin d’activer le mode de débogage, mais que vous ne pouvez plus accéder à l'écran de configuration (peut-être en raison de l'erreur fatale qui empêche l’affichage de la page de configuration ou peut-être parce que votre identifiant d’administrateur ne fonctionne pas comme prévu non plus), vous pouvez activer manuellement le mode de débogage.

Pour ce faire, vous aurez besoin d'un outil tiers comme phpMyAdmin pour manipuler directement votre base de données. De nombreux hébergeurs fournissent phpMyAdmin ou un outil similaire dans leur panneau de gestion d’hébergement. Vous pouvez y jeter un œil, ou demandez à votre hébergeur s’il peut vous le fournir gratuitement. S'ils ne le font pas, vous devez installer cette application, car elle est utile non seulement pour le dépannage de Coppermine, mais également pour l’administration de toutes de base de données. Sachez cependant que cet outil est très puissant et manipule directement la base de données et peut donc supprimer ou endommager votre base de données s'il n'est pas utilisé correctement. De plus, phpMyAdmin peut être utilisé pour sauvegarder votre base de données. S'il vous plaît, référez-vous à la documentation de phpMyAdmin pour toutes les questions liées à l'installation, la configuration et l'utilisation de phpMyAdmin - le forum d'aide de Coppermine n'est certainement pas le bon endroit pour poser des questions sur la façon de configurer phpMyAdmin.

Ceci étant dit, supposons que vous ayez déjà phpMyAdmin ou que vous ayez réussi à l'installer correctement. Pour activer le mode de débogage manuellement, procédez comme suit:

• Allez depuis votre navigateur vers le dossier ou réside phpMyAdmin sur votre serveur (ex. http://exemple.com/phpMyAdmin/)
• Selon les mécanismes de sécurité que vous avez mis en place pendant la configuration initiale de phpMyAdmin, vous pouvez avoir à vous authentifiez pour pouvoir y accéder Cette authentification est très importante pour s'assurer qu'aucun accès non autorisé à phpMyAdmin n’à lieu, comme indiqué précédemment, un utilisateur malveillant pourrait ruiner l’ensemble de votre site s’il a obtenu un accès à un outil de manipulation de bases de données comme phpMyAdmin.
• Si vous avez plusieurs bases de données disponibles, choisissez celle qui concerne Coppermine en haut de la colonne de gauche. Si vous avez une seule base de données, toutes les tables qui se trouvent dans votre base de données seront instantanément visible dans le cadre de gauche
• Cliquez dans le cadre de gauche sur la table de la base de données qui contient la configuration de Coppermine. Le nom de la table est "cpg15x_config" ou similaire (en fonction du préfixe des tables que vous avez choisi lors de l'installation).
• Dans le cadre principal de phpMyAdmin (le plus à droite), cliquez sur le bouton "Afficher" qui se trouve tout en haut.
• Les entrées individuelles de la table doivent être affichées. Faites défiler vers le bas pour voir la ligne "debug_mode". Comme phpMyAdmin n'affiche habituellement seulement qu'un nombre donné de lignes par page, vous pouvez continuer à la deuxième ou troisième page des résultats, en utilisant la barre de navigation en haut ou en bas de l'écran.
• Une fois que vous avez trouvé la ligne intitulée "debug_mode", ", cliquez dans cette ligne sur l'icône modifier (l'icône crayon).
• Sur l'écran d'édition, changez la valeur de "0" (qui signifie "Ne pas afficher le mode de débogage") à "1" (qui signifie "affichage pour tout le monde du mode de débogage") et puis enregistrez vos modifications en cliquant sur le bouton "Exécuter".
• Vous pouvez maintenant quitter phpMyAdmin et revenir à votre écran de Coppermine – Le mode de débogage doit être activé.
• Avec le mode débogage autorisé, reproduisez le message d'erreur: cette fois, vous devriez non seulement obtenir le message générique "Erreur fatale" mais également une explication de ce qui à réellement mal tourné.

Maintenant, vous pouvez utiliser le message d'erreur réelle qui indique quel est le problème à résoudre - corrigez l'erreur si vous le pouvez. Si vous ne pouvez pas réparer vous-même, rechercher l'appui du forum de Coppermine pour un conseil sur le message d'erreur (la partie générique, et non la partie spécifique qui s'applique uniquement à votre base de données / site). Il est très probable que quelqu'un d'autre ayant eu les mêmes questions que vous ait l'expérience pour vous répondre - tenez compte des conseils donnés sur le fil qui décrit votre message d'erreur.

Une fois que vous avez terminé et si le message d'erreur à disparu, ne pas oublier de désactiver le mode de débogage avant de vous déconnecter. Si votre galerie est à nouveau pleinement opérationnelle (il faut, avoir corrigé l'erreur), vous pouvez aller dans la configuration de Coppermine et décocher "Activer le mode de débogage". Si vous ne pouvez pas accéder à la configuration de Coppermine (peut-être parce que vous avez oublié les informations de votre compte administrateur), utilisez la méthode décrite ci-dessus pour activer le mode de débogage afin de l’arrêter manuellement (en utilisant phpMyAdmin): parcourez les tables de configuration de Coppermine à la recherche de "debug_mode", modifier cette entrée en la changeant "1" à "0".

Désactiver le mode de débogage

La sortie du mode de débogage n'est pas un message d'erreur. L'affichage des éléments de débogage sans avoir de message d'erreur ne signifie pas qu'il y a un problème: par défaut, le mode de débogage est désactivé. Si vous n'avez pas de problèmes particuliers avec votre galerie et qu'il n'y a pas d'erreur à corriger, désactivez le mode de débogage depuis la configuration ou manuellement, simplement de la même manière que vous l'aviez activé avant.

Messages d'erreur de base de données

Message d'erreur	Cause possible	Corrections suggérées
Can't create/write to file '/tmp/#sql_45d5_0.MYI'	MySQL ne peut pas créer de fichier temporaire pour l'ensemble des opérations dans le répertoire temporaire défini.	Changez la variable tmpdir pour qu'elle pointe vers un répertoire inscriptible. Cela demande de changer la ligne tmpdir dans le fichier my.cnf, généralement dans la section [mysqld] (tmpdir = /writable/dir, ou /writable/dir est un répertoire dans lequel vous pouvez écrire). Demandez à votre hébergeur de faire ces modifications, dont seul l'administrateur du serveur ou la base de données MySQL réside peut effectuer cette opération
Can't open file: 'votrepréfixe_nomdelatable.MYI'	Votre table de base de données est endommagée.	Cela ne vient pas de Coppermine, mais de mySQL. Cela peut n'affecter qu'une seule table utilisée par Coppermine dans votre base de données. Utilisez le gestionnaire de contrôle de configuration de votre site internet pour réparer la table, ou utiliser phpMyAdmin pour exécuter cette requête SQL: Réparer la table votrepréfixe_nomdelatable (Remplacez votrepréfixe_nomdelatable par le nom de votre table, par exemple cpg145_pictures) Si vous ne comprenez ce qu'il faut faire, demandez à votre hébergeur de faire les changements ci-dessus.
Got error 28 from storage engine	Pas d'espace restant sur le dispositif, à savoir le disque dur sur lequel votre base de données réside est plein.	Cela ne vient pas de Coppermine, mais de MySQL. Contactez votre hébergeur ou la personne qui est en charge du fonctionnement du serveur ou se trouve votre base de données. Transmettez à cette personne le message d'erreur que vous avez - il/elle devrait savoir quoi faire. De manière générale, vous aurez à dégager de l'espace ou à nettoyer votre base de données. Merci de noter que vous ne pouvez pas faire cela vous même si vous êtes hébergés - seul le gestionnaire du serveur peut faire cela.
Table 'votrepréfixe_nomdelatable' is marked as crashed and should be repaired	Votre table de base de données est endommagée.	Cela ne vient pas de Coppermine, mais de MySQL. Cela peut n'affecter qu'une seule table utilisée par Coppermine dans votre base de données. Utilisez le gestionnaire de contrôle de configuration de votre site internet pour réparer la table, ou utilisez phpMyAdmin pour exécuter la requête SQL: Réparer la table votrepréfixe_nomdelatable (Remplacez votrepréfixe_nomdelatable par le nom de votre table, par exemple cpg145_pictures) Si vous ne comprenez ce qu'il faut faire, demandez à votre hébergeur de faire les changements ci-dessus. Si cela arrive fréquemment, il doit y avoir quelque chose d'anormal sur votre serveur - demandez à votre hébergeur de l'aide.

Pour obtenir une liste complète des messages d'erreur MySQL qui seraient visibles en utilisant Coppermine, se référer à MySQL 5.1 Reference Manual → B Errors, Error Codes, and Common Problems → B.3 Server Error Codes and Messages.

Erreurs commune de PHP

Il y a beaucoup de personnes (particulièrement les débutants en PHP) qui postent des questions du genre J'ai l'erreur "Parse error: parse error in XXX" et qui ne savent pas quoi faire avec. C'est la raison pour laquelle nous avons traduit la liste des erreurs communes et la solution sur la manière de les corriger) depuis l'article original en allemand du site Dr. Web

Message d'erreur	Cause possible	Corrections suggérées
Parse error: parse error in C:\Apache\htdocs\read.php on line 8	Ce message d'erreur fait référence à une erreur dans la syntaxe PHP.	Vous avez certainement oublié de terminer la ligne avec ; ou vous avez trop de crochets ouverts ou fermés ({).
Fatal error: Call to unsupported/undefined function ... in C:\Apache\htdocs\read.php on line 8	Cette erreur signifie que la fonction de votre script n'est pas définie dans votre version de PHP et ses modules, ou vous utilisez une fonction définie par l'utilisateur qui n'est pas déclarée dans votre fonction.	Cela est généralement dû au fait que vous avez oublié d'inclure la définition de la fonction.
Warning: Wrong parameter ... for ... in C:\Apache\htdocs\read.php on line 8	Vous avez passé trop (ou les mauvais) paramètres à la fonction.	Si il s'agit d'une fonction php incluse, vérifiez le manuel pour vérifier. S'il s'agit d'une fonction définie par l'utilisateur, vérifiez votre code.
Warning: Cannot add header information - header was already sent ... in C:\Apache\htdocs\read.php on line 4	Vous avez déjà eu une sortie texte (par exemple une déclaration doctype ou <html>) et appelez de nouveau la fonction header().	C'est généralement le cas en utilisant des truc relatifs aux cookies. Rappelez vou, vous ne pouvez pas utiliser header() deux fois!
Parse error: parser stack overflow in C:\Apache\htdocs\read.php	PHP est à court de mémoire.	Cela arrive généralement, si vous avez créé une boucle sans fin, particulièrement en utilisant les procédés d'inclusion.
Warning: fopen("file.txt","r+") - No such file or directory	Le fichier ou le répertoire demandé n'existe pas.	Vérifiez l'orthographe (c'est l'exactitude qui compte ici).
SAFE MODE Restriction in effect. The script whose uid is XXX is not allowed to access...	Le Safemode est activé. Certaines fonctions du système de téléchargement ne peuvent pas être utilisées.	Généralement, votre hébergeur à activé le safe mode (souvent mal configuré). Essayez de passer le silly_safe_mode sur on.
De drôles de caractères comme  apparaissent sur certaines ou sur toutes les pages	Une Marque d'ordre des octets (Byte Order Mark) (BOM) s'est glissée dans un de vos fichier Coppermine	Cela arrive généralement si vous modifiez un fichier encodé en Unicode (ce que sont les fichiers du noyau de Coppermine) avec un éditeur de texte qui n'est pas fait pour gérer les fichiers Unicodes. Le plus connu est notepad.exe (qui est livré avec Microsoft Windows). Le BOM devrait apparaitre sur la page que vous avez modifée manuellement, mais il peut aussi s'afficher sur des pages que vous ignorez. Annulez votre modification si vous le pouvez et utilisez un éditeur qui peut gérer l'encodage utf-8 (pour une liste d'éditeurs, regardez la section Outils recommandés par les développeurs → Editeurs de texte). Si vous ne vous rappelez plus quel fichier vous avez modifié, cherchez le BOM dans tous vos fichiers. L'application d'Emurasoft Replace in files est un bon outil pour faire ça sur une machine tournant sous Windows.

Messages d'erreurs liés aux téléchargements

Il y a un ensemble de sous-sections consacrées aux messages d'erreurs liés aux téléchargements dans la page dépannage des téléchargements.

Codes réponses des serveurs

La plupart des sites internet sont pilotés par des serveurs Apache, c'est pourquoi le terme "Codes réponses des serveurs Apache" est tout aussi correct. La plupart des surfeurs du Web sont familiers avec les fameux messages 404 not found et 500 internal Erreur serveur. Dans la majorité des cas, ces erreurs ne sont pas imputables directement à Coppermine. Ci dessous vous trouverez une liste des codes réponses renvoyés par les serveurs Apache ainsi que leur explication. Notez que un code réponse ne signifie pas en lui même que quelque chose se passe mal - la plupart des codes sont silencieux, c'est à dire que l'utilisateur final ne les verra pas, cela faisant partie des liens entre le serveur et le client. La liste ci-dessous est incomplète et ne montre que les messages d'erreur.

Notez que cette section de la documentation n'est pas supportée par le forum d'aide de Coppermine - si vous voulez plus de détails sur les codes réponses des serveurs, lisez l'excellente documentation apache ou l'article sur Wikipedia: Liste des codes HTTP.

Code	Categorie	Explication	Correction proposée
400 Bad Request	Erreur de requête client	Il y a une erreur de syntaxe dans la requête et elle est rejetée.	Cela ne devrait guère se produite, puisque le message d'erreur signifie qu'il y a quelque chose qui ne va pas dans la communication entre le client (navigateur) et le serveur. Réessayez. Si ça ne change rien, essayez d'utiliser un autre navigateur.
401 Authorization Required	Erreur de requête client	L'entête de la requête ne contient pas les codes d'authentifications nécessaires, et l'accès est refusé pour le client. Ce message d'erreur est similaire à 403 Forbidden, mais est plus particulièrement destiné aux cas ou l'identification est possible, mais n'a pas fonctionnée ou n'a pas été faite.	n/a
403 Forbidden	Erreur de requête client	La requête est correcte, mais le serveur refuse d'y réponde, par exemple, le client n'est pas autorisé à voir certains fichiers. Cette erreur est aussi renvoyée lorsque le serveur ne veut plus de visiteurs.	Cette erreur est souvent une indication que les droits au niveau du système de fichiers n'ont pas été correctement appliqués. Une autre raison possible peut être une restriction imposée par un fichier .htaccess. Dans de rares cas, cette erreur est causée Dans de rares cas, cette erreur peut être provoquée par les questions de propriété (CHOWN), qui peut généralement être résolue par l'administrateur du serveur, par exemple l'hébergeur de votre compte d'hébergement mutualisé.
404 Not Found	Erreur de requête client	Le fichier demandé n'a pas pu être trouvé (mais peut à nouveau être disponible par la suite). Peut être parce qu'il a été effacé, ou qu'il n'a jamais existé auparavant. Souvent causé par une mauvaise orthographe de l'URL. N'oubliez pas que les majuscules ont une importance pour la majorité des systèmes d'exploitation des serveurs.	Vérifiez si le fichier recherché existe actuellement sur le serveur.
405 Method Not Allowed	Erreur de requête client	La méthode que vous utilisez pour accéder au fichier n'est pas autorisée. Exemples: utilisation de GET dans un formulaire qui demande que les données soient envoyées par POST, ou utilisation de PUT avec une ressource en lecture seule.	Cette erreur ne devrait pas se produire avec une version stable de Coppermine, car tous les formulaires existants ont été testés minutieusement. Si elle se produit quand même et que vous pensez qu'elle vient du code source de Coppermine, merci de faire un rapport sur le forum d'aide de Coppermine.
406 Not Acceptable (encoding)	Erreur de requête client	La ressource demandée est uniquement capable de générer un contenu non acceptable au regard de l'entête Accept envoyé par la requête, ex. Le fichier demandé existe mais ne peut pas être utilisé parce que le système client ne reconnait pas le format de fichier utilisé.	Cette erreur ne devrait pas se produire avec une version stable de Coppermine.
408 Request Timed Out	Erreur de requête client	Le serveur met trop de temps pour la requête. [2] Conformément aux spécifications HTTP W3 HTTP; Le client ne peut pas produire de requête dans le temps d'attente du serveur. Le client doit répéter la requête sans modifications un peu plus tard." En d'autres mots, le serveur mais plus longtemps que ce qui lui est autorisé pour interprêter la requête.	C'est souvent causé par un gros trafic. Essayez encore plus tard. Si ça arrive fréquemment, réfléchissez à augmenter votre contrat d'hébergement ou à changer pour un meilleur hébergeur.
409 Conflict	Erreur de requête client	Indique que la requête n'a pu être exécutée à cause d'un conflit dans la requête. Cela peut être un indicateur de trop de requêtes similaires pour un même fichier.	n/a
410 Gone	Erreur de requête client	Le fichier devrait être à cet endroit, mais ne l'est plus. Ce code réponse indique que la ressource demandée n'est plus disponible et ne le sera plus par la suite. Cela arrive lorsque la ressource a été effacée intentionnellement; Toutefois, il n'est pas obligatoire que ce code soit renvoyé - un code 404 Not Found peut l'être à la place. Lors de la réception d'un code 410, le client ne doit pas vouloir accéder à la ressource par la suite. Les clients comme les moteurs de recherche doivent enlever la ressource de leurs index.	n/a
411 Length Required	Erreur de requête client	La requête ne contient pas l'entête Content-Length.	n/a
412 Precondition Failed	Erreur de requête client	Un paramétrage précis est demandé pour pouvoir accéder à ce fichier, mais le client ne l'a pas configuré.	n/a
413 Request Entity Too Long	Erreur de requête client	Le fichier demandé est trop gros à gérer, c'est à dire que la requête est plus grande que ce que le serveur peut (ou veut) exécuter.	Si cela arrive avec une page Coppermine, vérifiez les réglages de votre serveur. Si vous n'êtes pas l'administrateur du serveur (si vous êtes hébergés) demandez de l'aide à votre hébergeur.
414 Request URI Too Long	Erreur de requête client	L' URI donnée est trop longue pour être interprétée par le serveur.
415 Unsupported Media Type	Erreur de requête client	Le type de fichier de la requête n'est pas pris en compte. Exemple: le client télécharge une image comme image/svg+xml, mais le serveur demande l'usage d'un autre type de fichier.	Si cela arrive avec une page Coppermine, vérifiez les réglages de votre serveur. Si vous n'êtes pas l'administrateur du serveur (si vous êtes hébergés) demandez de l'aide à votre hébergeur.
450 Blocked by Windows Parental Controls	Erreur de requête client	Extension Microsoft. Cette erreur arrive lorsque le contrôle parental de Windows est activé et bloque l'accès à la page demandée.	n/a
500 Internal Erreur serveur	Erreur serveur	Réponse pénible qui est généralement causée par un problème de code lorsqu'un script CGI est lancé, ou si le code dépasse une limitation imposée par la configuration du serveur.	Si vous le pouvez, vous devrez vérifier les enregistrements des erreurs du serveur (log's), pas ceux de Coppermine, pour plus de détails sur ce qui ne va pas. Généralement, si vous n'êtes hébergés (si vous n'êtes pas votre propre administrateur), vous n'avez pas accès à ces données, vous devriez plutôt voir ça avec votre hébergeur. Généralement ce message survient avec une page Coppermine si vous dépassez une limitation côté serveur, au niveau de la consommation de mémoire. Dans 90% des cas, cela arrive lorsque vous essayez de traiter une image qui est trop grande en terme de résolution.
501 Not Implemented	Erreur serveur	La requête ne peut pas être exécutée par le serveur.	Si cela arrive avec une page Coppermine, vérifier les enregistrements des erreurs du serveur. Si vous n'êtes hébergés (si vous n'êtes pas votre propre administrateur), vous n'avez pas accès à ces données, vous devriez plutôt voir ça avec votre hébergeur.
503 Service Unavailable	Erreur serveur	Le service ou le fichier de la requête n'est actuellement pas disponible (l'ensemble du serveur n'est pas accessible à cause d'une surcharge ou d'une maintenance). Généralement ce n'est que temporaire.	Demandez de l'aide à votre hébergeur si le message d'erreur s'affiche en permanence.
509 Bandwidth Limit Exceeded	Erreur serveur	Ce code d'état, même si il est utilisé par beaucoup de serveurs n'est pas expliqué dans les commentaires concernant les limites d'extensions Apache.	Demandez à votre hébergeur pour avoir de l'aide !