Outils pour utilisateurs

Outils du site


software:applications:dokuwiki:installation

Installation de dokuwiki

Une fois les fichiers décompressés dans le root_web, lancer le navigateur pour accéder à la page de configuration http://mon_serveur/install.php.

Activer la réécriture d'URL

Vérifier que le module mod_rewrite est activé

yoann@hermes:~$ apache2ctl -t -D DUMP_MODULES | grep -i rewrite
Syntax OK
 rewrite_module (shared)
yoann@hermes:~$

Si ce n'est pas le cas la commande suivante permet d'activer le module:

yoann@hermes:~$ sudo a2enmod rewrite

Dans le root_web de l'application éditer le fichier .htaccess
Décommenter les directives Options, RewriteEngine et les règles de redirection

.htaccess
## Enable this to restrict editing to logged in users only
 
## You should disable Indexes and MultiViews either here or in the
## global config. Symlinks maybe needed for URL rewriting.
Options -Indexes -MultiViews +FollowSymLinks
 
## make sure nobody gets the htaccess, README, COPYING or VERSION files
<Files ~ "^([\._]ht|README$|VERSION$|COPYING$)">
    Order allow,deny
    Deny from all
    Satisfy All
</Files>
 
## Uncomment these rules if you want to have nice URLs using
## $conf['userewrite'] = 1 - not needed for rewrite mode 2
RewriteEngine on
#
## Not all installations will require the following line.  If you do, 
## change "/dokuwiki" to the path to your dokuwiki directory relative
## to your document root.
#RewriteBase /dokuwiki
#
## If you enable DokuWikis XML-RPC interface, you should consider to
## restrict access to it over HTTPS only! Uncomment the following two
## rules if your server setup allows HTTPS.
#RewriteCond %{HTTPS} !=on
#RewriteRule ^lib/exe/xmlrpc.php$      https://%{SERVER_NAME}%{REQUEST_URI} [L,R=301]
#
RewriteRule ^_media/(.*)              lib/exe/fetch.php?media=$1  [QSA,L]
RewriteRule ^_detail/(.*)             lib/exe/detail.php?media=$1  [QSA,L]
RewriteRule ^_export/([^/]+)/(.*)     doku.php?do=export_$1&id=$2  [QSA,L]
RewriteRule ^$                        doku.php  [L]
RewriteCond %{REQUEST_FILENAME}       !-f
RewriteCond %{REQUEST_FILENAME}       !-d
RewriteRule (.*)                      doku.php?id=$1  [QSA,L]
RewriteRule ^index.php$               doku.php

Sur le wiki, modifier les Paramètres de configuration. Dans la section Paramètres avancés, option URL esthétiques sélectionner Fichier .htacces dans la boite de liste.

Sécurité

Attention avec les fichiers de configuration des hôtes virtuel Apache notamment sous Ubuntu. La valeur de la directive AllowOverride est à None par défaut ce qui inhibe les redéfinitions de configuration via les fichiers .htaccess et rend l'application dokuwiki vulnérable car elle expose tous les fichiers de configuration et les ressources.

  • passer la valeur de AllowOverride à All
  • redémarrer/recharger les fichiers de configuration APache.

Pour vérifier que les fichiers de configurations .htaccess sont bien pris en compte et que les dossiers de configuration de dokuwiki sont correctment protégés essayer d'afficher la ressource:

Si 'application est correctement paramétrée, on obtient une erreur 403.

Lancer également l'outil de vérification de l'installation via l'URL: http://monserveur.exemple.com/?do=check

Sauvegardes

L'application Dokuwiki n'utilise pas de base de données, il suffit de sauvegarder le root applicatif qui contiendra toutes les données.

On peut toutefois exclure les répertoires suivants:

  • ./data/cache
  • ./data/index
  • ./data/locks
  • ./data/tmp

Références

software/applications/dokuwiki/installation.txt · Dernière modification : 2021/02/01 21:51 de 127.0.0.1