Table des matières

Installer en local

Windows

Pour installer Dotclear en local, il faut disposer :

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

Attention :

WampServer ne fonctionne pas avec Windows 98 ni Me, il faut disposer de XP ou Vista.

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. 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 l'assistant :

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

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

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.

Installation à partir du fichier config.php :

Vous pouvez faire l'installation en renommant le fichier inc/config.php.in en config.php et y entrer les informations suivantes : 

// Database driver (mysql, pgsql, sqlite)
define('DC_DBDRIVER','mysql');
 
// Database hostname (usually "localhost")
define('DC_DBHOST','localhost');
 
// Database user
define('DC_DBUSER','root');
 
// Database password
define('DC_DBPASSWORD','');
 
// Database name
define('DC_DBNAME','test');
 
// Tables' prefix
define('DC_DBPREFIX','dc_');
 
// Crypt key (password storage)
define('DC_MASTER_KEY','lemotdepasse');
 
 
// Admin URL. You need to set it for some features.
define('DC_ADMIN_URL','admin');
 
// Cookie's name
define('DC_SESSION_NAME','dcxd');
 
// Plugins root
define('DC_PLUGINS_ROOT',dirname(__FILE__).'/../plugins');
 
// Template cache directory
define('DC_TPL_CACHE',dirname(__FILE__).'/../cache');

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

Mac OS X

Pré-requis

Installation

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.

Si vous souhaitez utiliser une base de données PostgreSQL, il suffit d'installer 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 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. Le package MAMP intègre phpMyAdmin qui vous permet de gérer les bases MySQL. Pour les bases PostgreSQL vous pouvez télécharger et installer phpPgAdmin .

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

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 :

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.

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 pointues1).

Le plus simple est 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-1.5.5a.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

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é ! » :-D

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 vim /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.0-beta6.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/lamp/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 et l'emplacement du dossier temporaire.

Normalement, en cliquant sur « Enregistrer », vous passez à la page suivante et n'avez plus qu'à remplir « Email », « Nom » et « Prénom ».

Avec XAMPP, aucun serveur d'envoi de courrier n'est activé, en conséquence, la page suivante affiche un nom de connexion par défaut et le mot passe associé, avec un lien pour se connecter.

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

1) mais il est probable que, si vous les maîtrisez, ce tutoriel ne vous soit pas d'une grande utilité