🌍
English
This shows you the differences between two versions of the page.
fr:installer:upgrade [2008/10/17 07:08] 80.13.145.242 |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Mise à jour ====== | ||
- | |||
- | 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. | ||
- | |||
- | |||
- | |||
- | |||
- | ===== 1. Téléchargez la version la plus récente de PhpWebGallery ===== | ||
- | |||
- | C'est [[http://download.gna.org/phpwebgallery|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. | ||
- | |||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_01.jpg}} | ||
- | |||
- | ===== 2. Décompressez le fichier dans un répertoire temporaire sur votre disque dur ===== | ||
- | |||
- | Ici nous avons opté pour le bureau. | ||
- | |||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_02.jpg}} | ||
- | |||
- | |||
- | ===== 3. Sauvegarder les fichiers-clés de votre PhpWebGallery actuel ===== | ||
- | |||
- | |||
- | 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/ | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | ===== 4. Supprimez votre PhpWebGallery ===== | ||
- | |||
- | **ATTENTION : toutes les modifications, MOD ou template, que vous aurez apportées à PhpWebGallery seront perdues !** | ||
- | [FIXME 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: | ||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_03.jpg}} | ||
- | et dans le répertoire include, vous ne devez conserver au plus que : | ||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_04.jpg}} | ||
- | |||
- | 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. | ||
- | |||
- | |||
- | |||
- | ===== 5. Transférez les fichiers de la dernière version de PhpWebGallery ===== | ||
- | |||
- | Par FTP, transférez l'ensemble de l'archive décompressée sur votre serveur distant. | ||
- | |||
- | |||
- | |||
- | |||
- | ===== 6. Replacez les fichiers sauvegardés sur le 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. | ||
- | |||
- | |||
- | ==== 6.1 Créer un fichier .htaccess ==== | ||
- | |||
- | |||
- | **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 | ||
- | |||
- | (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... | ||
- | |||
- | |||
- | ===== 7. Lancer le script upgrade.php ===== | ||
- | |||
- | |||
- | 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:\\ | ||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_05.jpg}} | ||
- | |||
- | 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. | ||
- | |||
- | |||
- | |||
- | |||
- | ===== 8. Passez en mode UPGRADE ===== | ||
- | |||
- | 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:\\ | ||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_05.jpg}} | ||
- | |||
- | Il vous est demandé de rajouter la ligne : | ||
- | |||
- | <code>define('PHPWG_IN_UPGRADE', true);</code> | ||
- | Éditez votre fichier mysql.inc.php en rajoutant cette ligne. Le fichier devrait alors ressembler à ça: | ||
- | <code php><?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); | ||
- | ?></code> | ||
- | 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. | ||
- | |||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_06.jpg}} | ||
- | |||
- | 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. | ||
- | |||
- | {{fr:aide:installer:phpwebgallery_documentation_1.6_images_upgrade_07.jpg}} | ||
- | |||
- | |||
- | |||
- | |||
- | |||
- | ===== 9. Sortez du mode UPGRADE ===== | ||
- | |||
- | Votre PhpWebGallery a été mis à jour. Maintenant, pour sortir du mode UPGRADE, éditez de nouveau le fichier mysql.inc.php et supprimez la ligne : | ||
- | <code php>define('PHPWG_IN_UPGRADE', true);</code> | ||
- | |||
- | |||
- | |||
- | ===== Recommandation ===== | ||
- | |||
- | :!: 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 [[http://phpwebgallery.net/ext/extension_view.php?eid=177 | 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. | ||