View source for Installation manuelle sous Windows

<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Manual_installation_on_Windows -->
[[en:Manual_installation_on_Windows]]
<!-- END interlang links -->

[[Category:Admin fr]]
{{TemplateDocUtil}}


Cette page décrit l'installation des différents composants nécessaires au bon fonctionnement de Dolibarr sur un environnement Windows 

L'installation a été réalisée sous Windows 10 mais devrait être fonctionnelle pour d'autres versions de Windows - certaines captures d'écrans ne correspondront juste pas.

Si vous êtes débutant, sachez que la section [[Installation - Mise à jour#Avec%20DoliWamp%20.28package%20Windows%20.exe.29|Installation - Mise à jour Avec DoliWamp (package Windows .exe)]] aborde également l'installation automatisée avec DoliWamp.


L'intérêt d'installer soit même les différents composants "Serveur" nécessaires au bon fonctionnement de Dolibarr est la possibilité de choisir des versions plus récentes que celles proposées en standard par l'installeur DoliWamp.

C'est aussi un excellent moyen de comprendre comment cela fonctionne et d'approfondir ses connaissances au niveau du déploiement et de la maintenance d'une instance Dolibarr.


Cette page de documentation a été rédigée dans l'objectif d'être compréhensible au plus grand nombre (quelque-soit le niveau informatique). Certaines précisions pourront apparaître comme triviales pour certain·e·s mais seront sans nul doute utiles pour d'autres. Si vous êtes (grand·e) débutant·e, n'essayez pas d'aller vite et prenez bien le temps de lire attentivement les différentes sections de la page (prévoyez une grosse demie-journée pour la mise en œuvre).

<br />
Dans la page suivante, il a été essayé autant que possible d'expliquer les différentes actions que vous allez effectuer (le but étant bien de comprendre et non de copier/coller ou d'appliquer mécaniquement des instructions). Pour distinguer facilement les explications des actions à effectuer, sachez que l'ensemble des actions à effectuer sont précédées d'une puce (•).


Si vous avez des questions ou besoin de précisions, n'hésitez pas à les poser sur le fil dédié du forum francophone : [https://www.dolibarr.fr/forum/t/installation-manuelle-sous-windows/32241 Installation manuelle sur Windows (sur dolibarr.fr/forum)]


==Architecture de Dolibarr==


Dolibarr est une application Web de type "'''Client/Serveur'''".

Elle nécessite donc un '''Serveur Web''' avec le langage de script '''PHP''' ainsi qu'un '''Système de Gestion de Base de Données Relationnelle''' pour fonctionner.[[File:ArchitectureClientServeurDolibarr.png|none|thumb|781x781px|Architecture Client/Serveur de Dolibarr|link=Special:FilePath/ArchitectureClientServeurDolibarr.png]]<br />
===Fonctionnement===
Du côté "'''Client'''", vous utilisez un '''navigateur Internet''' (Firefox, Chrome, Opera, Internet Explorer, etc.) pour accéder à l'interface de Dolibarr en tapant l'adresse du '''Serveur Web'''.

Dès que vous tapez l'adresse à laquelle le '''Serveur Web''' répond (par exemple http://localhost/dolibarr), ce dernier va chercher à afficher la page principale du sous répertoire '''dolibarr''' (selon la configuration du Serveur Web, la page principale d'un répertoire - aussi appelée page d'index - peut être par exemple <code>index.html</code>, <code>index.htm</code> ou <code>index.php</code>).

En général, par défaut, le '''Serveur Web''' sera configuré pour reconnaître uniquement les fichiers <code>index.html</code> comme fichiers d'index mais nous verrons ensemble comment ajouter les fichiers <code>index.php</code>.

Les fichiers <code>.php</code> étant des fichiers de scripts rédigés dans le langage PHP, ils ne seront pas directement compréhensibles par le '''navigateur''' du "'''Client'''" qui n'est capable d'afficher que du HTML.

Nous devrons donc dire au '''Serveur Web''' que quand il rencontre un fichier avec l'extension <code>.php</code>, il devra utiliser son module <code>mod_php</code> pour interpréter (ou convertir si vous préférez) le code PHP en code HTML avant de le renvoyer au "'''Client'''" (c'est à dire le navigateur).

Enfin, nous avons également besoin d'installer un '''Système de Gestion de Base de Données Relationnelle''', ici MariaDB pour stocker les données de Dolibarr (ce sont les scripts PHP de Dolibarr qui interagiront avec le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> pour écrire ou lire des données depuis celui-ci).

==Installation et configuration de MariaDB==
Nous allons tout d'abord installer le serveur de bases de données MariaDB.

<br />
===Télécharger MariaDB===

*Rendez vous sur [https://downloads.mariadb.org/ le site de téléchargement de MariaDB] et cliquez sur le bouton vert '''Download xx.x.xx Stable now!''' (normalement le second bouton vert de la page).
*Dans la colonne de droite, permettant de filtrer les fichiers disponibles :
**cochez la case '''Windows''' dans la rubrique '''Operating System,'''
**dans la rubrique '''Package Type''', cochez '''MSI Package'''
**dans la rubrique '''CPU''', cochez '''32-bits''' ou '''64-bits''' en fonction de votre système d'exploitation (si vous ne savez pas, référez-vous à l'annexe [[Draft:Installation manuelle sous Windows#Comment savoir si mon ordinateur ex.C3.A9cute la version 32 bits ou 64 bits de Windows .3F|Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?]]).
*Cliquez sur le lien pour télécharger l'unique fichier désormais affiché dans la liste.

<br />
===Installer MariaDB===
<gallery widths="495" heights="387">
File:MariaDB Install 1.png|Bienvenue dans l'assistant d'installation, cliquez sur '''Next'''.
File:MariaDB Install 2.png|Cochez la case '''I accept the terms in the License Agreement''' pour accepter les termes de la licence d'utilisation puis cliquez sur '''Next'''.
File:MariaDB Install 3.png|Cette page permet de personnaliser les composants à installer. Par défaut, tous les composants sont sélectionnés pour être installés. Cliquez sur '''Next'''.
File:MariaDB Install 4.png|Dans cette étape, l'installeur vous demande de choisir un mot de passe pour l'administrateur des bases de données. Choisissez un mot de passe fort dont vous vous souviendrez puis saisissez le dans les champs '''New root password''' et '''Confirm'''. Cochez également la case '''Use UTF8 as default server's character set''' puis, cliquez sur '''Next'''.
File:MariaDB Install 5.png|Dans cette étape, l'installeur propose de personnaliser le port sur lequel le serveur de base de données sera disponible et permet de créer un Service Windows permettant le démarrage automatique du serveur lors du démarrage de l'ordinateur. Laissez l'ensemble des choix par défaut et cliquez sur '''Next'''. Si le port 3306 est déjà utilisé, lisez l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour en savoir plus.
File:MariaDB Install 6.png|Cette page vous permet - si vous le souhaitez - d'envoyez des informations anonymes sur votre utilisation aux concepteurs de MariaDB (choisissez, puis cliquez sur '''Next''').
File:MariaDB Install 7.png|Cliquez sur '''Install''' pour débuter l'installation.
File:MariaDB Install 8.png|L'assistant installe les fichiers du serveur de bases de données, crée le service Windows associé et le démarre.
File:MariaDB Install 9.png|L'installation est terminée et le serveur de bases de données MariaDB est en cours d'exécution. Cliquez sur '''Finish''' pour quitter l'assistant d'installation.
</gallery>A ce niveau, '''MariaDB''' est désormais installé et démarré. Comme un "'''Service'''" Windows a été créé, le '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' sera automatiquement démarré à chaque (re)démarrage de l'ordinateur.


==Installation et configuration de PHP==
<br />

===Télécharger PHP===

*Rendez vous sur le site https://windows.php.net/download ou utilisez les liens de la sous section '''''Liens de téléchargement directs''''' ci-dessous.
**Dans la liste des téléchargements proposés, prenez la dernière version '''Thread Safe''' de PHP '''<u>7.4.x</u>''' correspondant à votre architecture ('''x64''' si votre système est 64 bits ou '''x86''' si votre système est 32 bits).
***Il s'agit normalement du deuxième téléchargement proposé ('''<u>Attention !</u> Prenez bien garde de télécharger la version ''Thread Safe'' et PAS ''<u>Non</u> Thread Safe''''').
**Une fois que vous avez trouvé la bonne version, téléchargez le fichier en cliquant sur le lien '''<u>Zip</u>'''.

==== Liens de téléchargement directs : ====

* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x64-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 64 bits]
* [https://windows.php.net/downloads/releases/latest/php-7.4-Win32-vc15-x86-latest.zip dernière version de PHP 7.4.x Thread-Safe pour systèmes 32 bits]<br /><br />

===Extraire l'archive pour installer PHP===

*Une fois téléchargée, effectuez un clic droit sur l'archive et sélectionnez '''Extraire tout...'''
*Indiquez <code>C:\php</code> comme chemin de destination et cliquez sur '''Extraire'''.

<br />
[[File:Extraire PHP.png|none|frame|link=Special:FilePath/Extraire_PHP.png]]
<br />

===Configurer PHP===
Maintenant que PHP est décompressé au bon endroit, nous allons configurer quelques réglages.

PHP est livré avec des '''extensions''' et Dolibarr a besoin que certaines de ces extensions soient activées (elles ne le sont pas par défaut).
<br />

====Activer l'affichage des Extensions de noms de fichiers====

*Dans l''''Explorateur de fichiers''' Windows, cliquez sur l'onglet '''Affichage''' et cochez la case '''Extensions de noms de fichiers''' du groupe '''Afficher/Masquer'''.

[[File:Activer l'affichage des Extensions de noms de fichiers.png|none|frame|Activer l'affichage des '''Extensions de noms de fichiers'''.|link=Special:FilePath/Activer_l'affichage_des_Extensions_de_noms_de_fichiers.png]]


====Créer le fichier de configuration de PHP à partir du modèle====
Pour personnaliser votre installation de PHP, il va falloir modifier le fichier de configuration de php (le fichier <code>php.ini</code>).

*Rendez vous dans le dossier où vous avez décompressé PHP (<code>C:\php</code>) en utilisant l'<nowiki/>'''Explorateur de fichiers''' Windows > '''Disque Local (C:)''' > '''php''' (si vous aviez coché la case '''Afficher les dossiers extraits une fois l'opération terminée''' lors de l'extraction de l'archive, l''''Explorateur de fichiers''' Windows devrait déjà être ouvert au bon endroit).

Dans ce dossier contenant les fichiers de PHP, vous trouverez deux fichiers de configuration "modèle" <code>php.ini-development</code> et <code>php.ini-production</code>.

*Effectuez une copie (clic droit, '''Copier''') du fichier <code>php.ini-production</code> et collez le dans le même répertoire (clic droit, '''Coller''').

*Renommez le fichier copié (<code>php - Copie.ini-production</code>) en <code>php.ini</code> (clic droit, '''Renommer''' sur le fichier).

Lors de la validation du nouveau nom de fichier, Windows vous avertira suite à la modification de l'extension du fichier (vous devez répondre '''Oui''' à cette question pour valider le renommage du fichier).
[[File:Avertissement renommage.png|none|frame|Avertissement Windows lors du changement d'extension d'un fichier.|link=Special:FilePath/Avertissement_renommage.png]]


<br />

====Activer les extensions PHP nécessaires à Dolibarr====
Double-cliquez sur le fichier <code>php.ini</code> pour l'ouvrir dans '''Bloc-notes''' Windows et pouvoir ainsi le modifier.

Faites défiler le fichier pour trouver la section débutant par <code>Dynamic Extensions</code> encadré par des <code>;</code> (environ à la moitié du fichier) :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Dans cette section, vous allez devoir enlever le <code>;</code> devant certaines des extensions pour les charger (changer par exemple <code>;extension=gd2</code> en <code>extension=gd2</code>).

Enlevez le <code>;</code> devant les lignes <code>;extension=curl</code>, <code>;extension=gd2</code>, <code>;extension=intl</code>, <code>;extension=mysqli</code>, <code>;extension=mbstring</code>, <code>;extension=imap</code>.
<br />

====Modifier certains autres paramètres de PHP====
<u>Astuce :</u> pour trouver facilement un paramètre dans le fichier <code>php.ini</code>, vous pouvez utiliser la fonction '''Rechercher''' du '''Bloc-notes''' Windows (menu '''Edition''' > '''Rechercher''' ou <kbd>Ctrl</kbd> + <kbd>F</kbd>). Saisissez votre recherche puis cliquez sur '''Suivant'''. Selon votre position dans le fichier, n'hésitez pas à inverser le sens de la recherche en sélectionnant l'option '''Haut''' au lieu de '''Bas''' dans le cadre '''Direction''' puis à cliquer de nouveau sur suivant pour effectuer la recherche dans le sens inverse du fichier.
[[File:Recherche Bloc-notes Windows.png|none|frame|La boîte de dialogue '''Rechercher''' permettant de rechercher un texte dans le fichier.|link=Special:FilePath/Recherche_Bloc-notes_Windows.png]]
<br />
=====Régler le fuseau horaire=====
En dessous de la section :<syntaxhighlight lang="ini">
;;;;;;;;;;;;;;;;;;;
; Module Settings ;
;;;;;;;;;;;;;;;;;;;
</syntaxhighlight>Sous la sous-section <code>[Date]</code>, remplacez la ligne <code>;date.timezone =</code> par <code>date.timezone = Europe/Paris</code> (n'oubliez pas de retirer le <code>;</code> en début de ligne).

=====Augmenter la taille des fichiers pouvant être téléversés=====
Par défaut, les fichiers pouvant être téléversés sur le serveur par l'intermédiaire du bouton '''Parcourir...''' des formulaires de Dolibarr (relevés bancaires PDF, factures fournisseurs, etc.) sont limités à une taille de 2M.

Si vous le souhaitez, vous pouvez augmenter cette limite en modifiant ces lignes :

*remplacez la ligne <code>upload_max_filesize = 2M</code> par  <code>upload_max_filesize = 16M</code> par exemple ;
*si vous choisissez une valeur supérieure à 8M pour <code>upload_max_filesize</code>, vous aurez également besoin de remplacer <code>post_max_size = 8M</code> par <code>post_max_size = 16M</code>.


Enregistrez le fichier ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le. 

Nous avons maintenant configuré PHP.
<br />

==Installation et configuration de Apache2==

===Télécharger Apache2===

*Rendez-vous sur le site https://www.apachelounge.com/download/
*Téléchargez le fichier correspondant à l'architecture de votre système d'exploitation en cliquant sur le lien (Win64 pour 64 bits ou Win32 pour 32 bits).<br />

===Extraire l'archive pour installer Apache2===
Contrairement à l'installation de PHP, nous allons procéder légèrement différemment pour la décompression de l'archive Apache2.

Au lieu d'extraire l'ensemble de l'archive, nous n'allons extraire que le dossier <code>Apache24</code>.

*Pour ce faire, commencez par double-cliquer sur l'archive <code>httpd-x.x.xx-winxx-VSxx.zip</code> pour l'ouvrir dans l''''Explorateur de fichiers''' Windows.
*Ouvrez de nouveau l''''Explorateur de fichiers''' Windows puis rendez vous dans le '''Disque Local (C:)'''.
*Faites glisser le dossier '''Apache24''' depuis l'archive dans le '''Disque Local (C:)'''.

[[File:Décompresser Apache2.png|none|thumb|781x781px|Décompression de Apache2 en faisant glisser le dossier '''Apache24''' dans le '''Disque Local (C:)'''|link=Special:FilePath/Décompresser_Apache2.png]]

S'ensuit une copie de fichiers (plus longue cette fois que pour PHP) correspondant à la décompression de l'archive dans le '''Disque Local (C:)'''.
[[File:Copie fichiers Apache2.png|none|frame|Copie des fichiers depuis l'archive '''Apache2''' vers le '''Disque Local (C:)''']]

===Configurer Apache2===
Maintenant que '''Apache2''' est décompressé, nous allons avoir besoin de modifier quelques paramètres de son fichier de configuration.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''conf'''.
*Double-cliquez sur le fichier '''<code>httpd.conf</code>''' pour ouvrir le fichier avec le '''Bloc-notes''' Windows et modifier ainsi le fichier de configuration de '''Apache2'''.

====Renseigner le nom d'hôte du Serveur Web====

*Cherchez la ligne <code>#ServerName www.example.com:80</code> et remplacez la par <code>ServerName localhost:80</code>.

====Traiter les fichiers <code>index.php</code> comme des fichiers d'index====

*Cherchez le bloc

<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
    DirectoryIndex index.html
</IfModule>
</syntaxhighlight>et remplacez le par<syntaxhighlight lang="apacheconf">
<IfModule dir_module>
    DirectoryIndex index.php index.html
</IfModule>
</syntaxhighlight>De cette façon, lorsque nous accéderons à un répertoire, '''Apache2''' cherchera d'abord s'il existe un fichier <code>index.php</code> avant de regarder s'il existe un fichier <code>index.html</code>. 

====Interpréter les fichiers <code>*.php</code>====
Vous vous souvenez, au début, dans la section introductive sur l'architecture de Dolibarr, je vous ai indiqué que les navigateurs (Firefox, Chrome, Internet Explorer, etc.) que nous utilisons ne peuvent comprendre et afficher que des pages Web rédigées en langage HTML. Nous devons donc dire à '''Apache2''' d'interpréter (convertir) les fichiers <code>*.php</code> en code HTML compréhensible par les navigateurs.

*Tout à la fin du fichier <code>httpd.conf</code>, sautez une ligne puis collez le bloc de code suivant pour indiquer à '''Apache2''' d'interpréter les fichiers <code>*.php</code> :

<syntaxhighlight lang="apacheconf">
LoadModule php7_module "c:/php/php7apache2_4.dll"
AddType application/x-httpd-php .php
PHPIniDir "C:/php"
</syntaxhighlight>

*

Ceci indiquera à '''Apache2''' d'utiliser le <code>php7_module</code> fourni avec PHP que nous avons installé précédemment pour interpréter les fichiers <code>*.php</code>

*Enregistrez le fichier <code>httpd.conf</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

===Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2===
L'extension <code>intl</code> de PHP est responsable des fonctions d'internationalisation (de gestion des traductions) des applications qui l'utilisent.
L'extension <code>curl</code> de PHP permet d'effectuer des requêtes vers (de contacter) des serveurs externes.

Dolibarr nécessite les extensions <code>intl</code> et <code>curl</code> et ces extensions ont besoin de certaines librairies (fichiers de fonctions) pour fonctionner.

Ces librairies sont fournies avec PHP, mais comme nous utilisons le <code>php7_module</code> avec '''Apache2''', nous avons besoin de copier ces fichiers depuis le répertoire de PHP vers le répertoire <code>bin/</code> de '''Apache2''' pour que les extensions <code>intl</code> et  <code>curl</code> puissent fonctionner correctement.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''php''' (<code>C:\php</code>).
*Sélectionnez les fichiers <code>icudt65.dll</code>, <code>icuin65.dll</code>, <code>icuio65.dll</code>, <code>icuuc65.dll</code>, <code>libcrypto-1_1-x64.dll</code>, <code>libssl-1_1-x64.dll</code> et <code>libssh2.dll</code> en cliquant sur le premier fichier, puis tout en maintenant la touche Ctrl de votre clavier, sélectionner les autres fichiers en cliquant dessus.
*Copiez les fichiers (clic droit, puis '''Copier''' ou Ctrl + C).
*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24''' et ensuite dans le sous répertoire '''bin''' (<code>C:\Apache24\bin</code>).
*Collez les fichiers (clic droit, puis '''Copier''' ou Ctrl + V).<br />

===Créer et démarrer le "Service" Windows pour lancer automatiquement Apache2===
Dans la première partie de cette documentation, lorsque nous avons installé le <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB, souvenez-vous, il y avait une page de l'assistant d'installation qui proposait de créer un "Service" Windows et de personnaliser son nom.

Les "Services" sont très pratiques et permettent de démarrer automatiquement une application au (re)démarrage de l'ordinateur. Contrairement au dossier de démarrage, les "Services" sont exécutés avant même l'ouverture d'une "Session" utilisateur Windows.

Nous allons donc créer un "Service" Windows pour démarrer automatiquement '''Apache2''' au (re)démarrage de l'ordinateur.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>cmd</code>. Dans la liste des options proposées, choisissez "'''Exécuter en tant qu'administrateur'''" puis validez la fenêtre de '''Contrôle de compte utilisateur'''.

[[File:Exécuter Invite de commandes en tant qu'administrateur.png|none|Exécuter l''''Invite de commandes''' Windows en tant qu'administrateur|thumb|613x613px|link=Special:FilePath/Exécuter_Invite_de_commandes_en_tant_qu'administrateur.png]]

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
C:/Apache24/bin/httpd.exe -k install
</syntaxhighlight>
[[File:Créer le service Apache2 avec l'Invite de commandes Windows.png|none|frame|Création du "Service" Windows avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.|link=Special:FilePath/Créer_le_service_Apache2_avec_l'Invite_de_commandes_Windows.png]]
Le "Service" que nous venons de créer n'est pour l'instant pas démarré donc, nous avons besoin de le démarrer pour la première fois (il sera ensuite démarré automatiquement à chaque (re)démarrage de l'ordinateur).

*Saisissez la commande suivante dans l''''Invite de commandes''' Windows puis validez avec la touche Entrée :

<syntaxhighlight lang="batch">
net start Apache2.4
</syntaxhighlight>
[[File:Démarrer le Service Apache2.4.png|none|frame|Démarrage du "Service" Windows '''Apache2.4''' avec l''''Invite de commandes''' Windows exécutée en tant qu'administrateur.]]

Si le service ne démarre pas correctement, c'est parce que votre fichier de configuration <code>httpd.conf</code> est invalide.

Pour déterminer la cause de votre erreur le cas échéant, vous pouvez saisir la commande suivante dans l''''Invite de commandes''' Windows :<syntaxhighlight lang="batch">
C:\Apache24\bin\httpd.exe -n "Apache2.4" -t
</syntaxhighlight>
Cette commande permet de tester la validité de votre fichier <code>httpd.conf</code> et devrait vous renvoyer la ligne à laquelle l'erreur est rencontrée. 

Outre les erreurs de syntaxe courantes en cas d’inattention, l'une des erreurs les plus fréquente est l'absence du fichier <code>C:\php\php7apache2_4.dll</code>. Ce fichier est en effet absent si vous avez téléchargé la mauvaise version de PHP ('''<u>Non</u>''' '''Thread Safe''') au lieu de la version '''Thread Safe'''. Dans ce cas, téléchargez la bonne archive ('''Thread Safe''') et effectuez de nouveau la partie [[Installation_manuelle_sous_Windows#Extraire_l'archive_pour_installer_PHP]].

Une autre problématique pouvant être rencontrée est l'impossibilité de démarrer '''Apache2''' car le port '''80''' est déjà utilisé par un autre programme. Voyez dans ce cas l'annexe [[Installation manuelle sous Windows#Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?|Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?]] pour savoir comment procéder.

Une fois vos éventuelles erreurs corrigées, essayez de nouveau de démarrer le Service '''Apache2.4''' avec la commande mentionnée précédemment.


Vous pouvez maintenant fermer l''''Invite de commandes''' Windows.

'''Apache2.4''' est désormais installé en tant que "Service" Windows et démarré. Le "Serveur Web" Apache2 sera donc démarré automatiquement à chaque (re)démarrage de l'ordinateur.

==Vérifions que tout fonctionne==
Avant de passer à la suite (l'installation proprement dite de '''Dolibarr'''), prenons un instant pour vérifier que notre installation actuelle fonctionne correctement.

===Vérifier le bon fonctionnement du <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> MariaDB===

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mysql client</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''MySQL Client (MariaDB 10.4 (x64)''').

[[File:Lancer MySQL Client.png|none|thumb|561x561px|Exécuter l'application '''MySQL Client (MariaDB 10.4 (x64))'''|link=Special:FilePath/Lancer_MySQL_Client.png]]
L'application '''MySQL Client (MariaDB 10.4 (x64)''' se lance.

Il s'agit d'une invite de commandes spécifique à votre '''<abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr>''' '''MariaDB''' permettant d'exécuter des commandes de bases de données (en langage SQL).

*Saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de '''MariaDB''' précédemment (au quatrième écran de l'installeur) puis appuyez sur Entrée pour valider le mot de passe.
*Saisissez l'instruction SQL <code>SHOW DATABASES;</code> pour lister les bases de données actuelles puis appuyez sur Entrée pour valider la commande.

'''MariaDB''' devrait vous répondre avec la liste des bases de données automatiquement créées lors de l'installation : <code>information_schema</code>, <code>mysql</code>, <code>performance_schema</code> et <code>test</code>.
[[File:Lister les bases de données MariaDB.png|none|frame|Liste des bases de données gérées par le '''SGBR''' '''MariaDB''' installé sur notre ordinateur.|link=Special:FilePath/Lister_les_bases_de_données_MariaDB.png]]


Ceci conclu notre test de bon fonctionnement de MariaDB.

Nous avons en effet été en mesure de nous connecter avec succès au <abbr title="Système de Gestion de Base de Données Relationnelle">SGBDR</abbr> avec le mot de passe administrateur que nous avions précédemment choisi et l'exécution d'une instruction SQL ( <code>SHOW DATABASES;</code> ) a correctement fonctionné.

Vous pouvez désormais fermer l'application '''MySQL Client (MariaDB 10.4 (x64)'''.

===Vérifier le bon fonctionnement de Apache2===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost</code> dans la barre d'adresse puis validez par '''Entrée'''.

Si vous avez correctement installé '''Apache2''', le "Serveur Web" devrait vous répondre un joli <code>It works!</code> que l'on peut traduire par "Ça fonctionne !" en français.
[[File:It works! Apache2.png|none|frame|La page par défaut du Serveur Web '''Apache2'''.|link=Special:FilePath/It_works!_Apache2.png]]


Ceci conclu notre test de bon fonctionnement de '''Apache2'''.

Nous avons en effet été en mesure d'obtenir une réponse du Serveur Web '''Apache2''' (en l'occurence  <code>It works!</code>) ce qui prouve qu'il a été correctement installé et démarré.

Vous pouvez désormais fermer votre Navigateur Web.<br />

===Vérifier le bon fonctionnement de PHP===
Concernant la partie PHP, nous avons deux choses à vérifier.

#Les fichiers <code>index.php</code> sont correctement reconnus lorsque l'on accède à un répertoire.
#Les fichiers <code>*.php</code> sont correctement interprétés par PHP et renvoient bien du HTML.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).

Vous trouverez dans ce dossier un fichier <code>index.html</code>. C'est le fameux fichier qui contient <code><nowiki><html><body><h1>It works!</h1></nowiki><nowiki></body></nowiki><nowiki></html></nowiki></code> soit la réponse en HTML que nous a renvoyé '''Apache2''' quand nous avons accédé au serveur en tapant l'adresse <code>http://localhost</code>.

*Dans le dossier '''htdocs''' (<code>C:\Apache24\htdocs</code>), créez un nouveau dossier <code>test</code> (clic droit, '''Nouveau''' > '''Dossier''').
*Double-cliquez sur le nouveau dossier <code>test</code> pour entrer dedans.
*Créez un nouveau fichier <code>index.php</code> (clic droit, '''Nouveau''' > '''Document texte''').
*Ouvrez le document avec le '''Bloc-notes''' Windows (clic droit, '''Ouvrir avec''' > '''Bloc-notes''' ; si '''Bloc-notes''' n'est pas proposé, cliquez sur '''Choisir une autre application''', puis sur '''Plus d'applications''' et sélectionnez '''Bloc-notes''' dans la liste avant de valider par '''OK''').
*Saisissez le code '''PHP''' suivant dans le fichier :

<syntaxhighlight lang="php">
<?php
phpinfo();
</syntaxhighlight>

*Enregistrez le fichier <code>index.php</code> ('''Fichier''' > '''Enregistrer''' ou <kbd>Ctrl</kbd> + <kbd>S</kbd>) et fermez-le.

Lorsque PHP traite un fichier, il cherche les balises d'ouverture et de fermeture (''<code><?php</code>'' et ''<code>?></code>'') qui délimitent le code qu'il doit interpréter. <code><?php</code> permet donc d'indiquer que nous allons écrire du code '''PHP'''.

La fonction <code>[https://www.php.net/manual/fr/function.phpinfo.php phpinfo]</code> affiche de nombreuses informations sur la configuration de '''PHP''', ce qui nous permettra de vérifier que '''PHP''' fonctionne et que nous avons bien activé les bonnes extensions.

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez cette fois l'adresse <code>http://localhost/test</code> dans la barre d'adresse puis validez par '''Entrée'''.

'''Apache2''' devrait vous renvoyer une page générée par '''PHP''' contenant l'ensemble des informations de configuration. Si vous faites défiler cette page, vous '''<u>devez</u>''' voir des sections liées aux extensions que nous avons chargées précédemment (notamment <code>curl</code>, <code>gd2</code>, <code>intl</code> et <code>mysqli</code>) Si l'une de ces sections n'est pas affichée, cela signifie que l'extension n'est pas chargée (vous avez donc oublié de retirer un point virgule devant le nom d'une extension lors de votre édition du fichier <code>C:\php\php.ini</code> ou alors vous avez oublié de copier l'un des fichiers mentionnés dans la section [[Installation manuelle sous Windows#Copier les fichiers nécessaires aux extensions PHP intl et curl dans le répertoire bin/ de Apache2|Copier les fichiers nécessaires aux extensions PHP <code>intl</code> et <code>curl</code> dans le répertoire <code>bin/</code> de Apache2]]. Vérifiez et corrigez le cas échéant vos oublis puis redémarrez le Service '''Apache2.4''' pour que vos modifications soient prises en compte (voir l'annexe [[Installation manuelle sous Windows#Comment gérer les "Services" Windows ?|Comment gérer les "Services" Windows ?]] pour savoir comment redémarrer un Service existant).
[[File:Phpinfo().png|border|none|thumb|750x750px|'''Apache2''' nous renvoie la page contenant les informations de configuration générée par '''PHP'''.]]
<br />Ceci conclu notre test de bon fonctionnement de '''PHP'''.

Nous avons en effet été en mesure de vérifier que '''PHP''' fonctionne correctement car il renvoie bien les informations liées à sa configuration courante.

De plus, les fichiers '''PHP''' <code>index.php</code> sont bien interprétés comme des fichiers d'index car notre fichier a bien été exécuté en saisissant  <code>http://localhost/test</code> (nous n'avons pas eu besoin de saisir  <code>[http://localhost/test http://localhost/test/index.php]</code> ).

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Supprimez le dossier <code>test</code> que nous avions précédemment créé.

Vous pouvez désormais fermer l''''Explorateur de fichiers''' Windows ainsi que votre Navigateur Web.

<br />

*

#

==Installation de Dolibarr==
C'est la fête (sortez les ballons et les cotillons), le moment que vous attendiez tant est enfin arrivé ! Nous allons enfin pouvoir installer Dolibarr.

===Télécharger Dolibarr===

*Rendez-vous sur les miroirs SourceForge à l'adresse https://sourceforge.net/projects/dolibarr/files/
*Cliquez sur le dossier '''Dolibarr ERP-CRM''', puis sur le dernier numéro de version et cliquez sur le fichier portant l'extension '''.zip''' pour le télécharger.

===Créer le dossier <code>documents</code> de Dolibarr===
Dolibarr a besoin d'un dossier <code>documents</code> dans lesquels il stocke les documents générés (Propositions commerciales, Commandes, Factures, Fiches d'interventions, Bons de livraison) mais aussi les documents téléversés par l'utilisateur (Relevés de compte, Factures fournisseurs, etc.).

Par mesure de sécurité, il est préférable de créer le dossier <code>documents</code> en dehors du Serveur Web (pour nous '''Apache2''').

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)'''.
*Créez un nouveau dossier <code>dolibarr</code> puis double-cliquez dessus et créez de nouveau un dossier <code>documents</code>. Nous obtenons donc le répertoire <code>C:\dolibarr\documents</code>

===Extraire l'archive de Dolibarr===
Pour l'extraction de l'archive Dolibarr, nous allons procéder de manière similaire à celle de '''Apache2''' en utilisant la technique du glisser-déposer.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Enfin, accédez au répertoire '''htdocs''' (<code>C:\Apache24\htdocs</code>).
*Créez le dossier <code>dolibarr</code> puis double-cliquez dessus.
*Double-cliquez ensuite sur l'archive de Dolibarr que vous venez de télécharger pour l'ouvrir dans une nouvelle fenêtre de l''''Explorateur de fichiers''' Windows.
*Naviguez dans l'archive vers le dossier <code>dolibarr-xx-x-x</code> puis vers le dossier <code>htdocs</code>.
*Sélectionnez l'ensemble des fichiers du répertoire <code>htdocs</code> en utilisant le bouton '''Sélectionner tout''' du groupe '''Sélectionner''' de l'onglet '''Accueil''' de l''''Explorateur de fichiers''' Windows (ou en utilisant le raccourci clavier Ctrl + A).
*Faites glisser les fichiers sélectionnés vers le dossier <code>dolibarr</code> créé précédemment (dans l'autre fenêtre).

[[File:Extraire l'archive Dolibarr dans Apache2.png|none|thumb|773x773px|Extraction du répertoire htdocs de l'archive Dolibarr dans le répertoire <code>dolibarr</code> du Serveur Web Apache2.]]
En raison du grand nombre de fichiers fournis avec Dolibarr et en fonction de la vitesse de votre disque dur ou SSD, la décompression peut prendre plusieurs minutes.
[[File:Décompression archive Dolibarr.png|none|frame|Décompression de l'archive Dolibarr vers le répertoire <code>dolibarr</code> du Serveur Web Apache2.|link=Special:FilePath/Décompression_archive_Dolibarr.png]]
<br />

*

===Installer Dolibarr===

*Démarrez votre Navigateur Web favori (Firefox, Google Chrome, Opera, Brave, Vivaldi, Internet Explorer, Edge, etc.) et saisissez l'adresse <code>http://localhost/dolibarr</code> dans la barre d'adresse puis validez par '''Entrée''' pour débuter l'installation de Dolibarr.
<gallery widths="500" heights="375">
File:Installation Dolibarr - Choix de la langue.png|Cette page vous permet de modifier la langue (la langue sélectionnée par défaut est automatiquement déduite de la langue de votre navigateur). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Vérification des prérequis.png|Cette page vérifie les prérequis à l'installation de Dolibarr (notamment les différentes extensions PHP nécessaires). Si vous avez suivi correctement les informations de cette page, l'ensemble des vérifications devraient être validées. Cliquez sur le bouton '''Démarrer''' pour passer à la suite de l'installation.
File:Installation Dolibarr - Serveur Web.png|Cette page de l'installation permet de définir les chemins. Les valeurs proposées par défaut sont correctes hormis pour le '''Répertoire devant contenir les documents générés (PDF, etc.)'''. Modifiez cette valeur pour indiquer le répertoire que nous avons créé précédemment (pour rappel <code>C:/dolibarr/documents</code>).
File:Installation Dolibarr - Base de données.png|Toujours sur cette même page, nous allons désormais renseigner les informations permettant à l'installeur de créer la base de données de Dolibarr. Reportez-vous à la section "Configurer la base de données" sous la galerie pour davantage d'informations.
File:Installation Dolibarr - Création du fichier de configuration.png|L'installeur crée le fichier de configuration contenant l'ensemble des informations que vous avez renseigné jusque là et l'enregistre sur le disque dans <code>C:\Apache24\htdocs\dolibarr\conf\conf.php</code>. Il crée aussi l'utilisateur '''dolibarr''' dans MariaDB et la base de données '''dolibarr'''. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création des tables.png|L'installeur crée maintenant l'ensemble des tables dans la base de données '''dolibarr''' (cette étape peut durer plusieurs secondes, c'est normal ; soyez patient).
File:Installation Dolibarr - Validation de la création des tables.png|Cette page confirme la bonne installation des tables, des fonctions et des données de références dans la base de données '''dolibarr'''. Vous pouvez également choisir d'indiquer que vous venez d'installer avec succès Dolibarr à l'Association Dolibarr (merci !). Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Création de l'administrateur.png|Cette dernière étape vous permet de créer l'utilisateur Dolibarr qui vous servira à vous identifier pour accéder à Dolibarr. Choisissez, là encore, un mot de passe différent des précédents (vous ne devriez de toute façon jamais réutiliser un mot de passe) ainsi que votre identifiant. Cliquez sur '''Étape suivante ->'''
File:Installation Dolibarr - Fin de l'installation.png|C'est terminé ! Félicitations, vous pouvez cliquer sur '''Accéder à Dolibarr (espace de configuration)''' pour terminer l'installation. L'installeur vous recommande également de créer un fichier <code>install.lock</code> (nous verrons comment procéder ci-dessous).
</gallery>

====Configurer la base de données====
Pour que les explications soient plus simples, j'ai numéroté les différents champs que vous avez besoin de modifier.<gallery widths="436" heights="259">
File:Créer base de données.png
File:Super-utilisateur base de données.png
</gallery>0 - Cochez la case '''Créer la base de données'''.

1 - Renseignez '''<code>dolibarr</code>''' comme identifiant (cet utilisateur sera créé dans MariaDB par l'installeur Dolibarr et aura '''<u>uniquement</u>''' l'autorisation d'accéder à la base '''<code>dolibarr</code>''' nouvellement créée).

2 - Renseignez un mot de passe différent (que vous n'avez jamais utilisé, et qui sera spécifique à l'utilisateur MariaDB '''<code>dolibarr</code>''')

3 - Cochez '''Créer le propriétaire ou lui affecter les droits à la base''' (ceci demande à l'installeur Dolibarr de créer le nouvel utilisateur MariaDB intitulé '''<code>dolibarr</code>''' que nous avons renseigné si dessus avec le mot de passe spécifié).

4 - Saisissez '''<code>root</code>''' (il s'agit de l'identifiant utilisateur MariaDB de l'administrateur des bases de données ayant tous les droits).

5 - Saisissez le mot de passe MariaDB de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'installation).

<br />

====Terminer la configuration de Dolibarr====
<gallery widths="500" heights="340">
File:S'identifier.png|La page d'identification de Dolibarr.
File:Configuration Dolibarr post-installation.png|La page '''Configuration''' de Dolibarr.
</gallery>Maintenant que Dolibarr est installé avec succès, nous devons finir le paramétrage initial (il s'agit de renseigner les informations de votre société et d'activer un ou plusieurs modules à utiliser).

*Renseignez votre nom d'utilisateur et votre mot de passe et cliquez sur '''Se connecter'''.

Vous êtes automatiquement redirigé vers la page '''Configuration''' de Dolibarr car le paramétrage initial n'est pas terminé.

*Dans le menu de gauche, sous '''Configuration''', cliquez sur '''Société/Organisation''' et renseignez les informations sur votre société puis cliquez sur '''Enregistrer''' en bas de page.
*Toujours dans le menu de gauche, cliquez ensuite sur '''Modules/Applications''' puis activez les modules souhaités en cliquant sur l'icône représentant un interrupteur en bout de ligne.
<gallery widths="550" heights="340">
File:Informations société.png|La page '''Société/Organisation''' vous permettant de renseigner les informations de votre société ou organisation.
File:Activation module.png|La page '''Modules/Applications''' vous permettant d'activer et de désactiver les modules que vous souhaitez utiliser en fonction de vos besoins.
</gallery>Nous avons maintenant terminé la configuration initiale de Dolibarr. Bravo !

*Cliquez sur '''Mon tableau de bord''' pour afficher la page de démarrage de Dolibarr.

[[File:Avertissement tableau de bord.png|none|thumb|708x708px|La page '''Mon tableau de bord''' de Dolibarr. Elle présente actuellement des avertissements car nous n'avons pas créé de fichier <code>install.lock</code> et que le fichier de configuration de Dolibarr (<code>conf.php</code>) est accessible en écriture par le Serveur Web.|link=Special:FilePath/Avertissement_tableau_de_bord.png]]

=====Créer le fichier <code>install.lock</code>=====
Le fichier <code>install.lock</code> est important, puisque il permet d'éviter que n'importe qui puisse relancer l'installation de Dolibarr en accédant à l'adresse <code>http://localhost/dolibarr/install</code>.

Si vous utilisez uniquement Dolibarr sur votre ordinateur et que celui-ci n'est pas accessible depuis le réseau (local ou Internet), il n'est pas forcément nécessaire de créer le fichier mais c'est une bonne habitude à prendre car vous serez peut-être amené par la suite à "ouvrir" votre installation Dolibarr.

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''dolibarr'''. Enfin, accédez au répertoire '''documents''' (<code>C:\dolibarr\documents</code>).
*Créez un fichier <code>install.lock</code> (clic droit puis '''Nouveau''' > '''Document texte''').
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le premier avertissement relatif à l'absence de fichier <code>install.lock</code> a disparu.

=====Restreindre l'accès en écriture du Serveur Web au fichier <code>conf.php</code>=====

*Avec l''''Explorateur de fichiers''' Windows, rendez-vous dans le '''Disque Local (C:)''' puis dans le répertoire '''Apache24'''. Accédez au répertoire '''htdocs''' puis à '''dolibarr''' et enfin à '''conf''' (<code>C:\Apache24\htdocs\dolibarr\conf</code>).
*Effectuez un clic droit sur le fichier <code>conf.php</code> et sélectionnez l'option '''Propriétés'''
*Dans la boîte de dialogue '''Propriétés de : conf.php''', cochez la case '''Lecture seule''' pour l'option '''Attributs''' puis cliquez sur '''OK'''.
*Dans votre Navigateur Internet, cliquez de nouveau sur le lien '''Mon tableau de bord''' de la colonne de gauche de Dolibarr et constatez que le second avertissement relatif à l'accessibilité en écriture au Serveur Web du fichier <code>conf.php</code> a disparu.
*

[[File:Lecture seule fichier de configuration Dolibarr.png|none|thumb|636x636px|Activation de l'attribut '''Lecture seule''' pour le fichier de configuration principal <code>conf.php</code>de Dolibarr.|link=Special:FilePath/Lecture_seule_fichier_de_configuration_Dolibarr.png]]
<br />
==Annexes==

===Que sont les "Ports d'écoute" et comment savoir si un programme occupe déjà un port spécifique ?===

====Qu'est-ce qu'un "Port d'écoute"====
Lorsque vous installez un programme "'''Serveur'''", vous devez choisir un port sur lequel le programme sera disponible et qui sera utilisé par le programme "'''Client'''" pour communiquer avec le "'''Serveur'''". Le port est donc le canal de communication entre le "'''Client'''" et le "'''Serveur'''" (souvenez vous du schéma d'architecture en début de page).

Le port par défaut qu'utilise le Serveur de Bases de Données '''MariaDB''' est le port '''3306'''.

Le port par défaut qu'utilise le Serveur Web '''Apache2''' pour communiquer avec le "Client" (votre Navigateur Internet) est le port '''80'''.

Si d'autres programmes utilisent déjà soit le port '''3306''' ou le port '''80''', vous aurez besoin de choisir un autre port sur lequel le Serveur de Bases de Données '''MariaDB''' ou le Serveur Web '''Apache2''' sera disponible.

====Comment savoir si un programme occupe déjà un port spécifique ?====
Si vous essayez d'installer le Serveur de Bases de Données '''MariaDB''' ou le "Service" Windows du Serveur Web '''Apache2''' sur un port qui est déjà occupé par un autre programme, vous rencontrerez une erreur.

Pour vérifier quel programme écoute sur quel port, vous pouvez utiliser le '''Moniteur de ressources''' Windows.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>moniteur de ressources</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Moniteur de ressources''').

[[File:Moniteur de ressources Windows.png|none|thumb|516x516px|Exécuter l'application '''Moniteur de ressources''' de Windows|link=Special:FilePath/Moniteur_de_ressources_Windows.png]]

*Dans le '''Moniteur de Ressources''', cliquez sur l'onglet '''Réseau'''.
*Dans la section '''Ports d'écoute''', triez la colonne '''Port''' afin de pouvoir rechercher plus facilement.
*Cherchez dans la colonne '''Port''' le port qui vous intéresse (par exemple '''80''' pour le port standard du Serveur Web '''Apache2''' ou '''3306''' pour le Serveur de Bases de Données '''MariaDB''').

[[File:Ports d'écoute Windows.png|none|frame|Un programme "écoute" déjà sur le port '''80''', il s'agit de '''httpd.exe''' (c'est à dire '''Apache2''').|link=Special:FilePath/Ports_d'écoute_Windows.png]]
Si vous ne trouvez pas de ligne pour le numéro de port recherché, alors, c'est parfait (cela signifie qu'aucun programme n'écoute sur ce port et qu'il est donc disponible).

Si en revanche vous trouvez une correspondance, alors un programme écoute déjà sur ce port et vous devrez choisir un autre port d'écoute lors de l'installation de votre serveur.

====Choisir un autre port que le port par défaut 3306 pour MariaDB====
À la cinquième page de l'installeur '''MariaDB''', renseignez un autre port dans la case '''TCP port:''' (par exemple le '''3308''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus).

Suite à votre changement de port pour '''MariaDB''', lors de votre installation de Dolibarr, au moment de renseigner le port dans la section '''Base de données Dolibarr''', n'oubliez pas de renseigné le port de remplacement que vous avez choisi au lieu du port standard '''3306'''.

====Choisir un autre port que le port par défaut 80 pour Apache2====
Lors de la personnalisation du fichier de configuration de '''Apache2''', remplacez la ligne <code>ServerName localhost:80</code> par <code>ServerName localhost:<mon_port></code> pour spécifier un autre port (par exemple <code>ServerName localhost:8080</code> pour utiliser le port '''8080''' - mais assurez vous que le port que vous choisissez n'est pas déjà utilisé en utilisant la technique spécifié ci-dessus). Vous aurez également besoin de remplacer le <code>80</code>  de la ligne <code>Listen 80</code> : par le numéro de port que vous aurez choisi.

Suite au changement de port d'écoute, vous devrez spécifier le port dans les adresses que vous taperez dans votre navigateur : par exemple <code>http://localhost:8080</code>, <code>http://localhost:8080/test</code>, <code>http://localhost:8080/dolibarr</code>, etc. au lieu de <code>http://localhost</code>, <code>http://localhost/test</code>, <code>http://localhost/dolibarr</code>. 
<br />

*
*

===Comment gérer les "Services" Windows ?===
Nous avons vu dans cette documentation la création de "Services" Windows permettant de démarrer automatiquement le Système de Gestion de Bases de Données '''MariaDB''' et le Serveur Web '''Apache2''' au (re)démarrage de l'ordinateur.

Windows est livré avec une application permettant de gérer graphiquement les "Services". Il est ainsi possible de consulter leur statut (démarré, arrêté) et d'agir dessus (démarrer, arrêter, redémarrer).

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>services</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Services''').

[[File:Lancer l'application Windows Services.png|none|thumb|510x510px|Exécuter l'application '''Services''' de Windows|link=Special:FilePath/Lancer_l'application_Windows_Services.png]]

*Dans la liste des Services qui s'affichent, rechercher le Service pour lequel vous souhaitez consulter le statut ou effectuer une action (démarrage, arrêt, redémarrage). Cherchez par exemple '''MariaDB''' ou '''Apache2'''.

Dans la colonne '''État''', vous pouvez vérifier le statut actuel du Service (sur la capture d'écran ci-dessous, nous constatons que le service '''Apache2.4''' est '''En cours d'exécution''', c'est à dire qu'il est démarré).

*Effectuez un clic droit sur le Service à gérer pour afficher le menu contextuel puis sélectionnez l'action à effectuer (Démarrer, Arrêter ou Redémarrer).

[[File:Redémarrer Service Apache2.4 Windows.png|none|frame|Redémarrer le Service '''Apache2.4'''|link=Special:FilePath/Redémarrer_Service_Apache2.4_Windows.png]]
<br />
===Comment savoir si mon ordinateur exécute la version 32 bits ou 64 bits de Windows ?===

====Windows 10 et Windows 8.1====

#Sélectionnez le bouton '''Démarrer''',<span class="win-icon win-icon-WindowsLogo"></span> puis '''Paramètres''' ><span class="win-icon win-icon-Settings"></span> '''Système''' > <span class="win-icon win-icon-System"></span>'''À propos de'''.
#<span class="win-icon win-icon-Error"></span>Sur la droite, sous '''Spécifications de l’appareil''', consultez '''Type de système'''.

====Windows 7====

#Sélectionnez le bouton '''Démarrer'''<span class="ng-isolate-scope" asset="11899" contenteditable="false" props="{&quot;size&quot;:&quot;full&quot;}" readonly="true" unselectable="on"></span>, cliquez avec le bouton droit sur '''Ordinateur''', puis choisissez '''Propriétés'''.
#Sous '''Système''', consultez le type de système.

===Rappel des différents répertoires d'installation utilisés===
{| class="wikitable"
|+
!Composant/Logiciel
!Chemin d'installation
|-
|MariaDB
|<code>C:\Program Files\MariaDB 10.4</code>
|-
|Apache 2.4
|<code>C:\Apache24</code>
|-
|PHP
|<code>C:\php</code>
|-
|Dolibarr (programme)
|<code>C:\Apache24\htdocs\dolibarr</code>
|-
|Dolibarr (documents)
|<code>C:\dolibarr\documents</code>
|-
|Dolibarr (données)
|<code>C:\Program Files\MariaDB 10.4\data\dolibarr</code>
|}

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Les fichiers présents dans le répertoire <code>C:\Program Files\MariaDB 10.4\data\dolibarr</code> sont les fichiers physiques de la base de données. Sauvegarder ces fichiers ne vous permettra de les réutiliser qu'avec la même version de la base de données. Une façon plus robuste d'effectuer une sauvegarde de la base de données est de réaliser un export en utilisant par exemple l'utilitaire '''<code>mysqldump</code>'''.
</div>

===Comment sauvegarder mon installation manuelle===

Dans Dolibarr, trois choses sont importantes à sauvegarder :

*la base de données (MariaDB), qui contient toutes vos saisies (lignes de propositions commerciales, factures, etc.)
*le dossier <code>documents</code> qui contient les documents PDF générés par Dolibarr (propositions commerciales, factures, etc.) ainsi que ceux téléversés.
*le fichier de configuration <code>conf/config.php</code> qui contient les paramètres de connexion à votre base de données et d'autres informations de configuration.

====Sauvegarder la base de données====

Il existe plusieurs façons de sauvegarder la base de données.

=====Directement depuis Dolibarr=====

[[File:Sauvegarde de la base de données depuis Dolibarr.png|thumb|Sauvegarde de la base de données depuis Dolibarr|none|750x750px|link=Special:FilePath/Sauvegarde_de_la_base_de_données_depuis_Dolibarr.png]]

Une fois connecté à Dolibarr,

*Sélectionnez le menu '''Sauvegarde''' dans la rubrique '''Outils d'administration''',
*Dans '''Compression''', sélectionnez - pour plus de simplicité - '''Aucun''' (Windows n'intègre en effet pas en standard d'utilitaire permettant de dé-compresser les fichiers Gzip mais vous pouvez l'activer si vous disposez par exemple de 7-Zip, PeaZip, WinZip ou WinRar).
*Cliquez sur '''Générer Sauvegarde'''.

<br />[[File:Télécharger la sauvegarde de base de données.png|Télécharger la sauvegarde de base de données|none|frame|link=Special:FilePath/Télécharger_la_sauvegarde_de_base_de_données.png]]Une fois que la sauvegarde a été générée, vous pouvez la télécharger en cliquant sur le lien du fichier dans la section de droite '''Fichiers de sauvegarde de base de données existant'''

=====Manuellement en utilisant l'outil graphique HeidiSQL=====
Lors de l'installation du Système de Gestion de Bases de Données '''MariaDB''', l'outil graphique HeidiSQL a également été installé.

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>heidisql</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''HeidiSQL''').

[[File:Démarrer HeidiSQL.png|none|thumb|501x501px|Exécuter l'application '''HeidiSQL'''|link=Special:FilePath/Démarrer_HeidiSQL.png]]



Nous allons maintenant définir la connexion à notre Système de Gestion de Bases de Données '''MariaDB''' en utilisant les informations de connexion dont nous disposons.<gallery widths="750" heights="500">
File:Gestionnaire de sessions HeidiSQL.png|Cliquez sur '''Ajouter'''.
File:Paramétrages session HeidiSQL.png|Dans '''Utilisateur:''' saisissez '''root''' ; dans '''Mot de passe''', saisissez le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation). Dans '''Bases de données''', cliquez sur la flèche à droite du champ et sélectionnez '''dolibarr'''.
File:Renommer session HeidiSQL.png|Effectuez un clic droit sur l'élément '''Unamed*''' puis, dans le menu contextuel, sélectionnez '''Renommer'''.
File:Renommer session HeidiSQL 2.png|Saisissez un nom plus parlant pour le nom de session. Par exemple '''Dolibarr'''. Puis, cliquez sur '''Enregistrer'''. Cliquez ensuite sur '''Ouvrir'''.
</gallery>
[[File:Exporter la base de données HeidiSQL.png|none|frame|Exporter la base de données avec HeidiSQL|link=Special:FilePath/Exporter_la_base_de_données_HeidiSQL.png]]

*Effectuez un clic droit sur la base de données '''<code>dolibarr</code>''' et sélectionnez '''Exporter la base de données en SQL...'''

<br />
[[File:Paramétres d'export de base de données HeidiSQL.png|none|frame|Paramétrer l'export de la base de données dans '''HeidiSQL'''|link=Special:FilePath/Paramétres_d'export_de_base_de_données_HeidiSQL.png]]

*Cochez la case '''Retirer/DROP''' dans la section '''Table(s) :''' puis, dans '''Nom de fichier :''' choisissez le chemin où vous souhaitez exporter la sauvegarde et le nom du fichier. Si vous avez suivi l'ensemble de la documentation d'installation, un bonne pratique est de placer l'export au même endroit que lorsque vous le réalisez avec l'interface de Dolibarr (méthode du paragraphe ci-dessus) : <code>C:\dolibarr\documents\admin\backup\%db-%date.sql</code> . <code>%db</code> sera remplacé automatiquement par le nom de la base ('''<code>dolibarr</code>''') et <code>%date</code> par la date et l'heure de l'export.
*Cliquez sur '''Exporter''' pour lancer l'export.<br />

=====Manuellement en utilisant l'Invite de commandes Windows=====

*À côté du bouton Windows permettant d'ouvrir le menu démarrer, dans la zone de recherche "'''Taper ici pour rechercher'''", cliquez puis saisissez <code>mariadb</code>. Dans la liste des options proposées à droite, choisissez "'''Ouvrir'''" ou cliquez sur le titre complet de l'application pour la lancer ('''Command Prompt (MariaDB 10.4 (x64))''').

[[File:Démarrer Command Prompt (MariaDB 10.4 (x64)).png|none|thumb|550x550px|Exécuter l'application '''Command Prompt (MariaDB 10.4 (x64))''']]


L'invite de commandes se lance ; placez vous dans le répertoire des sauvegardes de base de données de '''Dolibarr''' (dans notre dossier <code>documents</code>) :<syntaxhighlight lang="batch">
cd C:\dolibarr\documents\admin\backup
</syntaxhighlight>Saisissez la commande suivante pour sauvegarder la base de données où <code>dolibarr-2020-05-20-14-30.sql</code> correspondra au nom du fichier exporté (vous pouvez bien entendu mettre ce que vous voulez) :<syntaxhighlight lang="batch">
mysqldump -u root -p --opt dolibarr > dolibarr-2020-05-20-14-30.sql
</syntaxhighlight>Vous devrez saisir le mot de passe de l'administrateur des bases de données que vous avez choisi lors de l'installation de MariaDB (écran 4 de l'assistant d'installation).

====Sauvegarder le dossier <code>documents</code> et le fichier de configuration <code>config.php</code>====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Directement depuis Dolibarr=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Explorateur de fichiers Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

====Restaurer une sauvegarde====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'outil graphique HeidiSQL=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

=====Manuellement en utilisant l'Invite de commandes Windows=====

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>

===Comment mettre à jour Dolibarr===

<div style="background-color: lightyellow; padding:10px;">
⚠️ '''<u>Attention !</u>''' Avant d'entreprendre une mise à jour, vous devriez TOUJOURS vous assurez que vous disposez d'une sauvegarde complète de Dolibarr au cas où vous effectueriez une mauvaise manipulation afin de pouvoir revenir à un état antérieur fonctionnel.
</div>

<div style="background-color: #DFF2FF; padding:10px;">
ℹ️ La rédaction de cette section n'est pas encore achevée. Revenez ultérieurement.
</div>