TypePHP 编译器
https://swoole.com/aot/
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
61 lines
1.9 KiB
61 lines
1.9 KiB
# TypePHP WASI Browser Lab
|
|
|
|
这是一个由 `project.yml` 构建的完整 TypePHP/WASI 0.2 浏览器应用。PHP 代码编译成一个自包含的 Component，Jco 将同一个 Component 转译为浏览器 ESM，页面通过 module Worker 加载它。
|
|
|
|
Demo 展示以下已支持能力：
|
|
|
|
- 命令行参数、环境变量与标准输入/输出
|
|
- WASI wall clock 和 PHP `time()` / `date()`
|
|
- 安全随机数 `random_int()` / `random_bytes()`
|
|
- 内存文件系统，以及可选的 OPFS 快照持久化
|
|
- PHP 8.5 runtime 信息
|
|
- TypePHP 语言级 BigInt、Decimal、BigFloat 高精度计算
|
|
|
|
网络、进程、shell、信号、Fiber 和 Generator 明确不支持。
|
|
|
|
## 构建
|
|
|
|
先确保 WASI SDK 和 Wasmtime 已加入 `PATH`，然后在本目录执行：
|
|
|
|
```bash
|
|
npm ci
|
|
npm run wasm
|
|
```
|
|
|
|
等价的仓库根目录命令是：
|
|
|
|
```bash
|
|
php bin/tpc.php examples/wasm-hello/project.yml
|
|
```
|
|
|
|
`project.yml` 控制全部项目路径：
|
|
|
|
- `sources: src`：TypePHP 源码
|
|
- `build-dir: build`：生成的 C++ 与目标文件
|
|
- `output: component/wasm-hello.wasm`：WASI 0.2 Component
|
|
- `wasm: true`：项目自动进入 WASI browser 构建，无需命令行 `--wasm`
|
|
- `wasm-browser-dir: generated`：Jco 浏览器模块
|
|
|
|
Jco 是本项目的开发依赖。先执行 `npm ci`，之后通过 `npm run wasm` 构建时，npm 会自动把本地 `node_modules/.bin/jco` 加入 `PATH`。
|
|
|
|
若只需要供 Wasmtime 使用的 Component，可以绕过 Jco：
|
|
|
|
```bash
|
|
php ../../bin/tpc.php project.yml --wasm=component
|
|
```
|
|
|
|
## 浏览器运行
|
|
|
|
```bash
|
|
npm run dev
|
|
```
|
|
|
|
打开终端显示的本地地址。可以修改参数、环境变量和 stdin 后重复运行；勾选 OPFS 后，PHP 写入虚拟文件系统的运行次数会跨页面刷新保存。
|
|
|
|
生产构建：
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
`src/` 是 TypePHP 应用，`typephp-worker.mjs` 是浏览器 WASI host，`main.js` 和 `style.css` 负责交互界面。`build/`、`component/`、`dist/`、`generated/` 均为可重新生成的输出。
|
|
|