PHP文档block中以下内容的含义是什么:#@+zend框架代码中的一个例子:/**#@+*@conststringVersionconstantnumbers*/constVERSION_10='1.0';constVERSION_11='1.1';/**#@-*/我假设它用于对相关项目进行分组但无法确定。此外，它的语法非常奇怪-当从它生成文档时它是如何翻译的？ 最佳答案 这是一个文档blocktemplate，因此模板之间的每个可记录元素(本例中的每个常量)都具有相同的文档。 关于
虽然这个问题是关于DocBlocks的一般来说，我的用例是关于PHP的。考虑以下PHP代码:say_hi()->say_b|这只是一个带有一些链接的普通类。扩展类失去了类型提示，因为父类的文档block正在使用不具有子类的方法/属性的特定类名。假设我们确实需要类型提示功能，(如果不需要，请留下这个问题-我不想在这里使用无用的参数)，我应该如何解决这个问题？我想到了以下可能性:更改PHPDoc标准以允许使用特殊关键字添加一个多余的say_hi()方法，该方法调用父级只是为了重新声明docblock根本不指定返回类型，让IDE决定return$this;的含义(这是否有效？)
我正在使用AptanaStudio3进行PHP开发。我知道有一个用于为类和方法生成PHPDocblock的代码段(键入doc，按ctrl+space并插入适当的代码段)。问题是它只能用于新方法，doc_f片段插入如下内容:/***undocumentedfunction**@returnvoid*@author*/functionfunctionName(){}所以每当我有一个方法要记录时，我仍然必须手动插入所有关于参数和返回值的数据。我记得很久以前我在PDT(Eclipse)中使用过一个方便的热键(ctrl+shift+jIIRC)，它会自动为选定的元素填充所有那些PHPDoc参数，
这个问题在这里已经有了答案:关闭9年前。PossibleDuplicate:IsthereawayforphpDoctodocumentanarrayofobjectsasaparameter?我一直在搜索，并查看了phpDocumentor文档，但找不到是否有正确记录将被解析并包含在任何生成的@param数组(如声明预期的键/值类型)的方法文档。这会让我相信没有办法做到这一点，我将不得不使用该描述。提前致谢。
我有一个大型代码库，我正在尝试为其生成分层文档。该项目不使用命名空间，而是使用@package。我只是尝试使用phpDocumentor2从以下文件生成文档作为测试:虽然根据文档@packageJustAn\Example应该等同于命名空间JustAn\Example，但我发现情况并非如此。当我使用namespace时，生成的文档如下所示:当我使用@package表示法时，结果如下所示(即使它识别包表示法-这显示在类的完整详细信息页面上):我正在寻找一种方法来获得分层结果，而无需重写代码以使用“真实”命名空间。 最佳答案 问题是默认
我在ZF1的注释/文档中发现了一些特殊符号“#@+”和“#@-”。示例:/**#@+*@accessprotected*/(https://github.com/zendframework/zf1/blob/master/library/Zend/Mail.php#L54)我之前在另一个不同的存储库中看到过。这些是什么意思？ 最佳答案 它们是PHPDocBlock模板声明。文件中还应该有一个结束标记/**#@-*/。它允许您跨多个属性、方法或常量指定相同的文档。可以在此处找到更好的示例解释:http://codingexplaine
有时在我的代码中我喜欢注释掉一段代码以供临时使用/引用等，例如:/*blah*/但有个小烦恼是，如果我想在该block中插入一行，当我单击enter时，它会自动在下一行放置一个*，就好像我在做DocBlock一样。这发生在每个回车键上:/*blah**/现在我认为这种“自动格式化”应该只在开场评论使用格式/**(两颗星)时发生。多行注释在DocBlocks出现之前很久就已经存在了，所以我不确定为什么它会强制这些“老派”标准直截了当/**/注释具有不需要的额外DocBlock*!那么有没有办法:a)理想情况下-仅当开始标记为/**时才进行格式化b)或者如果它不能区分/*和/**，是否有办
我正在将PHP对象发送到模板文件，并且希望在我的模板文件的顶部记录对象的哪些属性(使用__get)可用以及它们是什么，并使它们可用于代码提示。这是一个例子。在我的Controller中:$obj=newTemplate("welcomePage");$obj->title="Welcome!";$obj->render();在我的View/模板中:titlestringThepageheadertext/*?>title;?>是否有类似的东西可以工作？如果我开始输入$obj->，我现在拥有的方式不会自动完成，这意味着我(或团队成员)需要引用模板的顶部来查找每个可用属性。我正在考虑为每个
在使用PHPDoc描述变量时，我对何时使用null作为类型感到困惑。类型提示是否应该描述外部调用者预期和遵守的希望和期望，或者它们是否应该记录变量的所有可能类型，即使希望它在实践中是一种非常具体的类型？示例1:默认值。以下函数只需要非空值。但如果没有传递任何值，它默认为null并明确检查该值作为确定是否传递任何内容的一种方式，并为该情况返回一个特殊值。希望没有外部调用者会传递除整数以外的任何内容。null应该像下面那样在@param类型中使用，还是应该只指定int因为这是我们想要传递的东西，如果有任何传递的话？/***@paramint|null$bar*/functionfoo($b
在Doctrine项目的docblock注释中，是否有一种标准方法来记录Collection中预期的实体类？像这样的东西:/***@varCollection*/protected$users;看起来PHPDoc现在是docblock注释的实际标准，但我找不到关于这个用例的任何提及。 最佳答案 这是一个解决方案，使您能够在Collection方法和您的objects方法上都有自动完成功能:/***@paramCollection|User[]$users*/publicfunctionfoo($users){$users->//au
