草庐IT

php - 如何在 IDE 中键入提示上下文?

我正在使用Closure::call(http://php.net/manual/en/closure.call.php)在类上下文中调用外部闭包。这是一个简单的重现:classFoo{private$bar='baz';/***Executesaclosurein$thiscontextandreturnswhatevertheclosurereturns.**@param\Closure$closure*@returnmixed*/publicfunctioncallClosureInThisContext(\Closure$closure){return$closure->cal

php - 作为参数传递时如何将 PHPDoc 匿名函数?

当匿名函数作为参数传递时,我应该如何记录它?例如://Callmy_function(),passing2arguments.my_function('foo',function(){//BodyoftheanonfunctionI'dliketodocument.});提前致谢。 最佳答案 为了记录函数接受闭包,我建议callable:/***Dosomething.*@paramcallable$code*/functionfoo(callable$code){}关于注释,PHPDoc使用了DocBlocks,PHP引擎Toke

php - 如何获得 PHP 关联数组索引的智能感知?

这个问题在这里已经有了答案:关闭10年前。PossibleDuplicate:PHPDocforvariable-lengtharraysofarguments每当我键入$_SERVER['']并按Ctrl+Space时,它​​都会为我提供可能的索引列表。我怎样才能使我创建的数组成为可能?

php - 如何在 PHPDoc 中标记一个参数是可选的?

我有一个带有可选参数的构造函数。这样做的主要问题是可用性。使用我的框架的开发人员会立即头疼,因为他不知道他是否可以提供一个论据,什么样的论据,或者他是否根本不能。结论:简直糟透了。但是,如果有人安装了像Netbeans这样的合理IDE,PHPDoc可能会有所帮助;)所以:classChildClassextendsParentClass{publicfunction__construct(){$tplFile=func_get_arg(0);if(!isset($tpl)){$tpl='index';}parent::__construct($tpl);}}我如何在这里使用PHPDoc

php - 将 phpdoc 转换为 Dash 可用的 docset

我正在尝试获取MagentoDocumentation我可以在Dash中使用的格式.一个article在Dash网站上描述了如何将多种类型的文档导入所需的格式,不幸的是phpdoc不是其中之一。有没有人对我如何实现这一目标有任何建议? 最佳答案 我是Dash的开发者。目前没有phpdoc到docset生成脚本,所以恐怕你只能自己创建一个。但是,我确实建议采取简单的方法,即使用doxygen基于PHP源代码生成文档集(请参阅您链接的article中的“使用Doxygen创建文档集”)。如果您需要帮助,请随时contactme.

PHP 类型提示 - 代码与注释

PHP5可以做一些(有限的)typehinting但是,在我看来,在现实世界的项目中,通常会在文档注释中描述类型。例如,而不是这个:/***Testmethod*/functiontest(SomeType$param1){...}一般会有/***Testmethod**@paramSomeTypeparam1*/functiontest($param1){...}这两种方法的优点和缺点是什么?如果我假设PhpDoc方法更常见是正确的,那是为什么呢?为什么人们不更多地使用内置语言功能?编辑:第三种选择是结合使用这两种方法:/***Testmethod**@paramSomeTypepa

php - @package 是否需要 PHP 5.3 命名空间?

我已经切换到PHP5.3和namespace。看起来@package标签现在是多余的和无用的。phpDoc是否仍然需要它,或者我现在可以忽略这个标签吗?谢谢 最佳答案 这不是必需的。最新文档现在指出,如果您使用命名空间并且不需要不同的文档结构,则应避免使用@package:If,acrosstheboard,bothlogicalandfunctionalsubdivisionsareequalisitNOTRECOMMENDEDtousethe@packagetag,topreventmaintenanceoverhead.htt

php - 为什么 PHP 神奇的方法必须公开?

我在我的PHP类中使用了魔法方法,但是当我尝试将它们设为私有(private)时,我收到警告:WARN:Themagicmethod__get()musthavepublicvisibilityandcannotbestaticin...我不想在Eclipse自动完成中使用这些方法。(也许是phpdoc的一种方式?)所以我的问题是,为什么这些方法必须公开? 最佳答案 因为您正在从类之外的范围调用方法。例如://thiscanbeanyclasswith__get()and__setmethods$YourClass=newYourO

php - 在 Netbeans PHP 中记录类的正确方法

出于易于维护和IDE类自动完成和成员提示的原因,我在我的项目中使用了PHPDoc。给定这个示例类:classmy_class{public$id;public$name;public$number;publicfunction__construct(){//Dosomething}publicfunctionRename($name){$this->name=$name;}}我更愿意使用类文档本身来记录所有属性($id、$name和$number),这在上面类声明,然后在每个方法上方放置方法文档(如果需要)。这是我最终希望我的类(class)看起来像的样子:/***Represents

php - 记录使用 __call() 的 PHP 类

我想知道是否有一种方法可以强制phpDocumentor打印出当您使用__call()动态执行它们时可用于获取和设置的潜在方法。就我的简单getter而言,我希望它循环遍历所有私有(private)变量,然后将get附加到它们(当然,第一个字母大写)。 最佳答案 参见phpDocumentor引用@method. 关于php-记录使用__call()的PHP类,我们在StackOverflow上找到一个类似的问题: https://stackoverflow.