我在
PHP代码中使用@since注释.我有一个关于它的使用的问题.说我有一个执行特定任务的功能,它已经在版本1.0中实现了.
所以我目前有@since 1.0.@H_404_2@
现在我继续改变函数的名字,虽然内部的代码保持不变.
现在应该说@since 3.0(当前版本)还是保持@since 1.0？@H_404_2@
函数名不存在于1.0,所以@since应该是3.0.不同名称的功能在旧版本中提供相同的功能是无关紧要的您将无法在旧版本中使用新的名称.
docs说：
原文链接：https://www.f2er.com/php/131001.htmlUse
@sinceto document revisions,as in “This function has been a part of this package since version 2.0”@H_404_2@
@since的目的是告诉某人使用你的包,“从版本x,一个名为foo的函数存在,如果你将foo变成v3中的bar,但将@since设为v1,那么你的文档会错误地声明它是安全的在v1中调用bar()实际上,v1中没有bar(),并且调用会引发错误.@H_404_2@
