Migració cap a SPIP 1.9

Heus aquí un mètode pas a pas, que permet assegurar una migració «neta» cap a SPIP 1.9, suprimint els fitxers que han esdevingut inútils.

La versió SPIP 1.9 introdueix una nova organització dels fitxers d’SPIP. També l’actualització d’un lloc existent en versió 1.8 o anterior pot portar a una multiplicació de fitxers inútils.

Per la gent amb pressa, el mètode consisteix en seguir el procediment d’actualització habitual (és a dir: deixar els fitxers de la versió 1.9 a sobre dels fitxers existents), després deixar de banda tots els fitxers xxx.php3 i veure si tot plegat encara funciona: en general, si.

Mètode de migració

  1. Com abans de fer qualsevol operació important en el vostre lloc Web, feu una còpia de seguretat de la base de dades, còpia de seguretat de la base de dades, per precaució.
  2. Moveu tots els fitxers i carpetes de la instal·lació antiga cap una subcarpeta. Sobretot no els esborreu de cap manera en aquest etapa!
  3. Instal·leu els fitxers d’SPIP 1.9 a l’arrel. Penseu a verificar els drets d’accés del directori tmp (generalment el CHMOD que s’ha d’aplicar és 777) — que contindrà una arborescència de carpetes incloent aquelles anomenades antigament CACHE/ i ecrire/data/
  4. Si preferiu utilitzar la instal·lació automàtica amb spip_loader.php, és possible: simplement atureu-vos després de la descompressió, passeu a les etapes següents, i seguiu amb la instal·lació.
  5. Copieu la vostra carpeta d’esquelets (plantilles) a l’arrel (si és necessari, anomeneu-la de nou «esquelets»).
  6. Reemplaceu l’antic directori IMG/ (i els seus subdirectoris) a l’arrel (conté tots els logotips, les imatges i els documents utilitzats al lloc Web). De passada, podeu suprimir:
    • la carpeta icones_barre/ ;
    • la carpeta icones/ si només conté -dist (dit d’una altra manera, només hi posarem les icones sense -dist).
    • les carpetes cache..×../ que contenen les imatges calculades pel servidor (versions reduïdes dels logotips, fórmules matemàtiques, etc.) ; tornaran a ser creades segons les necessitats per SPIP, en el seu nou emplaçament a dins de tmp/.
  7. Repreneu (si existeixen) els fitxers personalitzats mes_fonctions.php3 (en general, a dins de la carpeta squelettes/) i mes_options.php3 (en general, fins a SPIP 1.8, a dins de la carpeta ecrire/); torneu-los a anomenar tot suprimint el «3» final, i situeu els
    • mes_fonctions.php a dins de la carpeta squelettes/
    • mes_options.php a l’interior de la nova carpeta config/
  8. Torneu a l’espai privat per seguir el procés d’instal·lació del lloc (si heu perdut els vostres identificadors de connexió a la base MySQL del lloc Web, en teniu prou obrint el fitxer ecrire/inc_connect.php3 de l’antiga versió per retrobar-los). Per la vostra informació, la instal·lació crea ara un fitxer connect.php a dins de la carpeta config/.
  9. No us ho direm mai prou vegades: no restaureu la base de dades que heu desat anteriorment!
  10. Verifiqueu

Actualització de les plantilles (esquelets)

  • Els esquelets ja no funcionen per parelles de fitxers .php3/.html: podeu suprimir els fitxers PHP de crida. Per exemple, suprimiu el fitxer article.php3, però guardeu l’esquelet article.html.
  • Si aquest fitxer .php3 contenia funcions o altres coses específiques a l’esquelet, les posarem a dins de squelettes/xxx_fonctions.php, per exemple per article, squelettes/article_fonctions.php
  • Els fitxers de llengua es poden posar a dins d’una subcarpeta lang/ de la carpeta squelettes/
  • els formularis personalitzats s’han de posar directament a l’interior de la carpeta squelettes/ i no a la subcarpeta formulaires/ de l’arrel.
  • Les icones personalitzades es posen a dins de IMG/icones/.

El codi dels esquelets també val la pena que el netegem una mica. Adoneu-vos bé que això no és indispensable pel bon funcionament del lloc Web; simplement us garantirà un codi més «net»:

  • Reemplaceu totes les etiquetes #DOSSIER_SQUELETTE per #CHEMIN, tot respectant la sintaxi: #CHEMIN{fichier}
  • La gestió de la memòria cau, abans precisada per $delais = 24 * 3600; dins el fitxer PHP de crida, passa a partir d’ara a l’etiqueta #CACHE{24*3600}, que es situa directament a l’interior de cada esquelet.
  • Les capçaleres HTTP es poden definir per mitjà d’una etiqueta: #HTTP_HEADER{Content-Type: text/css}. A tenir en compte si feu servir l’astúcia $flag_preserver=true;: trobareu la funcionalitat corresponent (fer que no es mostrin els botons d’administració) posant a dins de l’esquelet: #HTTP_HEADER{Content-Type: text/html}
  • La sintaxi de les inclusions es pot simplificar: l’esment «page.php3» ja no és necessari; no es necessita més que el nom de l’esquelet (plantilla) a incloure, d’aquesta manera: <INCLURE{fond=mon_squelette}{critere1}{critere2}{...}>.

Gestió dels URLs

Havent canviat els URls del lloc amb SPIP 1.9, voldreu conservar els vostres antics URLs, com a mínim perquè els internautes (o motors de cerca) que els coneixen continuïn trobant el contingut corresponent.

El fitxer htaccess lliurat oficialment permet assegurar una transició completa cap a les noves adreces del lloc Web. Per a posar-lo en funcionament, heu de reanomenar el fitxer htaccess.txt en .htaccess. En alguns llocs Web serà necessari també editar-ne la primera línia per fer aparèixer RewriteBase /; fixeu-vos que el client FTP no mostrarà probablement aquest fitxer al final del procés, ja que el punt que porta al començament del nom assenyala sovint un «fitxer invisible».

Pas a UTF-8

Podeu acabar la vostra migració convertint el vostre lloc Web al joc de caràcters universal utf-8, a partir de la opció «Gestió de llengües» de la configuració. Aquesta operació s’acompanya d’una salvaguarda sistemàtica de la vostre base en el seu joc de caràcters d’origen a dins de la carpeta /tmp dels vostre SPIP.

Represa dels plugins

Si migreu des d’una versió intermèdia d’SPIP 1.9 i feu servir pluguins, primer de tot haureu de verificar que aquests són —o proposen noves versions— compatibles amb la versió destí de la migració, i també reprendre’ls, posant-los al dia si en teniu necessitat.

Notes complementàries

Finalment, no oblideu «netejar» el subdirectori on heu desplaçat el vostre lloc d’origen. Si heu seguit correctament tot el procediment, només hi ha d’haver els fitxers de la vostra antiga versió d’SPIP. No obstant, abans d’esborrar-lo, baixeu-lo al disc dur del vostre ordinador, i feu un zip — no fos cas que us haguéssiu oblidat alguna cosa.

Autor laura, merce Publié le : Mis à jour : 26/10/12

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