====== Configuration initiale pour DokuWiki ======

Pour installer notre instance de DokuWiki, nous avons besoin de quelques composants en amont, nous allons passer dessus rapidement.

===== Server =====

Tout d'abord, il nous faut un server capable de faire tourner DokuWiki, ce qui est plutôt simple si l'on considère l'aspect léger du service: un ancien pc fixe ou portable peut faire l'affaire, ou alors il peut être installé sur un server à coté d'autres services. Nous avons choisi cette dernière option.

Coté système d'exploitation, ledit server repose sur un Debian 11 (bullseye), ce qui devrait être amplement correct.

===== Installation de PHP =====

Afin de fonctionner, DokuWiki a besoin d'un server web qui supporte PHP, et bien évidemment d'avoir PHP installé, comme on peut le lire sur leur page [[doku>fr:requirements| Configuration requise]].

Un large choix d'offre à nous vis-à-vis du server web, mais nous utilisons déjà [[https://www.nginx.org|nginx]] donc allons continuer avec celui-ci.

Quant à PHP, nous avons besoin de l'installer. La version minimale pour DokuWiki est PHP 7.2, mais il est recommandé d'utiliser PHP 8.X, qui n'est pas présent sur les repos de base de Debian 11, donc nous allons devoir ajouter un repo qui contient la bonne version avant de pouvoir procéder à l'installation.

==== 1. Ajout du repo SURY ====

Comme on vient de le préciser, nous devons ajouter un repo pour palier au fait que PHP 8.X n'est pas présent sur les repos de base de Debian.

<code bash>
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main"\
 | sudo tee /etc/apt/sources.list.d/sury-php.list
</code>

<WRAP center round info 100%>
C'est une commande en une seule ligne, ainsi vous avez juste à la copier/coller dans votre terminal et appuyer sur **Entrée**.
</WRAP>

==== 2. Import de la clé GPG sur Debian ====

Maintenant que le repo est ajouté dans la liste des repos disponibles pour notre outil APT, le système doit pouvoir vérifier l'authenticité des paquets reçus via ce repo. On ajoute donc la clé GPG à la base de clés de notre gestionnaire de paquets.

<code bash>
wget -qO - https://packages.sury.org/php/apt.gpg | sudo apt-key add -
</code>

==== 3. Mise à jour du cache APT ====

Ensuite nous devons reconstruire le cache APT pour qu'il soit à jour sur les paquets disponibles sur les différents repos.

<code bash>
sudo apt update
</code>

==== 4. Installation de PHP 8.X ====

Enfin, maintenant que tout est réglé, nous pouvons installer PHP 8 sur notre machine via le gestionnaire de paquets APT. 

<code bash>
sudo apt install php8
</code>


Et voilà, après avoir accepté le prompt qui prévient de tous les paquets qui seront installés -et un peu d'attente- PHP 8.X est installé sur notre machine.

==== 5. Installation des dépendances PHP ====

Normalement, nous devrions avoir pu s'arrêter là pour l'installation de PHP, cependant DokuWiki a besoin d'une dépendance de PHP qui peut ne pas avoir été installée via les commandes précédentes: ''php8.x-xml''. Aussi, dans notre cas, il faut installer un package nécessaire au fonctionnement de DokuWiki avec Nginx: ''php8.x-fpm''.

<code bash>
sudo apt install php8.3-{xml,fpm}
</code>

<WRAP center round important 100%>
Pensez à remplacer ''8.3'' par votre version de php afin de faire l'installation du paquet compatible pour vous.
</WRAP>

Voilà, la partie PHP est terminée, nous pouvons maintenant nous occuper de l'installation de DokuWiki en lui-même.