Installer en local

Windows

Pour installer Dotclear en local, il faut disposer :

d’un serveur Apache
d’une base de données MySQLi
du support de PHP

Le logiciel WampServer permet d’installer un environnement complet comportant ces pré-requis.

Téléchargez le logiciel sur le site officiel et installez-le sur votre ordinateur.

Note :

L’installation de WampServer est compacte : tous les fichiers nécessaires sont copiés dans le dossier d’installation, par défaut wamp à la racine du disque de démarrage. Vous pouvez sans souci placer ce dossier ailleurs au moment de l’installation.

Dotclear 2 doit ensuite être téléchargé, décompressé et copié dans le dossier racine du serveur (dossier www dans le dossier wamp). Il peut-être utile de créer un dossier spécifique (par exemple dotclear) dans www, si vous souhaitez tester en local d’autres scripts ou une autre installation de Dotclear.

Une fois ces opérations effectuées, démarrez WampServer. Une icône apparaît dans la zone de notification (en bas à droite), et vous avise que les services (Apache et MySQL) sont lancés.

Vous devrez ensuite créer une base de données. Vous pouvez le faire avec phpMyAdmin par le menu que WampServer ajoute à la zone de notification : une fois connecté à phpMyAdmin, entrez le nom voulu pour la base dans le champ approprié, puis choisissez l’interclassement utf8_unicode_ci (ou utf8mb4 pour disposer des derniers emojis). Un message vous confirme que la base a bien été créée. Pour la suite de cet exemple, le nom choisi pour la base est test.

Installation

Avec votre navigateur, allez à l’adresse : http://localhost/dotclear/admin/install/wizard.php

Les paramètres nécessaires pour la configuration seront les suivants :

Type de base de données : MySQLi (ou MySQLi (Full UTF-8) selon le choix que vous aurez fait lors de la création de la base de données.
Nom d’hôte de la base de données : localhost
Nom de la base de données : test (ou le nom de la base que vous avez créée éventuellement)
Nom d’utilisateur de la base de données : root
Mot de passe de la base de données : laisser vide
Prefixe des tables de la base de données : dc_ par défaut, vous pouvez le modifier.

Appuyez sur "Enregistrer", remplissez vos coordonnées (mail, nom, prénom) puis, dans l’écran suivant, notez l’identifiant et le mot de passe qui vous sont donnés, et connectez vous.

Vous pouvez aussi préférer faire une installation à partir du fichier config.php, puis avec votre navigateur, aller à l’adresse : http://localhost/dotclear/admin/install.

Mac OS X

Pré-requis

serveur Apache
serveur MySQLi ou PostgreSQL

Installation

Apache + MySQLi

Le plus simple est d’installer le package MAMP qui procure un serveur Apache et un serveur MySQL complètement indépendant.

Note :

Le répertoire racine du serveur Apache intégré à MAMP est intitulé htdocs et se trouve dans le dossier MAMP. Cet emplacement peut être modifié via les préférences de MAMP.

Note :

Le serveur Apache est accessible, une fois lancé, à cette adresse : http://localhost:8888/.

Une fois l’installation des serveurs effectuées, il faudra créer une base de données encodée en UTF-8 (choisir l'encodage utf8-general-ci). Le package MAMP intègre phpMyAdmin qui vous permet de gérer les bases MySQL.

Dotclear 2 doit ensuite être téléchargé et installé dans le répertoire racine du serveur (dossier htdocs) ou dans un répertoire créé pour l’occasion. Les paramètres nécessaires pour la configuration seront les suivants :

Base de données MySQL
- host : localhost:8889
- user : root
- password : root

Apache + PostgreSQL

Installez MAMP, puis installez le package PostgreSQL Unified Installer (la version 8.1.5b a été testée avec MacOSX 10.3.9). Vous allez récupérer tout ce qu’il faut pour installer le serveur et quelques outils (contrôle du serveur, création de bases et d’utilisateurs). L’installation se fait de manière classique sur Mac OS X en double-cliquant sur le package PostgreSQL.mpkg (situé dans le dossier Serveur de l’image disque une fois montée).

Note :

Le répertoire racine du serveur Apache intégré à MAMP est intitulé htdocs et se trouve dans le dossier MAMP. Cet emplacement peut être modifié via les préférences de MAMP.

Note :

Le serveur Apache est accessible, une fois lancé, à cette adresse : http://localhost:8888/.

Pour gérer les bases PostgreSQL via une interface web (à l'image de phpMyAdmin pour les bases MySQL) vous pouvez télécharger et installer phpPgAdmin .

Les paramètres à utiliser pour la configuration de phpPgAdmin sont les suivants :

host : localhost
port : 5432
defaultdb : postgres
pg_dump_path : /Library/PostgreSQL8/bin/pg_dump
pg_dumpall_path : /Library/PostgreSQL8/bin/pg_dumpall

Dotclear 2 doit ensuite être téléchargé et installé dans le répertoire racine du serveur (dossier htdocs) ou dans un répertoire créé pour l’occasion. Les paramètres nécessaires pour la configuration seront les suivants :

Base de données PostgreSQL
- host : localhost:5432
- user : postgres
- password : <vide>

Astuce :

Si vous souhaitez gérer deux installations concurrentes de Dotclear, il est conseillé de donner un nom différent à chaque cookie de session (fichier inc/config.php). Ceci permet d’ouvrir les sessions d’administration simultanément.

Linux

Attention :

Ce tutoriel n’est pas adapté à une solution d’hébergement personnelle avec Linux d’un ou plusieurs blogs Dotclear, mais uniquement destiné à un usage de tests locaux avant ou en parallèle à une mise en ligne chez un hébergeur tiers. Par ailleurs, notamment dans un objectif de simplification, le tutoriel ne concerne qu’une installation avec MySQL. Rassurez-vous toutefois, si votre hébergeur propose une base PostgreSQL, vous pourrez sans peine réimporter les données créées localement via l’import/export texte.

Installer un serveur

Note :

Toutes les distributions Linux possèdent normalement les paquetages nécessaires à l’installation d’un serveur Apache parfaitement fonctionnel, avec toutes sortes de modules, et des possibilités de configuration tout à fait pointues¹⁾.

Pour ne pas détailler les installations propre à chaque distribution, nous avons choisi de télécharger un serveur « prêt à l’emploi », conçu pour les tests : XAMPP. Celui-ci n’offre pas la sécurité d’un serveur « en production » mais tout tient dans seule archive !

XAMPP va en effet installer : un serveur web Apache, un serveur de base de données MySQL, les langages PHP 4 et 5 (le 5, nécessaire pour Dotclear 2 est activé par défaut), phpMyAdmin, ainsi que phpSQLiteAdmin et toutes les bibliothèques nécessaires à leur fonctionnement. Ce qui tient dans une archive d’environ 50 Mo.

Une fois téléchargée, vous décompactez l’archive, comme indiqué sur le site, dans le dossier /opt, d’un simple

sudo tar xzf xampp-linux-x.x.x.tar.gz -C /opt

Ensuite, vous pouvez démarrer le serveur :

sudo /opt/lampp/lampp start

et prendre deux minutes pour définir les mots de passe (sécurité de base) :

sudo /opt/lampp/lampp security

Pour que Xampp se lance au démarrage, il suffit d’exécuter les commandes suivantes dans un terminal:

sudo ln -s /opt/lampp/lampp /etc/rc2.d/S99lampp

sudo ln -s /opt/lampp/lampp /etc/rc1.d/K02lampp

Vérifiez enfin dans votre navigateur favori l’adresse http://localhost/ ou http://127.0.0.1/

Si une jolie page s’affiche, tout va bien. Sinon, vous avez manqué une des opérations précédentes

Et après, on trouve des gens pour dire pour dire que « Linux, c’est compliqué ! »

Préparer le serveur à « accueillir » Dotclear

MySQL : activer InnoDB

Important :

Dotclear 2 a besoin que MySQL utilise InnoDB pour pouvoir fonctionner : il va donc falloir l’activer, ce qu’il n’est pas par défaut dans XAMPP.

Rien de bien compliqué : ouvrez le fichier de configuration dans votre éditeur de texte préféré (avec les privilèges administrateur)

sudo nano /opt/lampp/etc/my.cnf

Cherchez les lignes suivantes :

# Comment the following line to unskip and use InnoDB
skip-innodb

et commentez comme l’indique la première ligne, ce qui doit vous donner

# Comment the following line to unskip and use InnoDB
#skip-innodb

N’oubliez pas d’enregistrer vos modifications et redémarrez le serveur :

sudo /opt/lampp/lampp restart

MySQL : créer la base de données

Connectez-vous à phpMyAdmin en tant que root (avec le mot de passe précédemment défini pour MySQL avec lampp security ou en laissant vide si vous n’avez peur de rien et n’avez pas réglé la sécurité) : http://localhost/phpmyadmin/

Dans la colonne de gauche de la zone principale apparaît un titre « créer une base de données ». Entrez le nom de la nouvelle base (dotclear, par exemple) puis choisissez l’interclassement utf8_unicode_ci. Vous pouvez enfoncer le bouton « créer ». Nous en avons fini avec phpMyAdmin

Placer l’archive de Dotclear

Téléchargez la dernière version de Dotclear 2, puis extrayez-la dans le dossier htdocs de l’installation XAMPP :

sudo tar xzf dotclear-2.x.x.tar.gz -C /opt/lampp/htdocs/

Puis autorisez tout le monde à lire-écrire-exécuter (il s’agit d’une installation locale, où vous ne risquez, par conséquent, pas grand-chose) :

 sudo chmod -R 777 /opt/lampp/htdocs/dotclear/

et nous voilà prêts à lancer le wizard.

Configuration initiale Dotclear 2

Retour dans le navigateur : http://localhost/dotclear/admin/install/wizard.php

Choisissez MySQL en « Type de base de données », rentrez localhost en « Nom d’hôte de la base de données », dotclear en « nom de la base de données », root en « Nom d’utilisateur de la base de données », rentrez le mot de passe défini pour MySQL lors de la mise en sécurité de XAMPP pour « Mot de passe de la base de données » et laissez inchangé le préfixe.

Normalement, en cliquant sur « Enregistrer », vous passez à la page suivante et n’avez plus qu’à vos coordonnées.

Dotclear est tout à vous pour tous les tests locaux que vous souhaiterez lui faire subir. À vous de jouer !

¹⁾ mais il est probable que, si vous les maîtrisez, ce tutoriel ne vous soit pas d’une grande utilité