# PHPX 运行时集成 TypePHP 不是从零实现 PHP 语义，而是站在 **PHPX**（Swoole 的 C++ PHP 绑定库）与 **Zend 引擎 embed** 之上。生成的 C++ 大量调用 `phpx.h` 提供的 `php::` 命名空间 API，最终把 Zend 引擎链接进产物。 Sources: [src/Translator.php](src/Translator.php#L79-L89) · [README.md](README.md#L44-L61) ## 全局头文件 `Translator::$globalHeaders` 列出每个编译单元默认包含的头： ```php ['cstring', 'phpx.h', 'phpx_helper.h', 'phpx_big_int.h', 'phpx_big_float.h', 'phpx_decimal.h', 'typephp_helper.h', 'typephp_fiber_generator.h', 'phpx_std.h'] ``` 高精度类型（`BigInt`/`BigFloat`/`Decimal`）的头正是此处引入；`typephp_*` 是 TypePHP 自带的扩展头（Fiber/Generator、helper）。 Sources: [src/Translator.php](src/Translator.php#L79-L89) ## 运行时依赖源 `compile()` 会追加 phpx 的 `src/misc/` 源文件（C++ 运行时实现），以及 embed 模式下的 `typephp_main.cc`、bin 模式下的 cli 标题源。这些 misc 源受 [增量编译缓存](incremental-cache) 的 ABI 指纹保护。 Sources: [src/Translator.php](src/Translator.php#L1423-L1434) ## 关键运行时能力 - **Fiber / Generator**：`typephp_fiber_generator.cc/.h` 提供协程与生成器支持，详见 `docs/YIELD_GENERATOR.md`； - **混合 C++/PHP**：可在工程中直接写 C++ 并与 PHP 互调，见 `docs/MIXED_CPP_PHP.md`； - **反射**：`typephp_install_reflection_attribute_handlers()` 在 MINIT 安装反射/属性处理器； - **类继承**：PHP 类到 C++ 的映射与 `extends` 处理见 `docs/CLASS_INHERITANCE.md`。 Sources: [src/Translator.php](src/Translator.php#L887-L890) · [docs/YIELD_GENERATOR.md](docs/YIELD_GENERATOR.md) · [docs/MIXED_CPP_PHP.md](docs/MIXED_CPP_PHP.md) · [docs/CLASS_INHERITANCE.md](docs/CLASS_INHERITANCE.md) ## 动态链接库 运行时要求 `libphp.so`（Linux）/ `php8ts.lib`（Windows）与 `libphpx.so` 就位；缺库时可用 `docs/LIBPHP_INSTALLER.md` 自动构建。 Sources: [README.md](README.md#L57-L70) · [docs/LIBPHP_INSTALLER.md](docs/LIBPHP_INSTALLER.md) ## 相关阅读 - 产物如何被链接 → [构建流水线](build-pipeline) - 跨平台库差异 → [跨平台支持](platform) - 哪些 PHP 特性尚不支持 → [不支持的 PHP 特性](incompatible-features)