Cet article présente les astuces et guides pour vous aider migrer entre les différentes versions de PHP sur le Simple Hosting.

Une nouvelle instance PHP 7 est maintenant disponible avec MySQL 5.6 (Percona Server), PostgreSQL 9.4 ou MongoDB 2.4.

Ce document liste les différences connues et les problèmes de compatibilité entre les instances PHP 5.4, 5.6 et 7. Vous y apprendrez aussi comment migrer votre code, les hôtes virtuels (VHOSTS) et les bases de données depuis une vieille instance vers une nouvelle instance.

Les instances PHP 7 utilisent le fuseau horaire UTC (Universal Coordinated Time) par défaut.

Vous pouvez changer la propriété date.timezone dans le fichier php.ini pour l'adapter.

Par exemple :

date.timezone = "America/New_York"

Vous pouvez installer vos propres binaires sur l'instance PHP 7.

• Avec sFTP, placez vos fichiers dans le répertoire /lamp0/home/
• Avec SSH, les fichiers doivent se trouver dans le répertoire /srv/data/home/

PHP 7 introduit de nombreuses nouveautés et a quelques incompatibilités avec PHP 5.

Nous vous recommandons de consulter la page officielle pour en savoir plus :

• Guide officiel de migration PHP: http://php.net/manual/fr/migration70.php

L'instance PHP 7 est techniquement identique à l'instance PHP 5.6. Veuillez consulter la documentation de migration de PHP 5.4 à PHP 5.6 pour mieux connaître les différences entre les types d'instance.

MySQL 5.6 (Percona) est disponible pour PHP 7 et PHP 5.6. Percona Server est une version optimisée et plus stable du moteur MySQL, tout en étant 100% compatible avec le moteur officiel.

Cette version est rétro-compatible, donc vous pouvez migrer vos données depuis MySQL 5.5 sans aucun souci. Nous vous recommandons tout de même de faire des essais avant de migrer vos données de production. Consultez les guides de migration disponibles ci-dessous.

Pour en savoir plus sur MySQL 5.6 Percona Server :

• Documentation officielle Percona Server 5.6 : https://www.percona.com/doc/percona-server/5.6/index.html

PostgreSQL 9.4 est maintenant disponible pour PHP 5.6 et PHP 7. Cette version inclue le support natif de JSON et reste retro-compatible avec les données exportées depuis PostgreSQL 9.2 et 9.3.

Nous vous recommandons la consultation des guides de migration ci-dessous, ainsi que de la documentation officielle (en anglais):

http://www.postgresql.org/docs/9.4/static/upgrading.html

Il est désormais nécessaire d'inclure la librairie “mongodb” dans votre code pour pouvoir vous connecter à MongoDB depuis les nouvelles instances PHP 5.6 et PHP 7.

Nous vous recommandons d'utiliser Composer pour gérer cette intégration facilement. Pour en savoir plus, veuillez consulter la section sur MongoDB dans la documentation de l'instance PHP.

Vous pouvez migrer vos données avec un simple export et import comme décrits plus bas.

1 - Exportez votre ancienne BDD

Accédez à votre instance via SSH ou via le panneau de contrôle :

• MySQL: https://wiki.gandi.net/simple/mysql#importing_an_existing_database
• PostgreSQL: https://wiki.gandi.net/simple/postgresql#export_a_database
• MongoDB: https://wiki.gandi.net/simple/mongodb#exporting_an_existing_database

2 - Tester localement

• Installez et lancez PHP 7 et la version de la base de données correspondante sur votre ordinateur
• Exportez votre BDD depuis la vieille instance
• Importez la BDD dans votre applicatif local
• Lancez et testez l'application pour vous assurer que tout fonctionne normalement avec les nouvelles versions

3 - Créez une nouvelle instance PHP 7

Vous pouvez créer une nouvelle instance en sélectionnant “PHP 7 / MySQL 5.6 (Percona)”, “PHP 7 / PostgreSQL 9.4” ou “PHP 7 / MongoDB 2.4” à l'adresse suivante (vous devrez vous enregistrer au passage):

https://www.gandi.net/hosting/simple/create

Avec Gandi CLI, éxecutez la commande suivante en remplaçant <tt>{type d'instance}</tt> par <tt>php7mysql5.6</tt>, <tt>php7pgsql9.4</tt> ou <tt>php7mongodb2.4</tt>:

  $ gandi paas create --type {type d'instance}

4 - Déployez vos fichiers sur la nouvelle instance

• Avec sFTP : https://wiki.gandi.net/simple/sftp
• Avec git+SSH et Composer : https://wiki.gandi.net/simple/git

5 - Importez la base de données

• MySQL: https://wiki.gandi.net/simple/mysql#importing_an_existing_database
• PostgreSQL: https://wiki.gandi.net/simple/postgresql#import_a_database
• MongoDB: https://wiki.gandi.net/simple/mongodb#importing_an_existing_database

6 - Migrez vos VHOSTs

Etape 1 - Supprimez les VHOSTs de l'ancienne instance:

https://wiki.gandi.net/simple/migrate#remove_the_old_vhost

Etape 2 - Créez les VHOSTS sur la nouvelle instance:

https://wiki.gandi.net/simple/migrate#create_the_new_vhost

7 - Arrêter la vieille instance (vous serez remboursé sur votre Pré-Payé)

Maintenant que les VHOSTS sont changés et que tout le traffic est dirigé vers la nouvelle instance, vous pouvez arrêter la vieille instance et récupérer l'argent correspondant au nombre de jours restant sur votre contrat. Le montant sera crédité sur votre compte pré-payé.

Nous avons publié une nouvelle instance supportant la version 5.6 de PHP.

Ce document liste les différences connues et les problèmes de compatibilité entre les version de PHP 5.4 et PHP 5.6. Celui-ci indique comment migrer votre code, les hôtes virtuels (VHOSTS) et les bases de données depuis une instance de version PHP 5.4 vers PHP 5.6.

Les instances PHP 5.4 sont maintenant considérées comme obsolètes et seront maintenues jusque la fin de vie (EOL) de Debian 7 (système de base utilisé pour les instances). D'ici leur fin de vie, vous pourrez continuer de créer des instances Simple Hosting PHP 5.4. La fin de vie est planifiée pour avril/mai 2018 mais pourra être anticipée par nos équipes.

La nouvelle instance PHP 5.6 utilise le fuseau horaire UTC (Temps Universel Coordonné) par défaut.

Vous pouvez modifier l'option date.timezone dans le fichier php.ini pour l'adapter à vos préférences.

Par exemple :

date.timezone = "Europe/Paris"

Avant le lancement de l'instance PHP 5.6, un ensemble de binaires et librairies étaient pré-installés dans /usr/local/bin/, tels que les modules SIPS/ATOS et Paybox.

Vous devez désormais installer vos propres binaires sur votre instance :

• Via sFTP, placez vos binaires dans le répertoire /lamp0/home/
• Via SSH, le chemin du répertoire est /srv/data/home/

Cette section contient les liens vers la documentation officielle des ressources PHP, décrivant les différences entre les versions. Nous allons l'enrichir grâce aux retours clients.

• Modifications depuis PHP 5.4 vers PHP 5.5 : http://php.net/manual/fr/migration55.incompatible.php
• Modifications depuis PHP 5.5 vers PHP 5.6 : http://php.net/manual/fr/migration56.incompatible.php

Les différences entre PHP 5.4 et PHP 5.6 pourraient impacter le fonctionnement de votre site. Pour être sûr de ne pas avoir à faire de modifications de code en urgence, vous pourriez tester votre application avec PHP 5.6 avant de tenter une migration automatique ou manuel.

Les exemples génériques suivants devraient vous fournir une idée sur comment tester votre application sur votre propre ordinateur, ou sur une nouvelle instance Simple Hosting avant de migrer.

1 - Test local sur votre machine

• Lancer PHP 5.6 et votre base de données localement
• Effectuer une sauvegarde de votre base de données de votre ancienne instance
• Importer la sauvegarde de la base de données sur votre installation locale
• Effectuer des tests sur votre application, et vérifier que tout fonctionne correctement

2 - Test sur une nouvelle instance PHP 5.6

• Importer une sauvegarde de la base de données ou en créer une nouvelle
• Déposer le contenu de votre site dans le répertoire adéquat
• Vous connecter sur le site/hôte virtuel pour vérifier que votre application fonctionne correctement

Les clients utilisant les instances de type PHP/MySQL ont la possibilité de lancer une migration automatique de la version 5.4 à la version 5.6 de PHP. Les utilisateurs des bases de données PostgreSQL et MongoDB trouveront comment effectuer la migration manuelle dans la partie suivante.

Tout votre code, ainsi que les VHOSTS, bases de données, fichiers de logs et Snapshots seront déplacés vers la nouvelle instance exécutant PHP 5.6.

Votre facturation ne sera pas impactée non plus, mais le site pourra être inaccessible pendant la durée de la migration.

Dans la page de gestion de l'instance, cliquez sur le bouton Upgrade pour démarrer le processus.

Vous pouvez utiliser les méthodes API suivantes pour vérifier si l'instance peut être automatiquement mise à jour et lancer ce processus.

1. Vérifier si la mise à jour est disponible

La valeur “need upgrade” sera définie à “true” dans les méthodes : “paas.list()” ou “paas.info()”. http://doc.rpc.gandi.net/paas/reference.html#PaasListReturn

2. Mettre à jour l'instance

Définissez la valeur 'upgrade' à 'true' et appelez la méthode “paas.update()” http://doc.rpc.gandi.net/paas/reference.html#PaasUpdateParams

1. Export de la base de données de l'ancienne instance

Initiez une connexion SSH à l'instance ou à la page web d'administration de l'instance pour exporter les bases de données.

• MySQL : https://wiki.gandi.net/fr/simple/mysql#exporter_une_base_de_donnees
• PostgreSQL : https://wiki.gandi.net/fr/simple/postgresql#exporter_une_base_de_donnees
• MongoDB : https://wiki.gandi.net/fr/simple/mongodb#exporter_une_base_de_donnees

2. Créer une nouvelle instance PHP

Les instances PHP 5.6 sont désormais proposées par défaut, vous pourrez ainsi sélectionner entre PHP avec PostgreSQL, MongoDB ou MySQL.

Les instances PHP 5.4 ont été renommées pour refléter ce statut déprécié.

Plus d'informations : https://wiki.gandi.net/fr/simple/create-instance

3. Envoi des fichiers vers la nouvelle instance

• En utilisant SFTP : https://wiki.gandi.net/fr/simple/sftp
• En utilisant git+SSH: https://wiki.gandi.net/fr/simple/git

Envoyez également le fichier résultant de l'export de la base de données afin de pouvoir l'importer.

4. Import de la base de données (ou création d'une nouvelle)

• MySQL : https://wiki.gandi.net/fr/simple/mysql#importer_des_bases_de_donnees
• PostgreSQL : https://wiki.gandi.net/fr/simple/postgresql#importer_une_base_de_donnees
• MongoDB : https://wiki.gandi.net/fr/simple/mongodb#importer_une_base_de_donnees

5. Migration des VHOSTS

Cette étape impliquera une période d'inaccessibilité car elle implique un changement du fichier de zone DNS et ainsi un délai de propagation.

Etape 1 : Suppression des vhosts :

https://wiki.gandi.net/fr/simple/migrate#suppression_de_l_ancien_hote_virtuel

Etape 2 : Création des nouveaux vhosts :

https://wiki.gandi.net/fr/simple/migrate#creation_du_nouvel_hote_virtuel

6. Arrêt de la précédente instance (vous serez remboursé sur votre compte prépayé)

Maintenant que tout le trafic est envoyé vers la nouvelle instance, vous pouvez arrêter l'ancienne instance. Votre compte prépayé sera crédité au prorata de l'utilisation correspondant au temps restant d'engagement.