Dokuwiki - Dev environment Configuration and Installation

1 - About

Personal configuration of my dokuwiki installation for development:

3 - Prerequisites

4 - Steps

4.1 - Clone Dokuwiki

You need to clone it in order to get the dokuwiki test class.

git clone git:// .

4.2 - Phpunit

To run individual test file on plugin:

  • add the configuration file

  • set the _test directory as Test Source. Context menu option Mark directory As Test Source Root

4.2.1 - Run

  • A class/method: add the option –stderr to the test runner options to avoid PHPUnit_Framework_Error_Warning : Cannot modify header information - headers already sent by (output started at …php\pear\PHPUnit\Util\Printer.php:172)

  • A directory: add the option –test-suffix test.php to overide the Phpunit default

See: devel:intellij_idea#integrate_unit_tests

4.3 - Environment variable

Add in the PATH

  • the php directory

4.4 - Apache

The configuration file httpd.conf is located in the configuration directory:


4.4.1 - Virtual Host

In the conf file uncomment the virtual host “include”:

# Virtual hosts
Include conf/extra/httpd-vhosts.conf

Add a virtual host

Example of virtual host in the apache_configuration_directory/extra/httpd-vhosts.conf file:

<VirtualHost *:80>
  ServerAdmin [email protected]
  ServerName gerardnico.local
  DocumentRoot "C:\www"
  DirectoryIndex index.php
  <Directory "C:\www">
    Options Indexes FollowSymLinks MultiViews
    AllowOverride all
    Order Deny,Allow
    Allow from all
    Require all granted

4.4.2 - Redirect the server name to localhost

Add an entry to your host file in order to redirect your local website serverName to your host.  gerardnico.local

4.4.3 - Rewrite Module

Uncomment the following line from the httpd.conf file

LoadModule rewrite_module modules/

or select the module from the Wamp menu.

4.5 - Dokuwiki

In conf/local.php, change the URI parameters to your local installation

$conf['basedir'] = '/wiki/';
$conf['baseurl'] = 'http://gerardnico.local';

Compact CSS and javascript output unchecked.

4.6 - Index.php

Verify that the index.php doesn't have a redirection.

4.7 - Javascript

  • debug your code with compress disabled but
  • verify your code still works with compress enabled with the JSLint online service
dokuwiki/dev_config.txt · Last modified: 2017/05/07 23:17 by gerardnico