🔄 Migration de version

Pourquoi un migrateur plutôt qu'un traducteur

Passer de PHP 5.6 à PHP 8 n'est pas une traduction : c'est le même langage, dont certaines constructions ont disparu et d'autres ont changé de comportement. La liste des ruptures est publiée, finie et vérifiable — ce qui rend l'opération mécanisable, contrairement à une conversion entre deux langages différents où la moindre ligne suppose un choix de conception.

Le même raisonnement vaut d'une version 3 à une autre. Python ne casse presque jamais la syntaxe, mais retire des modules de sa bibliothèque standard : distutils en 3.12, dix-neuf modules d'un coup en 3.13. Le code reste valide — il ne démarre simplement plus. Ce sont des listes publiées, donc vérifiables.

Cet outil s'en tient donc à ce périmètre. Il ne prétend pas transformer du Python en Java : un tel résultat compile parfois et se comporte autrement, ce qui est le pire des résultats puisqu'il inspire confiance.

Ce qui est réécrit, et ce qui ne l'est pas

Une réécriture n'est appliquée que lorsqu'elle est équivalente : array() en crochets, $s{0} en $s[0], isset($a) ? $a : $b en $a ?? $b, print "x" en print("x"). Ces transformations ne changent ni le résultat ni les cas limites.

Tout le reste est signalé sans être touché. Un appel mysql_query() ne devient pas du PDO par substitution : il faut reprendre la connexion, la gestion des erreurs et l'échappement. Un outil qui produirait ici du code d'apparence correcte rendrait un mauvais service.

MySQL, MariaDB, Oracle : ce que change une version

Le SQL se prête particulièrement bien à cet exercice, parce que ses ruptures sont peu nombreuses et documentées. Passer de MySQL 5.7 à 8.0, c'est surtout une vingtaine de mots devenus réservés — rank, row, groups, system —, la disparition de PASSWORD(), celle du tri implicite du GROUP BY, et le préfixe ST_ devenu obligatoire sur les fonctions spatiales.

Entre MySQL et MariaDB, la difficulté n'est plus la version mais la divergence : les collations utf8mb4_0900_* et JSON_TABLE() n'existent pas côté MariaDB, tandis que les séquences, RETURNING et CREATE OR REPLACE TABLE n'existent pas côté MySQL. Un fichier de sauvegarde restauré dans l'autre moteur échoue le plus souvent sur la collation, dès la première table.

Côté Oracle, les ruptures purement syntaxiques sont rares : l'essentiel des points relevés concerne des constructions devenues inutiles — la pagination par ROWNUM depuis que FETCH FIRST existe, le couple séquence et déclencheur depuis les colonnes IDENTITY — ou dépréciées, comme DBMS_JOB. C'est le jeu de règles le plus mince des quatre, et il faut le savoir.

Le code ne quitte pas votre navigateur

L'analyse s'exécute entièrement en JavaScript, sur votre machine. Aucun envoi, aucun enregistrement, aucune trace côté serveur — ce qui compte quand on colle du code appartenant à un client ou à un employeur.

Cela vaut aussi pour les archives. Une archive ZIP est lue, décompressée, migrée puis reconstruite dans l'onglet, sans qu'un seul octet transite. La décompression s'appuie sur une fonction native du navigateur plutôt que sur une bibliothèque tierce, ce qui évite d'ajouter trois cents kilooctets de code à charger — et un intermédiaire de plus à qui faire confiance.

Traiter un projet entier

Déposez une archive et chaque fichier est migré selon son extension : .php, .phtml, .inc côté PHP, .py côté Python, .sql côté base. Tout le reste — images, feuilles de style, fichiers de configuration — est recopié sans être touché, et l'arborescence est restituée à l'identique.

Les dossiers vendor/, node_modules/, .git/ et wp-admin/ sont ignorés par défaut : ce code appartient à des tiers, le réécrire ferait diverger le projet de sa source sans aucun gain, et la prochaine mise à jour effacerait le travail. La case se décoche si vous savez pourquoi vous le faites.

Un fichier source qui n'est pas en UTF-8 est recopié tel quel plutôt que réécrit : mieux vaut le laisser intact que le corrompre. Le rapport le signale ligne par ligne, fichier par fichier.

Les chaînes et les commentaires sont protégés

Avant toute transformation, le texte est parcouru pour repérer les chaînes, les commentaires et les heredocs, qui sont mis de côté. Un array( écrit dans un commentaire ou une parenthèse à l'intérieur d'une chaîne ne sont donc jamais confondus avec du code — c'est précisément là que se cassent les outils fondés sur de simples expressions régulières.