草庐IT

php - eclipse PDT 中的错误 phpdoc 错误

我目前将EclipsePhotonPDT用于一个旧的PHP应用程序。在这个应用程序中有很多phpdoc注释,但其中一些被标记为错误。for"@paramunknown$form"=>"unknown无法解析为类型"。同上“@returnAmbigous”=>“Ambigouscannotberesolvedtoatype”。有人知道如何禁用这些错误吗?(因为我所有的项目文件都标有错误图标,我看不到哪些文件确实有错误)。 最佳答案 最简单的短期修复是禁用该级别的错误检查:项目->属性PHP->验证->错误/警告启用项目特定设置Unde

php - 使 PHPdoc 包含 CakePHP .ctp 文件

我正在使用PHPdocumentor记录我的CakePHP应用程序.您可能知道,在CakePHP约定之后,View包含在.ctp文件中(例如app/views/addresses/index.ctp),这些文件基本上是普通的PHP文件,只是文件扩展名发生了变化。PHPdocumentor只识别.php文件,我在配置文件中找不到一个选项让它知道.ctp文件。这部分最接近我想要的:;;comma-separatedlistoffilestoparse;;legalvalues:pathsseparatedbycommas;filename=/path/to/file1,/path/to/f

php - PHPDoc 的@param 注释的有效值是什么?

我正在阅读PHPdocsthis:ThedatatypeshouldbeavalidPHPtype(int,string,bool,etc),"whichisfine,buttheydon'tsaywhichstrings(suchasint,string,bool)tousetoidentifytheothertypes.我猜他们使用(cast)语法来确定要用于注释的类型,但是像PHP中的float这样的东西没有用于它的cast运算符,所以我不确定该使用什么为了那个原因。可能是float,也可能是fp。有没有人有PHP中基本类型的明确列表,以及在您的PHP文档中应该使用什么字符串来识

php - 是否可以在 PHPDoc 的调用方为参数指定显式类型

有一个方法调用表达式:$session->setUser($this->em->getReference(UserAccount::class,$ownerId));其中setUser声明为publicfunctionsetUser(UserAccount$user):self$this->em->getReference作为Doctrines的实体管理器方法返回object|null。因此PhpStorm将此调用标记为不匹配的参数类型。我当然可以将其拆分为2个语句并键入:/**@varUserAccount$userAccount*/$userAccount=$this->em->g

php - 如何在 PhpDoc 文档 block 中使用 NetBeans 和 SVN @version 标记?

我使用NetBeans作为我的phpide,我在文档block中看到了@version标签,看起来像这样:@version$IdsomeinfoandtimestampNetBeans是否有办法在每次提交时自动更新它?还是我完全忽略了这个标签的要点? 最佳答案 嗯,不,Netbeans没有办法。但是颠覆确实...确切的标签是$Id$,它对应于svn属性svn:keywords=Id。找到配置文件(在Linux上,它通常在~/.subversion/config下。在Windows上,我在~\ApplicationData\Subve

php - 如何解释 `@property-read` 和 `@property-write` 的 PHPDoc 属性?

鉴于phpDocmanual,我找不到关于那个的解释@property-read@property-write但仅限于@property。他们是做什么的? 最佳答案 Here'sagoodexplanation关于魔法属性。基本上,@property-write被解释为-顾名思义-为只写属性。例如,Eclipse中的代码完成就利用了它。如果您的魔法属性foo被声明为“只写”,当您键入$a=$this->f时,它不会出现在代码完成中。 关于php-如何解释`@property-read`和

php - 如何在 Eclipse 中使用 PHPdoc

我们目前正处于一个新项目的开始,并希望(一次)从一开始就尽可能多地发表评论,以帮助future的发展。我试图找出在Eclipse中使用phpDoc的最佳实践,但收效甚微。您能否分享在Eclipse中使用phpDoc评论内容的最佳实践和技巧? 最佳答案 关于应该评论什么以及如何评论,没有“真正的标准”,但是几乎所有评论他的代码的人都会使用一些标签。例如,我通常至少使用:简短描述可选地,一个详细的描述@paramtypenamedescription:用于函数/方法的参数@returnstype:用于函数/方法的返回值@throwsEx

php - 为 phpdoc 声明大量变量而不用/**开头

我有很多变量的对象,我在注释中声明和解释了这些变量。我正在为以后使用phpDoc进行处理做非常详尽的评论,但是我还没有实际编译文档的经验。我发现使用phpDoc符号非常烦人,即使我想要设置的唯一属性是描述,每个变量也会占用四到六行代码:/***@descthisisthedescription*/var$variable=null;我想使用以下符号:#@descthisisthedescriptionvar$variable=null;有没有一种简单的方法可以调整phpDoc以接受它,或者当我实际尝试从中编译文档时它会给我带来麻烦吗?我现在不需要调整(尽管它当然值得赞赏),只是了解ph

php - 这些 PHPDOC 属性的用途是什么?

一般来说,PHPDOC属性是不言自明的,但我很难理解这些属性:@category-这到底是什么?@package-有人可以提供有关此属性用法的示例吗? 最佳答案 包标签是您在代码中使用的关键组织标签。当phpDocumentor生成文档时,它会将元素收集到您设置的包中。在某些情况下,您可能会选择对整个代码库只使用一个包名称(@packageMyPackage),这样所有文件、类等都会出现在该包的文档中。但是,如果您选择更模块化地组织事物,您可以将所有面向Web的过程文件放在一个包中(@packageWebpages),将所有面向数据

phpDoc PDF模板

我对可用于phpDocs的各种HTML模板感到非常满意。我想知道我的PHP应用程序是否有其他PDF模板,我正在将其作为顶点项目编写,并希望将其作为我论文的补充。默认的PDF模板似乎忽略了一些@tags,并且有很多不适当的空格问题。如果其他地方没有用户提交的PDF模板,我应该去哪里学习如何编辑默认设置,例如,调整空白问题和更改字体/字体大小等?或者,对于专门处理PDF格式的phpDoc,是否有更好的替代方案?一些HTML文件非常漂亮,但没有作为整个文档打印的选项。谢谢 最佳答案 作为最后的选择,您可以试试wkhtmltopdf[1]。