php - 有没有我可以用来表示实例化后添加的魔术方法属性的 PHP DocBlock？

Question

我正在将 PHP 对象发送到模板文件，并且希望在我的模板文件的顶部记录对象的哪些属性(使用 __get)可用以及它们是什么，并使它们可用于代码提示。

这是一个例子。

在我的 Controller 中:

$obj = new Template("welcomePage");
$obj->title = "Welcome!";
$obj->render();

在我的 View /模板中:

<?php 
/** 
 *    @var       $obj           Template    The template data wrapper
 *    @property  $obj->title    string      The page header text
/* ?>
<h1><?php echo $obj->title; ?></h1>

是否有类似的东西可以工作？如果我开始输入 $obj->，我现在拥有的方式不会自动完成，这意味着我(或团队成员)需要引用模板的顶部来查找每个可用属性。

我正在考虑为每个模板类型扩展 Template 类，但这似乎是不必要的开销，因为我可能只为每个页面添加一个字符串和一个数组，并为每个模板、部分模板和组合创建一个单独的类两者似乎都有点傻。

谢谢~

Answer 1

没有。 DocBlocks 文档类，而不是实例。

也就是说，PHPDocumentor 有许多类级别的注释标记来展示一些魔法:

• @property
• @property-read
• @property-write
• @method

但它不适用于在运行时动态添加的属性/方法，因为实例之间的属性不同。