Aller au contenu

Avancé

Afficher au format Markdown Modifier sur GitHub Documentation de 5b53f69

Les détails internes. Si vous intégrez Phasis, vous pouvez ignorer cette section. Si vous modifiez le moteur, chaque page ici est essentielle.

Pages

  • Architecture — comment le code source devient exécutable : lexer → parseur → AST → compilation en bytecode → VM à bytecode avec repli sur l’interpréteur arborescent. Chargeur de modules, realms, rôle de Phasis\Engine comme frontière du realm.
  • VM à bytecode — jeu d’opcodes, boucle de dispatch, caches inline, chemin rapide de transpilation source JsToPhp, heuristique function-shape canSkipEnvAlloc, et cas où les appels suivent le chemin bytecode ou celui de l’interpréteur arborescent.
  • Benchmarks — chiffres bench/ actuels, leur interprétation, pourquoi ~100× V8 constitue le plafond en régime stable des interpréteurs arborescents et ce qui pourrait réduire l’écart.
  • Tests — modèle par oracle. Chaque changement est vérifié à l’aide de trois références indépendantes : Node.js (référence de la spécification V8), test262 et la suite d’égalité octet par octet pour les bibliothèques populaires.

Conventions de contribution

  • Ne touchez pas au moteur central sans raison sérieuse. Tout ce qui se trouve sous src/Runtime/, src/Bytecode/, src/Lexer/, src/Parser/, src/Regex/ est sur le chemin critique de test262. Le modifier sans vérification test262 correspondante risque fortement d'introduire des régressions. Les éléments intégrés (src/BuiltIn/) sont plus sûrs, car les sous-suites test262 de chaque élément intégré détectent localement les régressions.
  • Utilisez des traits pour organiser le code, pas des classes. Quand un fichier dépasse environ 2K lignes, répartissez-le dans des fichiers de traits sous un répertoire frère (src/BuiltIn/Temporal/, src/Runtime/Parts/, etc.) au lieu de créer de nouvelles classes — cela permet aux recherches self:: de fonctionner et évite de casser la surface des méthodes privées API.
  • Exécutez bin/verify-all localement avant de pousser vos modifications. Il exécute PHPStan, PHPCS, toutes les suites PHPUnit (unitaires, oracle, populaires, wpt) ainsi que la régression de l'oracle. La CI exécute les suites WPT et populaires lorsque des modifications touchent src/ ; la matrice test262 complète est lancée manuellement. Échantillonnez donc localement les catégories test262 concernées.
  • Pour chaque ajout à la plateforme Web API, ajoutez un fixture WPT. Déposez le .any.js de tests/Wpt/upstream/<area>/ dans tests/Wpt/fixtures/<category>/ et le runner le détectera.

Voir aussi