Chaque logiciel a des bogues. Nous tâchons de sortir la meilleure version possible de DokuWiki à chaque fois, mais des erreurs se produisent. Cette page est là pour vous aider à signaler les bogues que vous pourriez rencontrer.

Avant de signaler quelque chose, essayez de rechercher si le problème que vous rencontrez est vraiment un bogue. Peut-être s'agit-il d'un comportement intentionnel pour une raison quelconque ? Peut-être y a-t-il un un paramètre de configuration que vous pourriez régler ?

Vous devriez aussi rechercher sur le forum si d'autres personnes ont rencontré le même problème. Peut-être existe-il déjà une solution.

Cependant, si vous avez encore des doutes, il suffit d'ouvrir un rapport de bogue. Nous pouvons toujours le fermer s'il s'avère qu'il ne s'agit pas d'un bogue.

Tous les bogues DokuWiki doivent être signalés dans notre outil de suivi des bogues sur GitHub, situé à l'adresse https://github.com/dokuwiki/dokuwiki/issues. Pour les bogues des thèmes et greffons, reportez vous au suivi de bogues propre à l'extension — vous trouverez un lien vers celui-ci sur la page de documentation de celle-ci.

Utilisez la recherche pour vérifier si votre problème a déjà été signalé. Veillez également à rechercher les bogues fermés — le bogue peut avoir été corrigé dès le début du développement.

Si le bogue a déjà été signalé, vérifiez si vous pouvez fournir des informations supplémentaires pour aider à le corriger. Voir ci-dessous comment faire.

Comme mentionné ci-dessus, les bogues DokuWiki doivent être signalés sur https://github.com/dokuwiki/dokuwiki/issues. Vous aurez besoin d'un compte GitHub gratuit pour ce faire. Veuillez ne pas signaler les bogues ailleurs (IRC, Twitter, Forum). Le suivi de bogue GitHub est la seule façon officielle de signaler un bogue. Encore une fois : rapportez les bogues de l'extension dans le suivi de bogue de l'extension elle-même.

Lorsque vous signalez un bogue, vous devez essayer d'inclure autant d'informations que possible qui aident les développeurs à identifier le problème.

Ceci peut inclure:

• la version de DokuWiki
• Le système d'exploitation (OS) du serveur et du client
• Le serveur web utilisé
• La version PHP utilisée
• Les navigateurs utilisés (essayez-en plusieurs)
• Tout ce qui est spécial dans votre configuration (extensions, backends d'authentification, configuration réseau inhabituelle, etc.)
• Les étapes exactes pour reproduire le problème
• Captures d'écran
• Qu'avez-vous essayé de faire pour résoudre le problème et quels en ont été les résultats exacts ?

Il est particulièrement important de recueillir des messages d'erreur exacts ! Voyez si vous pouvez trouver les journaux d'erreurs du serveur web et de la console JavaScript (voir ci-dessous).

Veuillez également lire Comment signaler efficacement les bogues pour plus de conseils sur la façon de soumettre des rapports de bogues utiles.

Comme mentionné ci-dessus, les développeurs de DokuWiki ont besoin de messages d'erreur détaillés pour déboguer un problème. Parfois, ces messages sont imprimés directement à l'écran, mais parfois ils ne le sont pas. Dans ces cas, vous pouvez vérifier les options suivantes :

Chaque fois que quelque chose tourne fatalement mal, PHP arrête simplement de traiter votre demande. Cela se traduit généralement par une page blanche ou partielle. Parfois, les erreurs sont moins graves, mais il manque toujours des éléments.

Dans tous ces cas, PHP enregistre un message d'erreur dans un fichier journal. L'emplacement exact de ce fichier journal diffère d'un système à l'autre. Les erreurs peuvent être consignées dans le journal des erreurs du serveur web, dans le journal global du système ou dans un journal des erreurs PHP spécifique. Ceci est configuré dans la directive error_log de php.ini.

Les emplacements habituels sont :

• /var/log/apache2/error.log
• /var/log/apache/error.log
• /var/log/httpd/error.log
• /var/log/syslog

Si vous êtes sur un serveur hébergé, il est préférable de demander à votre fournisseur où se trouve ce journal. Si vous n'avez pas accès au fichier php.ini et que vous ne pouvez pas trouver le fichier journal, vous pouvez également essayer d'ajouter ce qui suit au fichier htaccess dans votre dossier racine DokuWiki :

php_value display_errors 1
php_value display_startup_errors 1

Cela peut envoyer le message d'erreur au navigateur.

Parfois, les choses se passent mal du côté client (dans votre navigateur). Pour le savoir, vous devez accéder à la console JavaScript de votre navigateur. Pour ce faire, utilisez les raccourcis clavier suivants :

Si vous voyez des erreurs (généralement indiquées en rouge) dans la console, allez dans votre Gestionnaire de configuration et désactivez le paramètre "compress". Rechargez la page et vérifiez à nouveau la présence d'erreurs dans la console JavaScript.

Si vous trouvez des erreurs dans la console JavaScript, vous devez toujours les joindre à votre rapport de bogue. De préférence, celles trouvées avec le paramètre “compress” désactivé. Cependant, il arrive parfois que des erreurs n'apparaissent qu'avec “compress enabled” — dans ce cas, envoyez-nous ces messages d'erreur.

• Undefined array key 3 in ./inc/media.php on line 1700 de dregad (2024-05-01 16:50)
• align url for lib/plugin members de Zweihorn (2024-04-30 22:01)
• `firstimage` does not return correct values for images other than PNGs, JPEGs or GIFs de sludgeFudge (2024-04-24 15:20)
• DokuWiki 2024-02-06a has a stored XSS vulnerability de Hebing123 (2024-04-16 12:02)
• GitHub actions triggered on forks de dregad (2024-04-11 18:31)
• DokuWiki can't be opened de pelayojove (2024-04-11 10:44)
• RFC: Official Docker Image de splitbrain (2024-04-10 13:12)
• New line in text should be rendered as such and not appended to the line de D267-dev (2024-04-05 18:24)

• traduction : — digitalin 2020-08-13 16:44