Gérer beaucoup de sites SPIP en local sous MacOsX

mercredi 11 janvier 2012, mise à jour lundi 31 août 2015, par Maïeul
RSS 2.0 Forum

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

<?php

	/*
	 * 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');

	if (!defined("_ECRIRE_INC_VERSION")) return;
	if (!is_readable (_DIR_RACINE.'mutualisation/mutualiser.php')) {
		echo _L("Fichier 'mutualisation/mutualiser.php' manquant dans la racine " . _DIR_RACINE);
		exit;
	}
	require _DIR_RACINE.'mutualisation/mutualiser.php';

	/* placer dans ce tableau les sites ou l'on ne veut pas la redirection canonique */ 
	$www = array();
	
	$site = str_replace('www.', '', $_SERVER['HTTP_HOST']);
	if ($site != $_SERVER['HTTP_HOST'] AND !in_array($site, $www)) {
		include_spip('inc/headers');
		$req = isset($_SERVER['REQUEST_URI']) ? $_SERVER['REQUEST_URI'] : '/';
		if (isset($_SERVER['HTTPS']) 
		AND test_valeur_serveur($_SERVER['HTTPS']))
			$protocole = 'https';
		elseif (!isset($_SERVER["SCRIPT_URI"]) OR !($p = strpos($_SERVER["SCRIPT_URI"], '://')))
			$protocole = 'http';
		else $protocole = substr($_SERVER["SCRIPT_URI"],0,$p);
		redirige_par_entete($protocole . '://' . $site . $req);
	}

	// Compatibilite avec le ":" de $dossier_squelettes
	// Si l'url indique explicitement un port (grace a ":")
	// tout eliminer s'il s'agit du port 80
	// et remplacer ":" par _ pour les autres ports

	if (strpos($site, ':')) {
		if (preg_match('/:80$/', $site)) $site = substr($site,-3);
		else $site = str_replace(':', '_', $site);
	}

	define ('_INSTALL_SITE_PREF', prefixe_mutualisation($site));
	define ('_INSTALL_NAME_DB', 'mu_'. _INSTALL_SITE_PREF);

	define ('_INSTALL_SERVER_DB', 'mysql'); 
	define ('_INSTALL_HOST_DB', 'localhost'); 
	define ('_INSTALL_USER_DB', 'loginsql');  
	define ('_INSTALL_PASS_DB', '123456HDJ'); 
	
	/* mettre en commentaire la ligne suivante si vous utilisez l'option table_prefixe plus bas dans la config */ 
	define ('_INSTALL_TABLE_PREFIX', 'spip');

	/* 
	 * Si le nom du serveur est different du nom dns, 
	 * ca peut parfois poser probleme
	 * il faut alors le definir ici
	 */
	# define ('_INSTALL_HOST_DB_LOCALNAME', 'nom_serveur');
	
	/* 
	 * Si le serveur n'est pas mysql, il faut le preciser obligatoirement.
	 * # define ('_INSTALL_SERVER_DB', 'pg'); // mysql|pg|sqlite2|sqlite3
	 * 
	 * /!\ En PG, il est conseille d'utiliser la creation d'utilisateur SQL
	 */
	
	/*
	 * Creer automatiquement les users SQL (pg|mysql)
	 * 
	 * Cela permet 
	 * - d'avoir un utilisateur root possedant les droits 
	 * de creation de bases (cet utilisateur possedant obligatoirement 
	 * une base a son nom en PG - PG ne se connecte pas sans donner un nom de bdd)
	 * - de creer des utilisateurs sql automatiquement 
	 * ne possedant que les droits d'administation 
	 * de leur base de donnee qui sera creee
	 * 
	 * Il faut remplacer alors 
	 * _INSTALL_(USER|PASS)_DB par _INSTALL_(USER|PASS)_DB_ROOT
	 * 
	 * et ajouter dans demarrer_site l'option
	 * 'creer_user_base' => 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' => '<p>Un service propos&eacute; par <a href="http://www.spip.net/">la communaut&eacute; SPIP</a></p>', // 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 :

<VirtualHost *>
DocumentRoot "/Users/maieul/Sites/SPIP21"
</VirtualHost>

É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 :

<VirtualHost *>
DocumentRoot "/Users/maieul/Sites/SPIP20"
ServerName toto.dev
</VirtualHost>

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

P.-S.

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.

Notes

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

Vos commentaires

# Le 31 janvier 2012 à 17:28, par Manu En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX
Bonjour, Alexandra m’a indiqué cette page où, pensait-elle, je trouverais peut-être réponse à mon soucis... Hélas, non !

Mon problème est très simple dans son exposé : je développe mes sites avec une organisation assez similaire à la votre : 1 serveur local disposant d’une ferme à SPIP. Ce que je cherche à faire est de me servir ponctuellement de cette ferme comme site de démonstration, c’est à dire de permettre à certains clients de pouvoir accéder à la version de développement telle qu’est est sur ma machine.

Le problème est que je ne sais pas comment configure apache pour qu’il fasse ça corectement.

Situation actuelle Ma ferme à SPIP est installée dans le répertoire www/maferme/ J’ai créé un domaine noisetier au niveau de mon serveur Mes sites sont sagement rangés ainsi :
- www/maferme/site1.maferme.noisetier
- www/maferme/site2.maferme.noisetier
- En local, j’appelle les différents sites en invoquant l’url http://site1.maferme.noisetier, http://site2.maferme.noisetier etc...
Quelques constats Si un internaute tente d’accéder à mon serveur depuis une de ses machines en saisissant dans son navigateur :
- http://mondyndns.org/ >>> il accède bien à mon répertoire www/
- http://mondyndns.org/maferme/ >>> il accède au formulaire de création d’un nouveau site
- http://mondyndns.org/maferme/sites/ il liste les différents sous-répertoires dans lesquels sont stockés les différents sites mutualisés
Je n’arrive pas à comprendre ce qu’il faut faire pour que des adresses du type http://mondyndns.org/site1.maferme.noisetier ou http://mondyndns.org/site1.noisetier ou quelque chose du genre lui permettent de consulter les différents sites mutualisés !

Auriez-vous une piste à me proposer pour configurer correctement apache pour que je puisse mettre en place ce fonctionnement ? Cela me simplifierait beaucoup les choses parce que, pour l’instant, il me faut tout déplacer ailleurs à chaque fois et c’est ma foi un peu fastidieux...

merci beaucoup d’avance...

Manu
# Le 31 janvier 2012 à 17:57, par Maïeul En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX
Hum, je n’ai jamais testé cela, mais deux points :
1. Configurer Apache pour que http://mondyndns.org pointe vers www/maferme
2. Configurer la mututalisation de SPIP pour faire correspondre les adresses « externes » aux adresses « internes ».
Alors, pour le 1^er point, je pense qu’il faut mettre dans la conf apache
<VirtualHost *> DocumentRoot "cheminabsolueversmaferme" ServerName mondydns.org </VirtualHost>
Pour le second point, dans le mes_options.php :

En dessous de la ligne $site = str_replace('www.', '', $_SERVER['HTTP_HOST']);

mettre :

$site = str_replace('http://mondyndns.org/','http://',$site);

pour faire correspondre l’adresse externe http://mondyndns.org/toto.maferme.noisetier à l’adresse locale http://toto.maferme.noisetier
# Le 31 janvier 2012 à 22:06, par Maïeul En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX
Attention, j’ai parlé trop vite pour la conf apache

Le probléme c’est que tu donne des adresse de type http://domaine/chemin.

Conséquence : avec mon réglage, tu demanderai à Apache de chercher dans cheminabsolueversmaferme/chemin.

Il existe apparement une directive Apache qui permet de contourner cela : la directive alias.

Typiquement dans ton cas, il semble (je dis bien « il semble », je n’ai pas testé) qu’il faille faire
<Virtualhost *> Alias /site1.maferme.noisetier /cheminabsolueversmaferme ServerName mondydns.org DocumentRoot "cheminabsolueversmaferme" </Virtualhost>
# Le 1er février 2012 à 09:26, par Manu En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX

Bonjour et merci de ton aide.... J’ai appliqué ce que tu proposais dans ton post 3... Avec la déclaration de vhost que tu proposes, quand j’appelle http://mondyndns.org/site1, le browser se contente d’afficher le listing du directory site1.maferme.noisetier (IMG, squelettes, local et tmp)... C’est au niveau du /config/mes_options.php de la mutu qu’il faut agir maintenant pour que SPIP prenne la main ?
# Le 1er février 2012 à 11:04, par Maïeul En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX

heu, là ca veut dire que tu n’a pas pointer au bon endroit … il faut faire pointer Apache vers la racine de la mutualisation (là où se trouve le dossier mutualisation et le dossier sites)
# Le 1er février 2012 à 14:39, par Manu En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX

... je manque probablement d’un peu de bases théoriques pour bien comprendre la notion de vhosts et je patauge... En attendant de m’y replonger, j’ai opté pour une autre solution qui est de créer directement sous /home/manu/www autant de sous répertoire que j’ai de sous répertoires dans maferme/sites et d’y mettre des liens symboliques vers les fichiers de la ferme.... C’est un compromis bancal, m’enfin, bon, en attendant de mieux comprendre comment fonctionne apache... Merci de ton aide !
# Le 1er février 2012 à 18:45, par Maïeul En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX

oui, le mieux serait de suivre un tuto sur les vhosts...
# Le 5 novembre 2015 à 17:08, par Ospeleo En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX
J’utilise cette méthode depuis plusieurs années, ça fonctionne bien. Soudainement, suite à un crash de mon DD, et une réinstallation mal faite, les url propres n’étaient plus reconnues en local. Plus précisément, la réécriture d’url fonctionne, mais le htaccess ne fonctionnait plus avec cette config et MAMP.

solution trouvée :

Au lieu de mettre, dans vhost.conf
<VirtualHost *> DocumentRoot "/Users/moi/Sites/SPIP" </VirtualHost>
j’ai mis
<VirtualHost *> DocumentRoot "/Users/moi/Sites/SPIP" <Directory "/Users/moi/Sites/SPIP"> Options FollowSymLinks AllowOverride None </Directory> <Directory "/Users/moi/Sites/SPIP"> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all </Directory> </VirtualHost>
et le htaccess est correctement pris en compte.
# Le 5 novembre 2015 à 17:17, par Maïeul En réponse à : Gérer beaucoup de sites SPIP en local sous MacOsX

merci pour le commentaire. pour ma part je n’active jamais les urls propres en local (sauf pour developper des plugins d’urls propres).

Geekographie Maïeulesque