- XF 兼容性
- 2.3.x
- 摘要
- XenForo type generator tool fills gaps left by core, types board options, XFCP proxies, and cross-addon columns. Use xf-typegen with --out to generate PHPStorm metadata JSON files for better IDE support. Open source at https://github.com/wh1teend/xf-typegen.
XenForo already types most of its own runtime magic — xf-dev:generate-phpstorm-meta (shipped in 2.2 and 2.3) resolves the string-style call sites, entities ship full @property, and on 2.3 generics handle the ::class style and the finder chain. This tool is narrow on purpose: it fills the few gaps core leaves.
What core doesn't type, either version:
If you're on 2.3 and none of those bite you, the stock dev tools already cover you.
Open source (MIT), prebuilt for Linux / macOS / Windows:
https://github.com/wh1teend/xf-typegen
What core doesn't type, either version:
- Board options — \XF:😱ptions()->boardTitle is mixed; this gives it a real type.
- XFCP proxies — class Foo extends XFCP_Foo points at a runtime-built class with no file, flagged undefined; this declares them.
- Cross-add-on columns — a column another add-on adds to an entity via XFCP isn't in that entity's shipped @property; this reads the composed structure, so they're included.
If you're on 2.3 and none of those bite you, the stock dev tools already cover you.
- _ide_helper_options.php — one typed property per board option.
- _ide_helper_xfcp.php — declarations for the runtime XFCP_* proxies.
- _ide_helper.php — typed Finder/Collection stubs (mainly for 2.2) + entity @property from the composed structure.
- .phpstorm.meta.php — string-style call-site resolution (duplicates xf-dev:generate-phpstorm-meta; skip with --targets options,xfcp,ide-helper).
代码：
xf-typegen extract /path/to/xenforo --out /path/to/xenforo/xf-typegen.json
xf-typegen generate -i /path/to/xenforo/xf-typegen.json
Keep the _ide_helper*.php files out of your PHP autoload — static analysis only.Open source (MIT), prebuilt for Linux / macOS / Windows:
https://github.com/wh1teend/xf-typegen
