Dokuwiki - Dev environment Configuration and Installation

PATH Environment variable

Add in the PATH the php directory

Extension

extension

• Change the php.ini configuration

; some compilation needs the whole path for the extension dir
; extension_dir = "c:/php-7.2.28-Win32-VC15-x64/ext"
; some compilation (ie apache.dll) does not need the extension dir (ie 7)
; extension_dir = "ext"
[PHP]
; for image
extension=gd2
; for composer
extension=curl
extension=fileinfo
extension=mbstring
extension=pdo_sqlite
; openssl (ie fopen(): Unable to find the wrapper "https" - did you forget to enable it when you configured PHP?)
extension=openssl 
; for locale
extension=intl

You can check if they are loaded with:

php -m

and with apache via a phpinfo web page:

XDebug

This section is a summary of the article Xdebug for php 7.2

To enable Xdebug on a dokuwiki devel computer:

• Download Xdebug. For php 7.2: php_xdebug-2.9.4-7.2-vc15-x86_64.dll
• Modify php.ini

[Xdebug]
zend_extension=C:\php-7.2.28-Win32-VC15-x64\ext\php_xdebug-2.9.4-7.2-vc15-x86_64.dll
xdebug.remote_enable=1
xdebug.remote_port=9000
# enable profiler
xdebug.profiler_enable = 0;
xdebug.profiler_enable_trigger = 1
xdebug.profiler_output_dir = "<path to output folder>"
xdebug.profiler_output_name = cachegrind.out.%t-%s

Phpunit

• Install phpunit in the project to have coding assistance as stated here

cd yourProject
wget -O phpunit.phar https://phar.phpunit.de/phpunit-7.phar

Package Manager

Install

• pear (7.5.9)
• or Php - Composer

Clone Dokuwiki

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

git clone git://github.com/splitbrain/dokuwiki.git .

Configuration

Go to: http://VitrualHost/install.php to configure it

• Enable ACL - Yes - to test logged in and logged out
• ACL Policy: Public

Go to the configuration manager:

• debug your code with compress disabled. You can verify your code still works with compress enabled with the JSLint online service
• Cache: Disable the whole render cache by setting the cache page time to -1. See Dokuwiki - Cache Dev configuration
• Verify that the index.php doesn't have a redirection.
• Don't set the basurl to be able to test with ngrok. (ie google metadata checking tool does not allow localhost)

Install Stale

Install Stale to stale the cache easily.

Because we are the authors, we clone it.

cd $DOKUWIKI\lib\plugins

git clone https://github.com/ComboStrap/stale

Interpreter

Set the php interpreter to 7.1

Unit test

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

• 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)

• Change the running template

• For Combostrap developer: set the alternative bootstrap file to \plugins\combo\_test\bootstrap.php

Library

Add Jquery as library:

• Settings (CTRL + ALT + S) > Languages & Frameworks > JavaScript > Libraries (Enabled or Download Jquery)

Disable the cache in devtool