Carnet Wiki

NettoyageRacineDe18A19

Version 1 — Mai 2006 — Dan Hetzel — Version initiale

1. Introduction : pourquoi ne pas lire cet article

1.1 Si vous installez un site tout neuf avec la version 1.9 de SPIP

alors le répertoire dans lequel vous avez installé SPIP ressemble à la Figure 1 ci dessous :

Figure 1. Contenu du répertoire racine de SPIP 1.9, circa 21/03/2006

CACHE/       ecrire/       IMG/  formulaires/    oo/   dist/
COPYING.txt         UPGRADE.txt     INSTALL.txt    spip.php     index.php      htaccess.txt      inc-public.php3

[Erreur...6]1.2 Si vous faites une mise à jour simplement en installant la 1.9 par dessus une 1.8 existante

Le répertoire racine de l’installation de SPIP 1.8.3 ressemble à la Figure 2 ci dessous :

[Erreur...9]La procédure de mise à jour normale est d’installer la 1.9 par dessus la 1.8 en préservant tous ces fichiers et en en ajoutant d’autres.
C’est pas propre et net, mais ça devrait toujours marcher. Du moins jusqu’à la prochaine version.
Revenez donc d’ici quelque temps, lorsque vous aurez entre 1 heure et une bonne soirée à consacrer à maintenir votre site en pleine forme.

1.3 Si vous avez gardé les squelettes de votre site dans le répertoire d’installation de SPIP

[Erreur...12]

2. Motivations : pourquoi lire cet article

[Erreur...14]Comme précisé dans le fichier UPGRADE.txt, la version 1.9 présente plusieurs changements techniques importants :

-  On se débarasse enfin des extensions de fichier « .php3 » qui tâchent. Voilà quelques années que tout le monde (y compris SPIP) utilise la version 4 ou 5 de PHP. On gardait cette scorie par souci de rétrocompatibilité, mais il est temps de l’éliminer. Dixit les developpeurs : Si cette version de transition (1.9) est encore compatible avec « .php3 », la prochaine (2.0) ne le sera pas.

[Erreur...17]- On réorganise les fichiers, comme on le voit en comparant les Figures 1 et 2.

Ces changements réduisent la complexité du répertoire d’installation et permettent d’améliorer la sécurité. Ils permettent d’installer des fonds de page personalisés plus facilement. Toutefois ces améliorations ont un coût :
Si vous recopiez un /squelette/ conçu pour la 1.8 dans une installation 1.9 toute neuve,
toutes les références en .php3 ne marchent plus. Les liens entrants et les liens internes dans le site sont cassés.

3. Au travail

3.1 Préserver les anciennes URL

Si votre hébergeur l’autorise, utilisez le fichier htaccess.txt, en le recopiant à la racine du site sous le nom .htaccess.
Ce fichier dira alors au serveur Web que les hits sur une adresse du type article.php3?id_article=1 doivent être traités par spip.php ; il gère, de plus, les URLs « propres ».

Sinon, vous n’avez pas le choix, il faut garder les fichiers du type article.php3 à la racine.

3.2 Renommer et déplacer mes_options.php3 et mes_fonctions.php3

à expliquer.

3.3 Renommer et déplacer les fichiers de langue

à expliquer.

3.4 Les squelettes

Suite à l’élimination des fichiers article.php3, il convient de spécifier l’âge maximum des pages dans le cache. La ligne de code précisant $delai=3600; qui était dans article.php3 devient une ligne #CACHE{3600} dans le squelette article.html.

[Erreur...30][Erreur...31]

4. Et enfin

Maintenant, vous pouvez supprimer articles.php3 et compagnie.

TODO : écrire un script pour tout vérifier.