Geekographie Maïeulesque

Gérer beaucoup de sites SPIP en local sous MacOsX

Maïeul — 2012-01-11T15:38:18Z

Cet article ne s'adresse pas aux SPIPeurs débutants qui souhaiteraient créer un site web en local sous Mac. Un article existe déjà sur le sujet. Non, cet article s'adresse aux personnes qui souhaitent gérer beaucoup de site web en local en n'ayant qu'une installation de SPIP par version, autrement dit en mutualisant le noyau de SPIP.

J'y détaille ma pratique, que j'utilise depuis trois ans, donc que j'estime mûre.

Principe

Je développe en local 30 sites. Chaque site que je développe possède une adresse réelle, par exemple http://maieul.net [1], correspondant à la version cours de production, et une adresse locale, correspondante à la version en cours de développement.

Par principe, chaque adresse d'un site local termine par .dev. Par exemple maieul.dev, geek.dev, maman.dev etc. Pourquoi .dev ? Parce que cette extension n'existe pas, donc je suis certain que lorsque j'utilise .dev je suis en version locale.

Je vais dire à mon ordinateur, via la modification d'un fichier caché, d'orienter mes adresses en .dev vers l'IP 127.0.0.1, autrement dit vers mon propre ordinateur.

Conséquent : lorsque dans mon navigateur je frapperais http://maieul.dev, celui-ci me redirigera vers 127.0.0.1. Là, mon serveur local, MAMP, me renverra vers mon SPIP, que j'aurais organisé selon le principe de la mutualisation facile, c'est à dire à que j'aurais réglé pour avoir un seul noyau SPIP pour plusieurs sites (par exemple maman.dev, papa.dev etc.)

Par ailleurs, un site fera exception localhost : ce site sert de brouillon pour toutes les expériences.

De plus, je souhaite pouvoir disposer de différentes branches de SPIP : je souhaite pouvoir orienter vers la branche 2.0.z ou vers la branche 2.1.z ou vers la branche 3.0.z selon le cas. En revanche, je souhaite pouvoir facilement mettre à jour une branche.

Je vais donc créer un dossier par branches, avec dans chaque dossier une mutualisation. Je configurerais mon serveur Apache local (installé via MAMP) pour qu'il me renvoi sur l'un ou l'autre des dossiers selon l'URL du site.

Bon, tout ceci c'était la théorie, passons à la pratique.

Cette pratique nécessite d'utiliser les Terminal, pour frapper quelques commandes.

Préparer les versions de SPIP

Dans le terminal, rendons-nous dans le dossier sites du répertoire de départ :

cd ~/sites

Puis récupérons les dernieres versions stables des différentes branches de SPIP. Ces versions sont situées dans le dossier tags du serveur SVN de SPIP.

svn co svn://trac.rezo.net/spip/tags/spip-2.0.9 SPIP 20 svn co svn://trac.rezo.net/spip/tags/spip-2.1.12 SPIP21

Et soyons fous, prenons même la dernière version de dev de SPIP, instable (pour le moment c'est SPIP 3)

svn co svn://trac.rezo.net/spip/spip SPIPdev

Je me retrouve donc dans mon dossier sites avec trois dossiers : SPIP20 SPIP21 et SPIPdev.

Par défaut mes sites pointeront vers SPIP21. Les autres sites seront des exceptions.

Préparer la mutualisation

Maintenant rendons-nous dans le dossier SPIP21 pour préparer le chemin à la mutualisation des sites SPIP.

cd ~/SPIP21

D'abord il faut récupérer le plugin mutualisation facile :

svn://zone.spip.org/spip-zone/_plugins_/mutualisation

Ensuite il me faut copier le fichier mes_options.php dans le dossier config.

cp mutualisation mes_options.php.txt mes_options.php

Puis ouvrir le fichier config/mes_options.php avec le logiciel de mon choix.

Il va falloir régler pour indiquer les réglages MySQL de Mamp.

Voici le contenu de ce fichier

 true */ # define ('_INSTALL_USER_DB_ROOT', 'mon_root'); # define ('_INSTALL_PASS_DB_ROOT', '********'); /* * Creer les bases de donnees via un ping sur une URL (methode AlternC) * * Il suffit de renseigner l'option url_creer_base, en lui passant les bons parametres : * 'url_creer_base' => 'https://bureau.tld/admin/sql_doadd.php?username=USER&password=PASS&dbn='.prefixe_mutualisation($site) */ /* * Transformer sur les pages publiques les url des images * /sites/mon_site/IMG/* -> /IMG/* * /sites/mon_site/local/* -> /local/* * * - Necessite le mod_rewrite (reecriture d'url) d'apache * - Ne fonctionne qu'avec des mutualisations de nom de domaine * ('http_host' : http://mon_site_mutu.tld) * (donc pas avec une mutualisation de repertoire - http://site/mon_spip_mutu/) * * et ajouter dans demarrer_site l'option * 'url_img_courtes' => true * * Il est possible de regenerer les fichiers .htaccess * crees automatiquement dans /IMG et /local * grace a ?var_mode=creer_htaccess_img * */ demarrer_site($site, array( 'creer_site' => true, // Creer ou non le site s'il n'existe pas (defaut: false) 'creer_base' => true, // Creer ou non la base de donnee si elle n'existe pas (false) 'creer_user_base' => false, // Creer ou non un utilisateur pour la nouvelle base de donnee (false) 'mail' => '', // Adresse mail pour recevoir un mail lors d'une creation de site mutualise ('') 'code' => 'ecureuil', // Code d'activation ('ecureuil') 'table_prefix' => false, // Definir automatiquement le prefixe de table (false) ... mettre true si tous les sites dans la meme base 'cookie_prefix' => true, // Definir automatiquement le prefixe de cookie (false) 'repertoire' => 'sites', // Nom du repertoire contenant les sites mutualises ('sites') 'url_img_courtes' => true, // Utiliser la redirection des URL d'images courtes dans la partie publique (false) // /!\ il faut qu'apache ait le droit d'ecrire dans les dossiers IMG/ et local/ a la racine du site ! // C'est la que la mutualisation va ecrire les regles de redirection automatiques pour les images de chaque site # 'utiliser_panel' => false, // Utiliser une table externe pour recuperer des identifiants ... (code, user, pass) permettant a un utilisateur d'installer le site (false) # 'annonce' => 'Un service proposé par la communauté SPIP
', // Texte a afficher en bas du formulaire d'activation de la mutualisation 'url_creer_base' => '' // Creer la base de donnees via une URL (methode AlternC) ) ); /* * Notes concernant SQLite * * 1) creer_base = false * Avec SQLite, il est inutile de mettre creer_base a true. * Si creer_base est true, une base sera cree (par l'outil de mutualisation) * dans le repertoire defini par la constante _DIR_DB. * * Si cette constante n'est pas renseignee, elle vaudra * _DIR_ETC/bases/ soit : config/bases/, ce qui ne correspond pas * a l'emplacement du futur site : sites/X/config/bases. * * En laissant l'option a false, SPIP creera la base de donnee * au moment de l'installation (exec=install) et a ce moment * la, _DIR_ETC vaudra 'sites/X/config' donc la base sera stockee * ou il faut si _DIR_DB n'est pas defini. * * 2) creer_user_base = false * SQLite ne gerant pas de droits d'utilisateurs, * (les droits sont ceux du fichier .sqlite) * mettre true provoquera des erreurs (je suppose) * * 3) constantes a definir : * define ('_INSTALL_SERVER_DB', 'sqlite3'); // sqlite2 ou sqlite3 * define ('_INSTALL_NAME_DB', 'mu_'.prefixe_mutualisation($site)); * * les constantes _INSTALL_(HOST|PASS|USER)_DB sont inutiles. */ /* * Notes concernant MySQL * * - Pour la creation d'utilisateurs MYSQL * (creer_base+creer_user_base) * il est possible de definir les droits de ces utilisateurs avec la constante * _PRIVILEGES_MYSQL_USER_BASE (ici avec les valeurs utilisees par defaut) : * * define('_PRIVILEGES_MYSQL_USER_BASE','Alter, Select, Insert, Update, Delete, Create, Drop'); * */ ?>

Les lignes à changer sont les lignes en mettant 44 et 45 :

 define ('_INSTALL_USER_DB', 'root'); define ('_INSTALL_PASS_DB', 'root');

Il nous reste ensuite à créer un répertoire sites :

mkdir sites

Affinage

Comme je suis sur un site local, donc de dev, je ne veux pas de cache. Je met donc dans le fichier mes_options.php la ligne suivante :

define('_NO_CACHE',-1);

Dans le dossier extensions, je peux mettre tout les plugins que je souhaite actifs automatiquement pour l'ensemble des sites. Dans le dossier plugins, je met les plugins qui ne sont pas automatiquement actif.

Répétition pour les autres versions de SPIP

Il me faut installer la mutualisation dans chaque dossier correspondant à chaque version de SPIP.

Installation et Configuration de Mamp

Tout d'abord, vérifier dans les Préférences Système que le partage web n'est pas activé. Puis télécharger MAMP et l'installer.

Ouvrir MAMP dans le dossier MAMP du dossier Application.

Dans les réglages, aller dans ports, et mettre le port Apache sur 80.

Ensuite comme je ne désire pas renvoyer mes sites systématiquement vers le même dossier, il va falloir faire une intervention à la main dans les fichiers de MAMP.

Ouvrir le dossier /Applications/MAMP/conf/Apache et faire une copie de sécurité du fichier httpd.conf.

Puis l'ouvrir avec un éditeur de texte.

Chercher les lignes où il est écrit :

# MAMP DOCUMENT_ROOT !! Don't remove this line !! DocumentRoot "/Applications/MAMP/htdocs"

Et faire exactement ce qu'il est dit de ne pas faire, en remplacant DocumentRoot "/Applications/MAMP/htdocs" par Include /Applications/MAMP/conf/Apache/vhost.conf

Par cela, je signale que je veux que la gestion des dossiers se fasse dans un fichier vhost.conf du dossier /Applications/MAMP/conf/Apache/.

Je crée ce fichier. Voici ce que j'y met :

 DocumentRoot "/Users/maieul/Sites/SPIP21"

Évidemment, il faut remplacer maieul par le nom de votre dossier de départ.

Cela indique que par défaut, mes sites locaux correspondent au dossier /Users/maieul/Sites/SPIP21 de mon ordinateur. Donc mes sites sont créés par défaut avec SPIP 2.1

En revanche, si je souhaite que le site toto.dev soit en SPIP 2.0, je met en dessous de ces lignes :

 DocumentRoot "/Users/maieul/Sites/SPIP20" ServerName toto.dev

Et ainsi de suite pour chaque site ne fonctionnant pas avec SPIP 2.1.

Rediriger le site bidule.dev vers 127.0.0.1

Bon, maintenant je peux lancer mon site bidule.dev Pour ce faire, je vais modifier le fichier /etc/hosts, qui indique les redirections des adresses web, propres à mon ordinateur. Pour ce faire, dans le terminal je frappe :

sudo pico /etc/hosts

Après la saisie de mon mot de passe administrateur, avec le clavier je me rend sur juste avant la ligne 255.255.255.255 broadcasthost, et j'insére la ligne suivante :

127.0.0.1 toto.dev

J'enregistre en frappant ctrl + X À chaque fois que je voudrais créer un nouveau site local, je ferais de même.

Lancement du site

Aller, on y va ! Dans la barre d'adresse du navigateur, j'écris http://toto.dev.

Je me retrouve alors sur la page me demandant le mot de passe de la mutualisation.

Comme je ne l'ai pas modifié, c'est facile : ecureuil. Je le rentre donc, et je clique sur ok.

Je passe ensuite les étapes suivantes, qui sont automatiques.

Vient ensuite l'habituel formulaire de création des comptes sur SPIP, que je remplis comme d'habitude :

Et voilà mon site lancé.

Particularité de la mutualisation

Chaque sites possèdent un dossier propre dans le dossier sites. Dans chaque dossier de sites se trouvent les habituelles dossiers config ; IMG ; local ;tmp et éventuellement squelettes.

Mise à jour mineure de SPIP

Imaginons que la version 2.1.13 de SPIP sorte.

Pour faire ma mise à jour en local, c'est simple.

1. D'abord se rendre dans le dossier avec le terminal

cd ~/sites/SPIP21

2. Ensuite mettre à jour

svn switch svn://trac.rezo.net/spip/tags/spip-2.1.12

Comme d'habitude, j'attends les réactions des SPIPeurs.

Voici quelques liens utiles :

initiation au terminal
le fichier hosts
la mutualisation facile avec SPIP
les Virtualhost d'Apache
Deux articles d'Alexandra qui expliquent comment ouvrir sur l'exterieur son Mac et comment envoyer des mails avec SPIP en local
La même problématique, mais sous Windows.

[1] Je sais, c'est un peu narcissique, mais que voulez-vous…

Gérer un SPIP mutualisé avec SSH et SVN

Maïeul — 2010-12-05T21:35:14Z

Pourquoi installer trois fois SPIP lorsqu'on a trois sites chez le même hébergeur ? Pourquoi ne pas garder un seul noyau qui servirait aux trois sites ? Voici un petit tutorial sur :

utiliser ssh et svn chez un hébergeur
mutualiser un site SPIP.

Ce tutoriel explique comment j'ai pratiqué chez l'Autre.net pour avoir un site mutualisé.

Définition

SSH est un protocole qui permet d'exécuter des lignes de commandes sur un ordinateur distant, via internet, et ce de manière sécurisé.

SVN est un système de gestion de versions de code sources. C'est celui utilisé par SPIP.

Un SPIP mutualisé, c'est la possibilité d'avoir une seul fois le code de SPIP pour plusieurs sites chez le même hébergeur.

Ce qu'on cherche à faire

Avoir un SPIP mutualisé.
Pouvoir facilement le mettre à jour.

Interêt

La mutualisation permet un gain de place et de temps lors des mises à jour de SPIP : un seul SPIP à mettre à jour.

L'accès SSH évite d'avoir à passer par FTP depuis votre ordinateur, et donc de subir la lenteur des connexions sortantes proposés en ADSL.

Préalable

Il est nécéssaire de pouvoir faire du SSH. Sur mac / linux, il faut utiliser le terminal ou l'invite de commande. Sous Windows il faut un logiciel spécifique. Voir le tutoriel de l'Autre.net.

Tout les hébergeurs ne proposent pas d'accès SSH, car cela pose des problèmes en termes de sécurité. L'Autre.net en plus d'être un Alter-Hébergeur le permet. Tant mieux ! [1]

Tout les hébergeurs proposant SSH ne proposent pas forcément SVN. Si c'est le cas du votre, négociez avec lui. Et si vous échouez, ce tutoriel vous sera inutile.

J'ai trois site :

bidule.tld
truc.tld
machin.tld

Il est nécessaire de régler les DNS pour qu'ils pointent sur le même hébergeur, puis chez l'hébergeur, il faut que chaque domaine pointent vers le même répertoire.

Voir avec l'hébergeur pour cela.

J'imagine ici que mes trois domaines sont réglés pour accéder au répertoire spip_mutu.

Se connecter via SSH

Dans le terminal [2], taper [3] :

% ssh login@adresse

Le login et l'adresse ssh sont fournis par l'hébergeur.

A l'invitation, taper votre mot de pass SSH.

Désormais, tout ce que vous frapperez sera exécuté sur le serveur de votre hébergeur. Donc attention !

Récuperer le code de SPIP

Tout d'abord, se déplacer dans le dossier spip_mutu :

% cd spip_mutu

Il existe sur le serveur SVN de SPIP un dossier tags qui contient des « instanés » des version de SPIP. En gros, il contient les versions distribuées sur SPIP.net.

Récuperons cela par SVN. Ici la version 2.1.2

% svn co svn://trac.rezo.net/spip/tags/spip-2.1.2 .

! Attention, ne pas oublier le point final. Il permet que le contenu du dossier spip-2.1.2 soit mis directement dans le dossier courant.

Le jour où SPIP passera en 2.1.3, il suffira de faire

% svn switch svn://trac.rezo.net/spip/tags/spip-2.1.3

qui basculera seulement les fichiers modifiés entre la 2.1.2 et la 2.1.3

Récuperer le gestionaire de mutualisation

Il existe un pseudo-plugin SPIP qui permet de gérer un SPIP mutualisé. Récuperons le

% svn co svn://zone.spip.org/spip-zone/_plugins_/mutualisation

Il faut ensuite créer un dossier sites, dans lequel chaque site aura un dossier spécifique. Pour cela :

% mkdir sites

Installer les plugins

La plupart des plugins SPIP sont dévellopés sur la SPIP-Zone, en SVN. Trouvez ici la liste : http://zone.spip.org/trac/spip-zone/browser/_plugins_/, et les squelettes sont par là http://zone.spip.org/trac/spip-zone/browser/_squelettes_

Créons notre dossier plugins, puis allons y.

% mkdir plugins
% cd plugins

Maintenant récuperons les plugins qui nous intéresse

% svn co svn://zone.spip.org/spip-zone/_plugins_/dossierduplugin

ou dossierduplugin est à remplacer à chaque fois par le dossier du plugin qui nous intéresse.

Lorsqu'on voudra mettre à jour un plugin, on fera

%svn up dossierduplugin

Configurer la mutalisation

Tout d'abord retournons à la racine de notre site

% cd ..

Puis copions le fichier mes_options.php.txt dans le dossier config de SPIP, en le renommant.

% cp mutualisation/mes_options.php.txt config/mes_options.php

éditons avec pico le fichier copié

% pico config/mes_options.php

Voici le fichier tel que livré aujourd'hui :

 true */ # define ('_INSTALL_USER_DB_ROOT', 'mon_root'); # define ('_INSTALL_PASS_DB_ROOT', '********'); /* * Creer les bases de donnees via un ping sur une URL (methode AlternC) * * Il suffit de renseigner l'option url_creer_base, en lui passant les bons parametres : * 'url_creer_base' => 'https://bureau.tld/admin/sql_doadd.php?username=USER&password=PASS&dbn='.prefixe_mutualisation($site) */ /* * Transformer sur les pages publiques les url des images * /sites/mon_site/IMG/* -> /IMG/* * /sites/mon_site/local/* -> /local/* * * - Necessite le mod_rewrite (reecriture d'url) d'apache * - Ne fonctionne qu'avec des mutualisations de nom de domaine * ('http_host' : http://mon_site_mutu.tld) * (donc pas avec une mutualisation de repertoire - http://site/mon_spip_mutu/) * * et ajouter dans demarrer_site l'option * 'url_img_courtes' => true * * Il est possible de regenerer les fichiers .htaccess * crees automatiquement dans /IMG et /local * grace a ?var_mode=creer_htaccess_img * */ /* * Inscrire ici le nom du site d'administration du tableau de bord * de la mutualisation (ou plusieurs, separes par des virgules) * (dans cet exemple, 'scriibe.net' est le top level domain, TLD) * pour autoriser tous les sites, ne pas definir la constante ; * Si le site maitre n'est pas dans sites/ mais a la racine, mettre '' * et ajouter 'mutualisation' dans $dossier_squelettes */ define ('_SITES_ADMIN_MUTUALISATION', 'scriibe.net'); demarrer_site($site, array( 'creer_site' => true, // Creer ou non le site s'il n'existe pas (defaut: false) 'creer_base' => true, // Creer ou non la base de donnee si elle n'existe pas (false) 'creer_user_base' => false, // Creer ou non un utilisateur pour la nouvelle base de donnee (false) 'mail' => '', // Adresse mail pour recevoir un mail lors d'une creation de site mutualise ('') 'code' => 'ecureuil', // Code d'activation ('ecureuil') 'table_prefix' => false, // Definir automatiquement le prefixe de table (false) ... mettre true si tous les sites dans la meme base 'cookie_prefix' => true, // Definir automatiquement le prefixe de cookie (false) 'repertoire' => 'sites', // Nom du repertoire contenant les sites mutualises ('sites') 'url_img_courtes' => true, // Utiliser la redirection des URL d'images courtes dans la partie publique (false) // /!\ il faut qu'apache ait le droit d'ecrire dans les dossiers IMG/ et local/ a la racine du site ! // C'est la que la mutualisation va ecrire les regles de redirection automatiques pour les images de chaque site # 'utiliser_panel' => false, // Utiliser une table externe pour recuperer des identifiants ... (code, user, pass) permettant a un utilisateur d'installer le site (false) # 'annonce' => 'Un service proposé par la communauté SPIP', // Texte a afficher en bas du formulaire d'activation de la mutualisation 'url_creer_base' => '' // Creer la base de donnees via une URL (methode AlternC) ) ); /* * Notes concernant SQLite * * 1) creer_base = false * Avec SQLite, il est inutile de mettre creer_base a true. * Si creer_base est true, une base sera cree (par l'outil de mutualisation) * dans le repertoire defini par la constante _DIR_DB. * * Si cette constante n'est pas renseignee, elle vaudra * _DIR_ETC/bases/ soit : config/bases/, ce qui ne correspond pas * a l'emplacement du futur site : sites/X/config/bases. * * En laissant l'option a false, SPIP creera la base de donnee * au moment de l'installation (exec=install) et a ce moment * la, _DIR_ETC vaudra 'sites/X/config' donc la base sera stockee * ou il faut si _DIR_DB n'est pas defini. * * 2) creer_user_base = false * SQLite ne gerant pas de droits d'utilisateurs, * (les droits sont ceux du fichier .sqlite) * mettre true provoquera des erreurs (je suppose) * * 3) constantes a definir : * define ('_INSTALL_SERVER_DB', 'sqlite3'); // sqlite2 ou sqlite3 * define ('_INSTALL_NAME_DB', 'mu_'.prefixe_mutualisation($site)); * * les constantes _INSTALL_(HOST|PASS|USER)_DB sont inutiles. */ /* * Notes concernant MySQL * * - Pour la creation d'utilisateurs MYSQL * (creer_base+creer_user_base) * il est possible de definir les droits de ces utilisateurs avec la constante * _PRIVILEGES_MYSQL_USER_BASE (ici avec les valeurs utilisees par defaut) : * * define('_PRIVILEGES_MYSQL_USER_BASE','Alter, Select, Insert, Update, Delete, Create, Drop'); * */
?>

par mesure de sécurité, on veut qu'à chaque nouveau site les logins/mdp mysql soient demandés. On veut également que le webmestre crée à la main le dossier du site (voir plus bas).

Donc il faut supprimer les lignes suivantes :

define ('_INSTALL_SERVER_DB', 'mysql'); define ('_INSTALL_HOST_DB', 'localhost'); define ('_INSTALL_USER_DB', 'loginsql'); define ('_INSTALL_PASS_DB', '123456HDJ'); define ('_INSTALL_NAME_DB', 'mu_'.prefixe_mutualisation($site));

et également remplacer les lignes suivantes

 'creer_site' => true, // Creer ou non le site s'il n'existe pas (defaut: false) 'creer_base' => true, // Creer ou non la base de donnee si elle n'existe pas (false)

par

 'creer_site' => false, // Creer ou non le site s'il n'existe pas (defaut: false) 'creer_base' => false, // Creer ou non la base de donnee si elle n'existe pas (false)

Et puis remplacer « ecureuil » par un autre mot de passe.

Créer les dossier des sites

Chaque site aura un dossier à lui dans le dossier sites. Ce dossier sera l'url du site, sans le http://www. Comme nous voulons les créez nous même, et non pas confier la tâche à SPIP, il faut faire cela, dans notre cas :

% mkdir sites/bidule.tld
% mkdir sites/truc.tld
% mkdir sites/machin.tld

Chacun de ces sous dossiers contiendra les dossiers tmp IMG, local,config spécifique au site.

Renommer le fichier .htacesss

Pour utiliser la réécriture d'URL et les URLs propres de SPIP, il faut faire :

% mv htaccesss.txt .htaccess

afin de renommer le fichier htaccess.tex en fichier .htaccess.

! Attention : la réécriture d'url via .htaccess ne fonction que sur les serveurs Apache. C'est pourquoi, si vous n'êtes pas sous Apache, dans le fichier mes_options.php cités plus haut, changer la ligne suivante

'url_img_courtes'=>true,

par

'url_img_courtes'=>false,

Se déconnecter du SSH

Ca y est, tout les fichiers sont biens en place chez l'hébergeur. Pour quitter l'accés SSH :

% logout

Configurer chaque site

Il suffit désormais de vous rendre sur http://machin.tld pour configurer le site machin.tld, comme vous le feriez à l'install de n'importe quel site SPIP. Il faudra simplement donner le mot de passe que vous avez réglé dans le fichier mes_options.php

[1] Toutefois il est nécessaire d'activer l'accès SSH depuis le panneau de configuration de votre compte sur l'Autre, et ce pour une durée de quatre heures.

[2] pour les windowsien, voir le tutoriel de l'Autre.net.

[3] le % représente l'invite de commande.