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 (donc pas forcément stables), pour lesquelles nous ne fournissons pas de procédure d'évolution. Les RC sont donc réservées à des utilisateurs avertis qui participent aux tests de validation.

Ici nous avons opté pour le bureau.

Avec un client ftp (ici FileZilla) connectez vous à votre espace d'hébergement, et sauvegardez sur votre disque dur:

• Le dossier galleries/
• Le fichier mysql.inc.php qui se trouve dans le répertoire include/
• Le fichier config_local.inc.php (n'existe pas forcément) qui se trouve dans le répertoire include/
• Le fichier local-layout.css (n'existe pas forcément) qui se trouve dans le répertoire template-common/
• Le fichier local-layout.css (n'existe pas forcément) qui se trouve dans le répertoire template/yoga/

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 :

• Le dossier galleries/ (*)
• Le fichier config_local.inc.php (n'existe pas forcément) à mettre dans le répertoire include/ (*)
• Le fichier mysql.inc.php à mettre dans le répertoire include/
• Le fichier local-layout.css (n'existe pas forcément) à mettre dans le répertoire template-common/
• Le fichier local-layout.css (n'existe pas forcément) à mettre dans le répertoire template/yoga/

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 comme hébergeur, vous devez créer un fichier, à l'aide de votre éditeur de texte préféré, nommé .htaccess en y mettant la ligne suivante : AddType application/x-httpd-php5 .php

(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.

Vous devez obtenir ceci:

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:

Donc quand vous obtenez ceci:

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

• install.php, * upgrade.php et * le dossier install/.

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.