This is an old revision of the document!
Ce document n'est qu'un EXEMPLE (réalisé pour la 1.6), il est cependant valable pour les versions supérieures ).
La mise à jour de PhpWebGallery se fait en 9 étapes simples.
C'est ici
Remarque : Attention à ne pas télécharger de RC (Release Candidate).
Les releases candidates sont des pré-versions (pas forcément stables), pour lesquelles nous ne fournissons pas de procédure d'évolution (c.à.d. pas de procédure de mise à jour, pas de upgrade.php (Cf. point 8 ci-dessous), et entièrement à vos risques et périls). En conséquence, les RC sont réservées à des utilisateurs avertis qui participent aux tests de validation.
Avec un client ftp (ici FileZilla) connectez vous à votre espace d'hébergement, et sauvegardez sur votre disque dur:
ATTENTION : toutes les modifications, MOD ou template, que vous aurez apportées à PhpWebGallery seront perdues ! [ A rajouter : comment faire pour conserver ces modifications ?]
Supprimer les fichiers et dossiers. Sachez cependant que vous pouvez conserver malgré tout (afin de ne pas avoir à retransférer vos 250 000 images), les 2 dossiers suvants: et dans le répertoire include, vous ne devez conserver au plus que :
Bien entendu dans le cas présent, laisser les images en place dans ./galleries/ sera un gage de réussite car aucune erreur de transfert FTP n'entachera le processus.
Par FTP, transférez l'ensemble de l'archive décompressée sur votre serveur distant.
Soit :
N'oubliez pas de transférer le fichier mysql.inc.php dans include/. En effet, celui présent dans la nouvelle version est vide…
(*) Si vous les avez supprimés à l'étape 4.
Attention, avec online ou 1and1 comme hébergeurs, vous devez créer un fichier afin d'autoriser l'utilisation de php5, à l'aide de votre éditeur de texte préféré, nommé .htaccess en y mettant la ligne suivante : AddType application/x-httpd-php5 .php
Passer en PHP5 chez différents hébergeurs
(Cette manipulation peut s'avérer inutile et différente chez d'autres hébergeurs, c'est un cas spécifique donné pour l'exemple).
Placez ensuite ce fichier dans le répertoire racine de votre galerie à l'aide de votre client ftp. Sans cette manip, vous aurez une page blanche à l'étape suivante…
Une fois le transfert terminé, rendez-vous avec votre navigateur à l'adresse de mise à jour, par exemple : http://votredomaine/phpwebgallery/upgrade.php.
Si vous obteniez autre chose, abandonnez!!! --> Vérifiez que le fichier ''./include/mysql.inc.php'' est bien l'ancien (il ne saurait pas être vide !!!). --> Rendez-vous sur le forum pour vous faire aider.
Le passage en mode UPGRADE n'est pas nécessaire entre 1.7.0 et 1.7.1 par exemple, il s'agit de la même “branche” c'est à dire 1.7 (Il existe malheureusement de rares exceptions mais elles ne concernent pas les dernières releases). Pour passer de 1.3.x, 1.4.x, 1.5.x, 1.6.x vers une version 1.7.x ou supérieure, vous devez suivre les explications ci-dessous à la lettre:
Il vous est demandé de rajouter la ligne :
define('PHPWG_IN_UPGRADE', true);
Éditez votre fichier mysql.inc.php en rajoutant cette ligne. Le fichier devrait alors ressembler à ça:
<?php $cfgBase = 'NomDeVotreBase'; $cfgUser = 'NomUtilisateurAccesBase'; $cfgPassword = 'MotDePasseAccesBase'; $cfgHote = 'ServeurAccesBase'; $prefixeTable = 'phpwebgallery_'; define('PHPWG_INSTALLED', true); // Ligne à rajouter pour permettre la mise à jour ! define('PHPWG_IN_UPGRADE', true); ?>
Remarque : Pas d'espace après le ?> ou de ligne vide après le ?>…
Une fois le fichier mysql.inc.php modifié et enregistré sur le serveur distant, rafraichissez la page upgrade.php dans votre navigateur.
Dans cette exemple je mets à jour la version 1.5.x. Cliquez sur le lien Upgrade from release 1.5.0 to 1.6.0. La page se recharge et vous arrivez à cette page.
Votre PhpWebGallery a été mis à jour. Maintenant, pour sortir du mode UPGRADE, éditez de nouveau le fichier mysql.inc.php et supprimez la ligne :
define('PHPWG_IN_UPGRADE', true);
Par sécurité, que vous ayez eu besoin de suivre ou non la procédure d'upgrade, vous devez également supprimer les fichiers
Le passage en 1.7 enlève temporairement tout l'historique existant. Vous pourrez le reconstituer facilement car tout a été sauvegardé dans la table history_backup. Pour cela vous devrez installer le plugin ImportStat.
L'opération n'a besoin d'être réalisée qu'une seule fois. Le plugin peut être entièrement désinstallé après son utilisation.