# 跨平台支持 TypePHP 目标 **Windows / Linux / macOS** 三大桌面平台，通过 `Platform` 抽象隔离系统差异（编译器名、目标扩展名、PHP embed 库查找等）。 Sources: [src/Translator.php](src/Translator.php#L164-L190) · [src/Platform/](src/Platform/) ## 平台抽象 `PlatformFactory::create()` 按 OS 返回具体 `Platform` 对象（Windows / Linux / macOS）。`detectPlatform()` 在 `Translator` 构造时调用，得到平台名 + 后端名（如 `Windows + MSVC`）。 Sources: [src/Translator.php](src/Translator.php#L164-L190) ## 各平台要点 | 平台 | 默认后端 | 链接产物 | 特殊点 | |---|---|---|---| | Linux | GCC/Clang | ELF 可执行 / `.so` | 推荐 Ubuntu 22.04，需 `libphp.so` | | macOS | Clang | Mach-O / `.dylib` | `strip` 可选 | | Windows | MSVC | PE `.exe` / `.dll` | 需 Windows SDK + `php8ts.lib`；资源文件编译 | Windows 分支会额外 `detectPhpLibs()` 探测 embed 与 core 的 `.lib`，并把 `isZts`、SDK 路径注入 `Windows` 对象。 Sources: [src/Translator.php](src/Translator.php#L170-L181) · [README.md](README.md#L42-L43) ## Windows 资源文件 `bin` 模式在 Windows 下编译 `.rc`（图标、版本信息、UAC 等，由 `project.yml` 的 `resource` 配置），生成的 `.res` 在 `build()` 链接时并入。资源文件生成见 `Generator/ResourceFileGenerator` 与 `Build/ResourceCompilationTrait`。 Sources: [project.yml](project.yml#L10-L24) · [src/Translator.php](src/Translator.php#L1653-L1659) · [src/Build/ResourceCompilationTrait.php](src/Build/ResourceCompilationTrait.php) ## libphp.so 自动安装 Linux 缺 `libphp.so` 时，`tpc.php` 可交互式下载 PHP 源码并自动构建，详见 `docs/LIBPHP_INSTALLER.md`；安装器逻辑在 `src/Installer/`。 Sources: [README.md](README.md#L27) · [src/Installer/](src/Installer/) ## 相关阅读 - 后端命令如何生成 → [编译器后端](backend) - 链接与资源并入 → [构建流水线](build-pipeline) - 二进制打包（UPX/strip） → README 的 Release packaging 段