Skip to content

Build Webman

supdger edited this page Sep 30, 2026 · 1 revision

构建 Webman 项目

目标是在 macOS Apple Silicon 或 Windows x64 上生成 Linux amd64 的 dist-aot/。先安装工具,并在普通 PHP 环境完成项目依赖安装和项目自身回归。适用依赖见兼容性。

在后端根目录构建

进入含 composer.json、composer.lock、start.php、app/ 的项目目录。以下命令在 macOS 终端、Windows PowerShell / CMD 中相同:

webman-aot doctor
webman-aot build --profile=webman
webman-aot verify --path=dist-aot

doctor 会检查环境并准备缺少的组件,可能联网下载;只检查可用 doctor --check。build 在 .webman-aot-builder/ 的隔离副本中编译并校验,不改普通 PHP 业务源码。构建期间不要改源码或依赖。

判断结果

每个构建阶段都有状态;命令成功退出并生成 dist-aot/ 后,独立 verify 会输出 Checked … managed files、直接编译与 AOT 副本数量、target ldd 状态。本机没有目标 Linux 的 ldd 时不会据此声称已完成目标运行验收。

整个 dist-aot/ 一起部署,见产物与配置和部署到 Linux。失败按常见问题定位。安装引导已自动构建与验证时,无需重复本步骤。

Clone this wiki locally