草庐IT

php - 使用 PHP7 时,是否需要用 PHPDoc 记录方法?

在PHP7中,当一个方法设置给定的参数类型和结果类型时,是否有必要在PHPDoc中再次记录它们?自functionfoo(string$text):bool{returntrue;}相当于/***@paramstring$text*@returnbool*/functionfoo($text){returntrue;}是否有必要复制这些信息?/***@paramstring$text*@returnbool*/functionfoo(string$text):bool{returntrue;}编辑:我不使用PHPDoc生成我的代码文档,而是在PHPStorm的帮助下为我和我的同事保持方

phpDocumentor - 无法打开输入文件 : phpdoc. php

我正在尝试使用phpDocumentor(这是第一次,我不知道自己在做什么)。实际上,我只想将它与SublimeText2和this一起使用插入。你能一步步指导我怎么做才能让它发挥作用吗?这是我现在所做的:(我使用的是Windows7)从here下载phpDocumentor并将其放置在某个地方。我已经为phpdoc/bin创建了系统路径(因此phpdoc.bat可以由sublime插件执行),然后还添加了php的系统路径(来自WAMPserver安装)当我尝试使用我的插件(或在控制台窗口中执行phpdoc)时,我得到这个错误:无法打开输入文件:\phpdoc.php

phpDocumentor - 无法打开输入文件 : phpdoc. php

我正在尝试使用phpDocumentor(这是第一次,我不知道自己在做什么)。实际上,我只想将它与SublimeText2和this一起使用插入。你能一步步指导我怎么做才能让它发挥作用吗?这是我现在所做的:(我使用的是Windows7)从here下载phpDocumentor并将其放置在某个地方。我已经为phpdoc/bin创建了系统路径(因此phpdoc.bat可以由sublime插件执行),然后还添加了php的系统路径(来自WAMPserver安装)当我尝试使用我的插件(或在控制台窗口中执行phpdoc)时,我得到这个错误:无法打开输入文件:\phpdoc.php

PHPDoc 和 __callStatic

tl;dr注释(在PHPDoc中)通过__callStatic实现的函数的正确方法是什么?更重要的是:有没有办法让NetBeans和PHPStorm理解这些是静态方法?动机如果您想了解更大的图景,这就是我如何回答这个问题的。问题:在我当前的项目中,我们有大量的类实际上应该是单例(数据库代理等)。不用说,我们至少有几百行require_once和$foo=newFooProxy();行。解决方案:我创建了一个Loader类来解决这个问题,使用__callStatic魔术方法所以我们可以只说$foo=加载器::FooProxy();。它非常适合我们的目的,但是:问题:这种方式在团队中使用的

PHPDoc 和 __callStatic

tl;dr注释(在PHPDoc中)通过__callStatic实现的函数的正确方法是什么?更重要的是:有没有办法让NetBeans和PHPStorm理解这些是静态方法?动机如果您想了解更大的图景,这就是我如何回答这个问题的。问题:在我当前的项目中,我们有大量的类实际上应该是单例(数据库代理等)。不用说,我们至少有几百行require_once和$foo=newFooProxy();行。解决方案:我创建了一个Loader类来解决这个问题,使用__callStatic魔术方法所以我们可以只说$foo=加载器::FooProxy();。它非常适合我们的目的,但是:问题:这种方式在团队中使用的

php - 如何使用 PHPDoc 符号声明局部变量的类型?

我使用ZendStudio用CakePHP进行PHP开发,而CakePHP的问题之一是View都引用了未声明的局部变量。例如,在Controller中你会$this->set('job',newMyJobObject());那么在View中你可以echo$job->getName();我的问题是ZendStudio无法对$job执行自动完成,因为它的类型未知。现在有PHPDoc标记允许您声明类型,以便IDE可以执行自动完成。例如,@var标签可以在类中用于定义属性的类型。classMyJobObject{/***@varMyStatusObject*/public$status;}有没

php - 如何使用 PHPDoc 符号声明局部变量的类型?

我使用ZendStudio用CakePHP进行PHP开发,而CakePHP的问题之一是View都引用了未声明的局部变量。例如,在Controller中你会$this->set('job',newMyJobObject());那么在View中你可以echo$job->getName();我的问题是ZendStudio无法对$job执行自动完成,因为它的类型未知。现在有PHPDoc标记允许您声明类型,以便IDE可以执行自动完成。例如,@var标签可以在类中用于定义属性的类型。classMyJobObject{/***@varMyStatusObject*/public$status;}有没

PHPDoc:用可变数量的参数记录函数

记录接受可变数量参数的类方法的推荐方法是什么?也许是这样的?注意:作为一般规则,我认为应该尽可能避免这种类型的事情。话虽这么说,但最好还是记录其余少数无法避免的情况。 最佳答案 如果您使用可变数量的参数并且还使用PHP>=5.6那么您可以使用仍然符合PHPDoc的可变参数函数(允许可变数量的参数),...语法已经提到,PHPStorm也将正确解释文档。使用可变参数函数无需func_get_args()将参数捕获到数组中。/***@parammixed$args,...Explainatorium!*/functionvariadic

PHPDoc:用可变数量的参数记录函数

记录接受可变数量参数的类方法的推荐方法是什么?也许是这样的?注意:作为一般规则,我认为应该尽可能避免这种类型的事情。话虽这么说,但最好还是记录其余少数无法避免的情况。 最佳答案 如果您使用可变数量的参数并且还使用PHP>=5.6那么您可以使用仍然符合PHPDoc的可变参数函数(允许可变数量的参数),...语法已经提到,PHPStorm也将正确解释文档。使用可变参数函数无需func_get_args()将参数捕获到数组中。/***@parammixed$args,...Explainatorium!*/functionvariadic

php - 在 PHPDoc 中记录数组选项的最佳方式?

我正在努力编写可读且易于理解的文档来描述传递给函数的数组选项的多树结构。这是一个示例数组结构。$arr=['fields'=>['title'=>['name'=>'Document.title','format'=>'string','readonly'=>true]]];上面的数组有很多可能的选项,但它被用作理解该结构的函数的参数。functiondoSomething(array$arr){...}我想在PHPDoc中记录数组的结构,但我不确定正确的方法是什么。这是我现在拥有的。/***Holdsconfigurationsettingsforeachfieldinamodel.