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.
45 lines
2.5 KiB
45 lines
2.5 KiB
<blog>
|
|
|
|
# AST 转换（Lowering）
|
|
|
|
在 `doConvert()` 遍历 AST 时，`src/Transform/Visitor.php` 作为 `NodeVisitor` 挂载在遍历链上，对节点做**编译期改写（lowering）**——把 PHP 8.x 的高层语法（属性钩子、构造函数提升、getter、编译期属性等）降级为编译器能直接翻译的普通结构。
|
|
|
|
Sources: [src/Transform/Visitor.php](src/Transform/Visitor.php#L19-L36) · [src/Translator.php](src/Translator.php#L2462)
|
|
|
|
## 两个遍历钩子
|
|
|
|
`Visitor` 实现 `enterNode()` 与 `leaveNode()` 两阶段处理：
|
|
|
|
- **enterNode**（进入节点前）：校验 + 即时 lowering。依次调用 `CompileTimeAttribute::validateNode`、`FunctionAttributeLowering::lower`、`GetterLowering::validateTarget`、`PropertyMethodLowering::validateTarget`、`ConstructorLowering::validateTarget`。
|
|
- **leaveNode**（离开节点后）：对函数/闭包做 `ParameterValidationLowering`；对类/属性做 `PropertyHookLowering`、`GetterLowering`、`PropertyMethodLowering`，把钩子属性、getter、提升属性改写成方法或标记。
|
|
|
|
Sources: [src/Transform/Visitor.php](src/Transform/Visitor.php#L28-L80)
|
|
|
|
## Lowering 算子清单
|
|
|
|
| 类 | 作用 |
|
|
|---|---|
|
|
| `CompileTimeAttribute` / `CompileTimeAttributeRegistry` | 识别并校验编译期属性（如 `Any`、`MustUse`） |
|
|
| `FunctionAttributeLowering` | 处理函数上的编译期属性 |
|
|
| `ConstructorLowering` | 处理构造函数提升参数 |
|
|
| `GetterLowering` | `get` 钩子属性 → getter 方法 |
|
|
| `PropertyHookLowering` | `get`/`set` 钩子属性 → 访问器方法 |
|
|
| `PropertyMethodLowering` | 属性 ↔ 方法互转 |
|
|
| `ParameterValidationLowering` | 参数类型校验，拒绝箭头函数误用 |
|
|
| `PrinterLowering` / `ValidateLowering` | 打印/校验相关降级 |
|
|
| `ArrayableLowering` / `NotEmptyLowering` / `NotNullLowering` | 特定表达式降级 |
|
|
| `RuntimeAttributeFactoryLowering` | 运行时工厂属性（遍历链上独立挂载） |
|
|
|
|
Sources: [src/Transform/](src/Transform/) · [src/Translator.php](src/Translator.php#L2467)
|
|
|
|
## 顺序意义
|
|
|
|
Lowering 必须早于 C++ 生成：例如属性钩子若不先降级成方法，后续 `genClassWrapper` 就无法生成对应的 C++ 访问逻辑。它处在 [解析器与 AST](parser) 之后、[代码生成](generator) 之前。
|
|
|
|
## 相关阅读
|
|
|
|
- 编译期属性语义 → [编译期属性](compile-time-attributes)
|
|
- 降级后如何发射 C++ → [生成器总览](generator)
|
|
- 常量表达式校验 → [类型检查与兼容](type-check)
|
|
|
|
</blog>
|
|
|