Migración hacia SPIP 1.9

Este es un método paso a paso que permite asegurarse una migración « limpia » a SPIP 1.9, suprimiendo ficheros inútiles.

La versión SPIP 1.9 introduce una nueva organización de los archivos de SPIP. Por eso, la actualización desde un sitio existente en versión 1.8 o anterior puede llevar a una multiplicación de ficheros inútiles (e incluso en algunos casos de configuración, dañinos para un buen funcionamiento).

Para las personas apuradas, el método consiste en seguir el procedimiento habitual de actualización (es decir: copiar los ficheros de la versión 1.9 encima de los ficheros existentes), y luego añadir todos los ficheros xxx.php3 y ver si aún funciona: en general, sí.

Método de migración

  1. Como siempre antes de cualquier operación importante en tu sitio, haz un respaldo de la base, por precaución.
  2. Desplaza todos los ficheros y las carpetas de la antigua instalación a una subcarpeta. En esta fase, ¡sobre todo no los borres!
  3. Instala los ficheros de SPIP 1.9 en la raíz. Recuerda verificar los permisos de acceso a la carpeta tmp (generalmente el CHMOD que se aplica es 777), que contiene un árbol de carpetas que incluye las anteriormente denominadas CACHE/ y ecrire/data/ que deben estar accesibles en escritura.
  4. Si prefieres utilizar la instalación automática con spip_loader.php se puede hacer: sólo detente después de la descompresión, pasa a las etapas siguientes, y retoma la misma ventana para la instalación.
  5. Copia tu carpeta de esqueletos a la raíz (si fuera necesario, renombrala como «squelettes»).
  6. Vuelve a instalar la antigua carpeta IMG/ (y sus sub-carpetas) en la raíz (contiene todos los logos, las imágenes y los documentos instalados en el sitio). Se pueden suprimir:
    • la carpeta icones_barre/ ;
    • la carpeta icones/ si sólo contiene -dist (dicho de otra manera, sólo volver a poner los iconos sin -dist).
    • las carpetas cache..×../ contienen por su parte las imágenes calculadas por el servidor (versiones reducidas de los logos, fórmulas matemáticas, etc.) ; SPIP las volverá a crear, si es necesario, en su nuevo emplazamiento en tmp/.
  7. Vuelve a instalar (si existían) los archivos personalizados mes_fonctions.php3 (en la carpeta squelettes/, en general) y mes_options.php3 (en la carpeta ecrire/ hasta SPIP 1.8, SPIP 1.8.1); y conviene cambiarles el nombre suprimiendo el “3” final (es decir, mes_fonctions.php y ecrire/mes_options.php) y ponlos
    • mes_fonctions.php en la carpeta squelettes/
    • mes_options.php en la nueva carpeta config/
  8. Entra en el espacio privado para lanzar el procedimiento de actualización (si perdiste el identificador y contraseña de la base MySQL del sitio, alcanza con abrir el archivo ecrire/inc_connect.php3 de la antigua versión para volver a encontrarlos). Para tu información, la instalación ahora crea un fichero connect.php en la carpeta config/.
  9. Nunca lo diremos lo suficiente: ¡no vuelvas a instalar el anterior respaldo de la base de datos que habías hecho!
  10. Probar

Actualización de los esqueletos

  • Los esqueletos ya no funcionan por parejas .php3/.html: puedes suprimir los ficheros PHP de llamada. Por ejemplo: suprime el archivo article.php3, pero guarda el esqueleto article.html.
  • Si el fichero .php3 contenía funciones o características específicas del esqueleto, colocarlas en squelettes/xxx_fonctions.php, por ejemplo para article, squelettes/article_fonctions.php
  • Los archivos de idioma pueden localizarse en una subcarpeta lang/ de la carpeta squelettes/.
  • Los formularios personalizados deben localizarse directamente en la carpeta squelettes/ (y no en la subcarpeta formulaires/ en la raíz).
  • Los iconos personalizados se ponen en la carpeta IMG/icones/.

El código de los esqueletos también merece algo de aseo. Nota que en principio esto no es necesario al buen funcionamiento del sito, sólo que te garantizará un código mas «limpio»:

  • Remplaza todas las balizas #DOSSIER_SQUELETTE por #CHEMIN, teniendo cuidado de respetar la sintaxis: #CHEMIN{archivo}.
  • La gestión de la duración de la caché, antes especificada por $delais = 24 * 3600; en el fichero PHP de llamada, dispone ahora de la baliza: #CACHE{24*3600} que se pone directamente en cada esqueleto.
  • Los encabezados HTTP pueden definirse a través de una baliza: #HTTP_HEADER{Content-Type: text/css}. Si utilizas el truco $flag_preserver=true; recuperarás la funcionalidad correspondiente (la ausencia de los botones de administración) indicando en el esqueleto: #HTTP_HEADER{Content-Type: text/html}
  • La síntaxis de las inclusiones puede simplificarse: ya no es necesaria la mención «page.php3» ; sólo se necesita el nombre del esqueleto a incluír, en la forma <INCLURE{fond=nombreesqueleto}{criterio1}{criterio2}{...}>

Gestión de las URLs

Como las URL del sitio han cambiado con [spip19] (y los archivos article.php3, etc. desaparecieron), sin duda deseas conservar tus antiguas direcciones, al menos para que l@s internautas (o los motores de búsqueda) que los conocen continúen encontrando el contenido correspondiente.

El archivo htaccess distribuído con SPIP permite asegurar una transición completa hacia las nuevas direcciones del sitio. Para ponerlo en servicio, hay que cambiarle el nombre al archivo htaccess.txt y llamarlo .htaccess. En ciertos hospedajes también habrá que editar la primera línea para hacer aparecer RewriteBase /. Ten cuidado porque probablemente tu cliente FTP ya no mostrará este archivo al final de la operación, ya que un punto al principio de un nombre de archivo significa, en general, «archivo invisible».

Paso a UTF-8

Puedes terminar tu migración transformando tu sitio al juego de caracteres universal utf-8, a partir de la opción «Gestión de idiomas» de la configuración. Esta operación se acompaña de un respaldo sistemático de tu base de datos en su juego de caracteres original en la carpeta /tmp de tu SPIP.

Reactivar plugins

Si migras desde una versión intermedia de SPIP 1.9 y utilizas plugins, necesitarás comprobar antes que los mismos son —o existen nuevas versiones— compatibles con la versión de SPIP tras la migración y actualizarlas, de ser necesario.

Notas complementarias

Finalmente, no te olvides de «limpiar» la subcarpeta donde habías desplazado el sitio inicial. Si seguiste correctamente este procedimiento, ya sólo debe contener los archivos de tu antigua versión de SPIP. Antes de borrarlo, sin embargo, bájalo a tu disco duro y guárdalo comprimido, por si acaso te hubieras olvidado de alguna cosa.

Autor o autora dani Publicado el: Actualizado: 26/10/12

Traducciones: عربي, català, English, Español, italiano