有没有办法标记一个magicproperty作为弃用?考虑以下简化代码:/***Exampleclass**@propertystring$fooAfoovariable.*/classExample{/***Magicgetter*/publicfunction__get($var){if('foo'===$var){//do&returnsomething}}}现在,如何指示其他开发人员,他们不应该再使用Example::$foo了?我想到的唯一可行的解决方案是:/***Exampleclass*/classExample{/***Afoovariable.**@varstri
有没有办法标记一个magicproperty作为弃用?考虑以下简化代码:/***Exampleclass**@propertystring$fooAfoovariable.*/classExample{/***Magicgetter*/publicfunction__get($var){if('foo'===$var){//do&returnsomething}}}现在,如何指示其他开发人员,他们不应该再使用Example::$foo了?我想到的唯一可行的解决方案是:/***Exampleclass*/classExample{/***Afoovariable.**@varstri
在PHP7中,当一个方法设置给定的参数类型和结果类型时,是否有必要在PHPDoc中再次记录它们?自functionfoo(string$text):bool{returntrue;}相当于/***@paramstring$text*@returnbool*/functionfoo($text){returntrue;}是否有必要复制这些信息?/***@paramstring$text*@returnbool*/functionfoo(string$text):bool{returntrue;}编辑:我不使用PHPDoc生成我的代码文档,而是在PHPStorm的帮助下为我和我的同事保持方
在PHP7中,当一个方法设置给定的参数类型和结果类型时,是否有必要在PHPDoc中再次记录它们?自functionfoo(string$text):bool{returntrue;}相当于/***@paramstring$text*@returnbool*/functionfoo($text){returntrue;}是否有必要复制这些信息?/***@paramstring$text*@returnbool*/functionfoo(string$text):bool{returntrue;}编辑:我不使用PHPDoc生成我的代码文档,而是在PHPStorm的帮助下为我和我的同事保持方
是否有一个PHPCS编码标准可以检查正确的注释(@param、@return、@throws等)出现在文档block中,包括它们之间的适当间距? 最佳答案 尝试运行以下命令,看看它是否产生您想要的结果:phpcs/path/to/code--standard=Squiz--sniffs=Squiz.Commenting.FunctionComment,Squiz.Commenting.FunctionCommentThrowTag,Squiz.Commenting.ClassComment,Squiz.Commenting.File
是否有一个PHPCS编码标准可以检查正确的注释(@param、@return、@throws等)出现在文档block中,包括它们之间的适当间距? 最佳答案 尝试运行以下命令,看看它是否产生您想要的结果:phpcs/path/to/code--standard=Squiz--sniffs=Squiz.Commenting.FunctionComment,Squiz.Commenting.FunctionCommentThrowTag,Squiz.Commenting.ClassComment,Squiz.Commenting.File
我正在尝试使用phpDocumentor(这是第一次,我不知道自己在做什么)。实际上,我只想将它与SublimeText2和this一起使用插入。你能一步步指导我怎么做才能让它发挥作用吗?这是我现在所做的:(我使用的是Windows7)从here下载phpDocumentor并将其放置在某个地方。我已经为phpdoc/bin创建了系统路径(因此phpdoc.bat可以由sublime插件执行),然后还添加了php的系统路径(来自WAMPserver安装)当我尝试使用我的插件(或在控制台窗口中执行phpdoc)时,我得到这个错误:无法打开输入文件:\phpdoc.php
我正在尝试使用phpDocumentor(这是第一次,我不知道自己在做什么)。实际上,我只想将它与SublimeText2和this一起使用插入。你能一步步指导我怎么做才能让它发挥作用吗?这是我现在所做的:(我使用的是Windows7)从here下载phpDocumentor并将其放置在某个地方。我已经为phpdoc/bin创建了系统路径(因此phpdoc.bat可以由sublime插件执行),然后还添加了php的系统路径(来自WAMPserver安装)当我尝试使用我的插件(或在控制台窗口中执行phpdoc)时,我得到这个错误:无法打开输入文件:\phpdoc.php
在Doctrine项目的docblock注释中,是否有一种标准方法来记录Collection中预期的实体类?像这样的东西:/***@varCollection*/protected$users;看起来PHPDoc现在是docblock注释的实际标准,但我找不到关于这个用例的任何提及。 最佳答案 这是一个解决方案,使您能够在Collection方法和您的objects方法上都有自动完成功能:/***@paramCollection|User[]$users*/publicfunctionfoo($users){$users->//au
在Doctrine项目的docblock注释中,是否有一种标准方法来记录Collection中预期的实体类?像这样的东西:/***@varCollection*/protected$users;看起来PHPDoc现在是docblock注释的实际标准,但我找不到关于这个用例的任何提及。 最佳答案 这是一个解决方案,使您能够在Collection方法和您的objects方法上都有自动完成功能:/***@paramCollection|User[]$users*/publicfunctionfoo($users){$users->//au