====== 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 [[http://www.wampserver.com/|site officiel]] et installez-le sur votre ordinateur. 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 [[.:install#installation-a-partir-du-fichier-config.php|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 [[https://www.mamp.info/fr/downloads/|MAMP]] qui procure un serveur Apache et un serveur MySQL complètement indépendant. 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. 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 [[https://www.mamp.info/fr/downloads/|MAMP]], puis installez le package [[http://sourceforge.net/project/showfiles.php?group_id=133151&package_id=146535|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). 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. 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 [[http://kent.dl.sourceforge.net/sourceforge/phppgadmin/phpPgAdmin-4.1-Beta-1.tar.gz|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** : //// 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 ===== 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 ==== 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((mais il est probable que, si vous les maîtrisez, ce tutoriel ne vous soit pas d’une grande utilité)). 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 : [[http://www.apachefriends.org/fr/xampp-linux.html|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 [[http://www.apache.org/|Apache]], un serveur de base de données [[http://www-fr.mysql.com/|MySQL]], les langages [[http://www.php.net/|PHP]] 4 et 5 (le 5, nécessaire pour Dotclear 2 est activé par défaut), [[http://www.phpmyadmin.net/home_page/index.php|phpMyAdmin]], ainsi que [[http://phpsqliteadmin.sourceforge.net/|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é ! » :-D ==== Préparer le serveur à « accueillir » Dotclear ==== === MySQL : activer InnoDB === 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 [[http://download.dotclear.net/latest-2.0.tar.gz|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 ! ;-)