用途:在 WordPress Playground 仓库中重新编译 PHP.wasm 主模块和动态扩展侧模块(side modules),面向 Web 与 Node.js 平台。
主要能力:提供按 PHP 版本、平台与模式(jspi/asyncify)重编译的命令模板,例如 npx nx recompile-php:all php-wasm-web -- --PHP_VERSION=8.5;支持调试构建(--WITH_DEBUG=yes)与 source map(--WITH_SOURCEMAPS=yes)。构建管线位于 packages/php-wasm/compile/,关键文件含 Dockerfile、Makefile、build.js、.emcc-php-wasm-flags、replace.sh。
使用方式:需 Docker、Node.js(版本见 .nvmrc)与 npm。先清理缓存:node node_modules/.bin/nx reset 与 docker rmi php-wasm:latest;再执行 nx 重编译命令。侧模块需最小 PHP 安装(phpize 与头文件),关键 Emscripten 要求包括 -sSIDE_MODULE、--without-pcre-jit 等。
适用场景:重编译 PHP、添加 Emscripten 标志、修改构建配置、排查 WASM 加载与运行时问题。可用 wasm-objdump、wasm-opt 检查导入导出与 Asyncify 插桩。
限制:MAIN_MODULE 存在链接器限制,.so 与 --whole-archive 可能触发 SIGSEGV,需改用显式 .a 路径;libtool 无法直接生成 WASM 共享库,需绕过或补丁;非 PIC 预编译归档会导致 R_WASM_MEMORY_ADDR_SLEB 重定位错误;BuildKit 缓存需通过删除镜像强制重建。具体费用与平台支持暂未提供。