WebAssembly 与 PHP 集成：实用指南

介绍：为什么 PHP 需要 WebAssembly？

WebAssembly (Wasm) 是一种低级二进制指令格式，允许以接近原生的速度执行用 C、C++、Rust 等语言编写的代码。在 PHP 的上下文中，与 WebAssembly 集成开辟了新的可能性：从执行服务器端的计算密集型任务，到移植现有库而无需用 PHP 重写它们。

PHP 是一种脚本语言，传统上在性能上落后于编译型语言。然而，借助 WebAssembly，你可以：

• 在 Wasm 模块上执行速度关键的算法（图像处理、加密、解析）。
• 在 PHP 应用程序中使用现有的 C/C++ 库。
• 通过优化的二进制代码减少服务器负载。

在本文中，我们将探讨如何在实际中集成 WebAssembly 和 PHP：从加载模块到传递数据和处理结果。

1. 在 PHP 中使用 WebAssembly 的基础知识

要在 PHP 中使用 Wasm，需要用到 wasm 扩展（或用于 PHP 的 wasmer）。通过 Composer 进行安装：

composer require wasm/wasm

安装完成后，你可以加载并执行 Wasm 模块。让我们看一个简单的例子：一个对两个数求和的 C 模块。

首先，将 C 代码编译成 Wasm：

// sum.cint add(int a, int b) {    return a + b;}

编译（需要 Emscripten 或 wasi-sdk）：

emcc sum.c -o sum.wasm -s WASM=1 -s EXPORTED_FUNCTIONS='["_add"]'

现在在 PHP 中加载模块并调用函数：

<?phpuse Wasm\\Instance;use Wasm\\Module;

// 加载二进制文件$wasmBytes = file_get_contents('sum.wasm');$module = new Module($wasmBytes);$instance = new Instance($module);

// 调用导出的 add 函数$result = $instance->add(10, 20);echo "结果: " . $result; // 30?>

这段代码简单直观：我们创建一个模块实例，并将其函数作为 PHP 对象的方法来调用。重要的是要记住，Wasm 函数处理的是原始类型（int, float），因此复杂的数据结构需要额外的处理。

2. 传递复杂数据：字符串和数组

WebAssembly 只操作数字。要传递字符串或数组，你需要在 Wasm 模块内部分配内存并传递指针。让我们看一个字符串处理的例子。

创建一个将字符串转换为大写的 C 模块：

// uppercase.c#include <string.h>#include <ctype.h>

void to_upper(char* str, int len) {    for (int i = 0; i < len; i++) {        str[i] = toupper(str[i]);    }}

编译并导出内存函数：

emcc uppercase.c -o uppercase.wasm -s WASM=1 -s EXPORTED_FUNCTIONS='["_to_upper", "_malloc", "_free"]' -s ALLOW_MEMORY_GROWTH=1

用于调用的 PHP 代码：

<?php$wasmBytes = file_get_contents('uppercase.wasm');$module = new Module($wasmBytes);$instance = new Instance($module);

$input = "hello webassembly";$len = strlen($input) + 1; // +1 用于空字符终止符

// 在 Wasm 模块中分配内存$ptr = $instance->malloc($len);// 将字符串写入模块的内存$instance->memory->write($ptr, $input);

// 调用转换函数$instance->to_upper($ptr, $len);

// 从内存中读取结果$result = $instance->memory->read($ptr, $len);echo "结果: " . trim($result); // HELLO WEBASSEMBLY

// 释放内存$instance->free($ptr);?>

这种方法需要手动管理内存，但能让你完全控制数据。为了简化操作，你可以使用封装库，例如 wasm-php-bridge。

3. 处理