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.
2.3 KiB
2.3 KiB
增量编译缓存
TypePHP 的二次编译速度，很大程度上取决于对象文件缓存是否命中。编译器对两类源文件做内容指纹缓存：phpx 的 misc 源，以及编译器自己生成的 .cc 单元。
Sources: src/Translator.php
两类缓存
| 方法 | 适用对象 | 缓存键组成 |
|---|---|---|
hasMiscObjectFileCache() |
phpx/src/misc/*.cc |
编译命令 + PHP ABI（PHP_VERSION_ID / ZEND_MODULE_API_NO / PHP_ZTS / PHP_INT_SIZE 等）+ phpx 头文件 mtime |
hasGeneratedObjectFileCache() |
构建目录下的生成 .cc |
编译命令 + PHP ABI + 所有生成头文件内容指纹（func_decl.h / data_decl.h / 各 _arginfo.h） |
Sources: src/Translator.php · src/Translator.php
缓存键构造
hash('sha256',
buildCompileFileCommand(source, object) // 可复现的编译命令行
. "\0" . serialize($abi) // PHP ABI 快照
[. "\0" . header . "\0" . hash_file(header)] // 仅生成单元：逐头文件内容
)
键写入 <object>.typephp-cache 元数据文件（getMiscObjectCacheMetadataFile()）。每次 compileFile() 先比较元数据文件中的键，再比较 .o 与源/头的 mtime——任一不满足即失效并重编译。
Sources: src/Translator.php · src/Translator.php
设计要点
extension-<target>.cc故意不进共享头依赖：它的内容随任意类变化而改变，若纳入指纹会让每个.cc都失效，破坏增量构建。它自身作为生成单元拥有独立缓存项。--force/--profile强制失效：这两类参数会跳过全部缓存，确保 misc 文件也被重编（profiler 需PPROF_ON宏生效）。- 头文件依赖集排序后参与哈希，避免路径顺序差异导致误失效。
Sources: src/Translator.php · src/Translator.php