Travailler avec WebAssembly et PHP : de A à Z

Introduction à WebAssembly et PHP

WebAssembly (Wasm) est un format d'instructions binaires de bas niveau qui s'exécute dans une machine virtuelle avec des performances proches du natif. Dans le contexte de PHP, il ouvre de nouveaux horizons : vous pouvez exécuter du code C, C++, Rust ou Go directement depuis un script PHP, sans quitter l'environnement serveur. Cela est particulièrement utile pour les tâches gourmandes en ressources — traitement d'images, cryptographie, analyse de données ou calculs mathématiques.

Dans cet article, nous allons parcourir le cycle complet de travail : de la compilation du code source en Wasm à l'appel de fonctions depuis PHP à l'aide des extensions wasmtime et wasmer. Vous apprendrez comment améliorer les performances des applications PHP en utilisant la puissance du code machine.

Fondamentaux de WebAssembly : ce qu'un développeur PHP doit savoir

Architecture de Wasm

WebAssembly fonctionne dans un bac à sable (sandbox) isolé. Un module Wasm n'a pas d'accès direct au système de fichiers, au réseau ou à la mémoire de l'hôte — seulement à sa mémoire linéaire et aux fonctions exportées. Cela garantit la sécurité, mais nécessite une gestion explicite des données.

Concepts clés :

\n
• Module — fichier binaire compilé (.wasm)
\n
• Exportations — fonctions et variables accessibles depuis l'extérieur
\n
• Importations — fonctions que l'hôte (PHP) fournit au module
\n
• Mémoire linéaire — tableau continu d'octets manipulé par le module
\n

Outils pour travailler avec Wasm en PHP

Il existe deux extensions principales :

\n
• Wasmtime — de Bytecode Alliance, la plus populaire et stable
\n
• Wasmer — alternative avec support de multiples backends (Cranelift, LLVM, Singlepass)
\n

Installation via Composer :

composer require wasmtime/wasmtime-php\n# ou\ncomposer require wasmer/wasmer

Il faudra également installer la bibliothèque système Wasmtime ou Wasmer. Pour Ubuntu :

curl https://wasmtime.dev/install.sh -sSf | bash\n# ou\ncurl https://get.wasmer.io -sSfL | sh

Compilation de C/C++ en WebAssembly

Pour la compilation, nous utilisons Emscripten — une boîte à outils basée sur LLVM/Clang. Installation :

git clone https://github.com/emscripten-core/emsdk.git\ncd emsdk\n./emsdk install latest\n./emsdk activate latest\nsource ./emsdk_env.sh

Exemple : fonction de somme en C

Créons un fichier math.c :

#include <emscripten.h>\n\nEMSCRIPTEN_KEEPALIVE\nint add(int a, int b) {\n    return a + b;\n}\n\nEMSCRIPTEN_KEEPALIVE\nint factorial(int n) {\n    if (n <= 1) return 1;\n    return n * factorial(n - 1);\n}

Compilons en Wasm :

emcc math.c -o math.wasm -s WASM=1 -s EXPORTED_FUNCTIONS='["_add","_factorial"]' -s EXPORTED_RUNTIME_METHODS='["ccall","cwrap"]' -O3

Le flag -O3 active l'optimisation maximale. Le fichier math.wasm est prêt à être utilisé.

Intégration de Wasm avec PHP : exemples pas à pas

Scénario 1 : Utilisation de Wasmtime

Installez l'extension et écrivez le code PHP suivant :

<?php\nrequire 'vendor/autoload.php';\n\nuse Wasmtime\\Engine;\nuse Wasmtime\\Module;\nuse Wasmtime\\Store;\nuse Wasmtime\\Func;\nuse Wasmtime\\Val;\n\n// Chargement du module\n$engine = new Engine();\n$module = Module::fromFile($engine, 'math.wasm');\n$store = new Store($engine);\n\n// Création de l'instance\n$instance = new Wasmtime\\Instance($store, $module, []);\n\n// Récupération de la fonction exportée\n$add = $instance->getExport($store, 'add');\n$factorial = $instance->getExport($store, 'factorial');\n\n// Appel des fonctions\n$resultAdd = $add->call($store, 5, 7);\n$resultFact = $factorial->call($store, 10);\n\necho "5 + 7 = " . $resultAdd[0]->i32() . "\\n"; // 12\necho "10! = " . $resultFact[0]->i32()