Dokuwiki is nice.

Easy to install.

File based, so no database import/export hazzle…

Backups can be done by backing up the files.

Moving can be done by moving the directory….

NOT!?

IF YOU GET THE „PAGES NOT FOUND“ ERROR, IT’S REALLY REALLY HARD TO DEBUG WITHOUT AN PHP-DEBUGGING ENVIRONMENT!

(which is something only developers actually need… so this sucks massively)

i just tried to move another older dokuwiki installation from my backups to the new server, with the same pages-not-found error, that absolutely helps nothing.

in this case the problem was: conf/local.php

<?php
/*
 * Dokuwiki's Main Configuration File - Local Settings
 * Auto-generated by config plugin
 * Run for user: root
 * Date: Fri, 04 Nov 2011 00:05:46 +0100
 */


$conf['title'] = 'WIKIINSTANCE';
$conf['license'] = 'gnufdl';
$conf['savedir'] = '/home/user/dokuwiki/'; <-- PATH MANUALLY SET AND WRONG!

the source can be found here: https://github.com/splitbrain/dokuwiki

As soon as the „working-directory“ changes you might have had that TERRIBLE error:

DokuWiki Setup Error

The datadir (‚pages‘) at /pages is not found, isn’t accessible or writable.
You should check your config and permission settings.
Or maybe you want to run the
installer
?

I moved my installation into my PHP-DEBUGGING XDEBUG-ENABLED-PDT-WORKSPACE VM and now let’s trace that error:

<?php

doku.php ->

preload.php ->

// DO NOT use a closing php tag. This causes a problem with the feeds,
// among other things. For more information on this issue, please see:
// http://www.dokuwiki.org/devel:coding_style#php_closing_tags
define('DOKU_CONF','/var/www/dokuwiki/conf/'); <-- HERE IS A FIXED PATH DEFINED! THAT WAS NOT VALID ANYMORE!

To be honest: in total it was my fault… i wonder what made me tinker with the preload.php in the first place?

so the question is: Can we make those problems be debugged easier? because i think the average user will have a hard time ( i had ) to debug those kind of path problems 🙁

never the less: Thanks for the Free Software! 🙂 I LOVE IT 🙂

admin