DokuWiki with Mac OS X and Apache

Apache and PHP are pre-installed on Mac OS X client, but disabled by default. The following should work for Leopard (10.5.x), Tiger (10.4.x) and Panther (10.3.x) client (if there is no previous version of DokuWiki installed):

1. Enable PHP in Apache and Allow Directory Accesses
   1. Backup httpd.conf:

      $ sudo cp /private/etc/apache2/httpd.conf /private/etc/apache2/httpd.conf.bak

   2. Edit httpd.conf:

      $ sudo pico /private/etc/apache2/httpd.conf

   3. Make the following changes to httpd.conf:
   • Delete the # at line 114

     CHANGE:
     
     #LoadModule php5_module
     
     TO:
     
     LoadModule php5_module

   • Change “Deny” to “Allow” at line 177

     CHANGE:
     
     <Directory />
         Options FollowSymLinks
         AllowOverride None
         Order deny,allow
         Deny from all
     </Directory>
     
     TO:
     
     <Directory />
         Options FollowSymLinks
         AllowOverride None
         Order deny,allow
         Allow from all
     </Directory>

2. Start Personal Web Sharing in System Preferences → Sharing
3. Download dokuwiki-yyyy-mm-dd.tgz (assuming to ~/Downloads)
4. Unpack downloaded file, move to appropriate location, and change ownership:

   $ cd ~/Downloads && tar -zxvf dokuwiki-yyyy-mm-dd.tgz
   $ mv dokuwiki-yyyy-mm-dd ~/Sites/dokuwiki
   $ cd ~/Sites/dokuwiki
   $ sudo chown -R www data conf

5. Restart Apache:

   sudo apachectl graceful

You should now be able to run the installer at http://localhost/~your_username/dokuwiki/install.php

For Tiger (10.4.x) and Panther (10.3.x) server:

1. Mac OS Server has Apache and PHP pre-installed; they are enabled through the Server Admin application. Enable “php4_module” under Web → Modules, and start (or restart) and configure the web service.
2. Download dokuwiki-yyyy-mm-dd.tgz (assuming to ~/Desktop)
3. From the command line:

   $ cd ~/Desktop && tar -zxvf dokuwiki-yyyy-mm-dd.tgz
   $ mv dokuwiki-yyyy-mm-dd ~/Sites/dokuwiki
   $ cd ~/Sites/dokuwiki
   $ sudo chown -R www data conf

You should now be able to run the installer at http://localhost/dokuwiki/install.php

• The third-party Apache2 package runs as 'nobody', not 'www' – change your chown command accordingly
• FYI, On Leopard I'm seeing my third party Apache2 running as 'daemon' instead of 'nobody'.
• When editing any config files manually, make sure they are saved with UNIX lineendings (LF) not Mac lineending (CR)
• When clicking on links doesn't work -will not bring you to the requested page- nor does the Login-button, you should supply DokuWiki with a basedir. For this add¹⁾ the following line in your local.php²⁾ file (Mind that the absolute dir from your serveroot is not the root from your computer, but the root from your profile with leading tilde (~).) :

$conf['basedir']     = '/~yourusername/dokuwiki/';      //absolute dir from serveroot - blank for autodetection

• In OSX 10.4, ACL doesn't work properly with the build-in webserver. In the DokuWiki, when entering the UN + PW on the Login page, it responds with “Sorry, username or password was wrong.”
• There is a somewhat outdated HOWTO for DokuWiki on Tiger available

What about MacPorts? Can anyone offer guidance there? (the MacPorts documentation is sparse on everything, so some help here would be nice)