通过 Host Function，打开 WebAssembly 新世界

作者：DarumaDocker，主要负责 WasmEdge-bindgen 的开发工作。

WebAssembly 最初是从浏览器发展出来的，当 Wasm 慢慢从浏览器迁移到服务端的时候，面临的一大问题就是功能不完备、能力有限。WASI 的提出有望解决这些问题，但标准的制定与实施通常都是缓慢的。

如果你着急使用一个功能该怎么办呢？答案是使用 Host Function 来定制你的 WebAssembly Runtime。

什么是 Host Function

顾名思义, Host Function 就是定义在 Host 程序中的函数. 对于 Wasm 来说, Host Function 可以做为导入段 import 被注册到一个模块 module 中, 之后便可以在 Wasm 运行时被调用.

Wasm 目前的能力有限，但那些 Wasm 本身做不了的事情, 都可以依靠 Host Function 来解决, 这极大地扩展了 Wasm 的能力范围.

WasmEdge 在标准之外做的扩展基本都是依赖 Host Function 做的的，比如，WasmEdge 提供的 Tensorflow API, 是使用 Host Function 实现的，也因此实现了以原生速度运行 AI 推理的目标。

Networking socket 也是使用 host function 实现的，因此我们可以在 WasmEdge 运行异步 HTTP 客户端和服务器，弥补了 WebAssembly 在网络上的不足。

再比如 Fastly 使用 Host Function 为 Wasm 增加了 Http Request 和 Key-value store 等接口, 进而增添了扩展功能。

如何编写一个简单的 Host Function

让我们从一个最简单的例子入手, 来看看如何在一个 Go 程序里编写 Host function。

先来编写一个简单的 rust 程序。国际惯例，Cargo.toml 不能少。

Cargo.toml

[package]
name = "rust_host_func"
version = "0.1.0"
edition = "2021"

[lib]
crate-type = ["cdylib", "rlib"]

[dependencies]

再来看看 Rust 代码是什么样的。

lib.rs

extern "C" {
   
	fn add(a: i32, b: i32) -> i32;
}

#[no_mangle]
pub unsafe extern fn run() -> i32 {
   
	add(1, 2)
}

上述程序中的 add 函数被声明在 extern "C" 中, 这就是一个 Host Function。我们使用如下命令将这段 Rust 程序编译为 wasm:

cargo build --target wasm32-wasi --release

然后我们使用 wasm2wat 来查看 wasm 文件的导入段:

wasm2wat target/wasm32-wasi/release/rust_host_func.wasm | grep import

输出如下:

  (import "env" "add" (func $add (type 0)))

可以看到 add 函数被放到了默认名称为 env 的模块的导入段中.

接下来我们来看如何使用 WasmEdge-go SDK 来执行这段 wasm 程序.

hostfunc.go

package main

import (
	"fmt"
	"os"

	"github.com/second-state/WasmEdge-go/wasmedge"
)

func add(_ interface{
   }, _ *wasmedge.Memory, params []interface{
   }) ([]interface{
   }, wasmedge.Result) {
   
	// 将从 wasm 传过来的两个参数做加法运算
	return []interface{
   }{
   params[0].(int32) + params[1].(int32)}, wasmedge.Result_Success
}

func main