Table of Contents
Reporting DokuWiki Bugs
Every software has bugs. We try to ship the best possible version of DokuWiki every time, but errors happen. This page is here to help you with reporting bugs you might encounter.
Make sure it is a Bug
Before you report something, try to research if the problem you encounter really is a bug. Maybe it is intended behavior for some reason? Maybe there's a setting you could tune?
You should also search the forum if people had the same problem before. Maybe there's a fix already?
However, if still in doubt, just open a bug report. We can always close it should it turn out to not be a bug.
Check if the problem is already reported
All DokuWiki bugs should be reported in our bug tracker at GitHub located at: https://github.com/splitbrain/dokuwiki/issues. For bugs in plugins and templates use the plugin's own bugtracker — you'll find a link to that on the plugin's documentation page.
Use the search to check if your problem already has been reported. Also make sure you search through closed bugs as well — the bug might have been fixed already in development.
If the bug was reported already, check if you can provide additional information to aid fixing the bug. See below on how.
Report a Bug
As mentioned above, DokuWiki bugs have to be reported at https://github.com/splitbrain/dokuwiki/issues. You will need a free GitHub account to do so. Please do not report bugs anywhere else (IRC, Twitter, Forum). The Bug Tracker at GitHub is the only canonical way to report a bug. Again: report plugin bugs in the plugin's bug tracker.
When reporting a bug you should try to include as much information as possible that helps developers with identifying the problem.
This can include:
- DokuWiki version
- Operating system of the server and client
- The used web server
- The used PHP version
- The used browsers (try multiple)
- Everything that's special about your setup (plugins, template, auth backends, weird network config, etc.)
- Exact steps to reproduce the problem
- What did you try to fix the problem and what where the exact results?
Please also read How to Report Bugs Effectively for more tips on submitting useful bug reports.
How to obtain additional info
As mentioned above, DokuWiki developers need detailed error messages to debug a problem. Sometimes those are printed directly to the screen, but sometimes they aren't. In those cases you might want to check the following options:
Server/PHP Error Logs
Whenever something goes fatally wrong, PHP will just stop processing your request. This usually results in a blank or partially rendered page. Sometimes errors are less grave but things are still missing.
In all of those cases PHP will log an error message to some log file. Where exactly that log file resides is different from system to system. Errors might be logged to the web server's error log, the system global log or a specific PHP error log. This is configured in the error_log directive in php.ini.
Typical locations are:
If you are on a hosted server, best ask your provider where to find that log. If you don't have access to
php.ini and can't find the log file you could also try adding the following to the
.htaccess file in your DokuWiki root folder:
php_value display_errors 1 php_value display_startup_errors 1
That may send the error message to the browser.
Another solution might be the showphperrors plugin, it could be able to show the error in the browser in some cases.
DokuWiki Error logs
Since the Igor release (July 2022), DokuWiki logs also errors. Via admin interface you can use the LogViewer. If the LogViewer cannot reached, you can find the log files in your file system in
Recently opened tasks
- PHP error on http://wiki.synchro.net/ by WolfEye939 (2023-02-05 07:33)
- Website certificate is out of date by MattTraina (2023-02-03 23:46)
- getVersionData() throws PHP warnings when refs are packed by dregad (2023-02-03 18:24)
- Error: Call to undefined function shell_exec() on Admin page by dregad (2023-02-03 16:07)
- Doku - Syntax by herrdeh (2023-02-03 09:08)
- Page added notifications for changed pages by xrat (2023-02-01 14:17)
- SearchIndex plugin does not work on Cloudron by philkunz (2023-02-01 05:27)
- "Warning: Undefined array key 21" after upgrading to PHP 8.1 (View Logs) by eduardomozart (2023-02-01 01:19)