我真的只是刚刚发现你可以使用 /** @blah */ 注释来指定某些东西,但是是否可以在代码中创建部分?
喜欢:
/** Start Section "Blah" **/
$result = doSomething();
echo $result;
/** End Section "Blah" */
任何 PDT 都做不到这一点。通常可扩展的代码段由函数和类方法体标识。
如果您认为需要通过注释识别的人工部分,我建议您考虑将代码重新组织为更细粒度的文件、函数、类和方法,这些文件、函数、类和方法可以使用 PhpDoc(这是标准 PDT 使用)轻松记录。
这些部分
/**
* here goes your text
* @author Nanne
* /
基于javadoc:http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html
查看此页面,其中描述了 PHP 文档编写器。我不知道 Eclipse 使用什么标准,但我猜它们都相当相似: http://www.phpdoc.org/
Is 主要基于注释代码的某些部分,例如类、函数和变量。据我所知,“部分”没有特殊的代码。我认为这个的原因是,你“应该”用类、它的方法等来制作一个文档。在这样的文档中没有特殊的方法来表示“部分”。
但是请阅读上面的链接,它会清晰很多!
在 PHP 中,您可以使用节来分隔代码片段。语法如下:
Blah:{
$result = doSomething();
echo $result;
}
在使用面向对象编程(类和实例)之前,这些是由
goto
风格的过程编程使用的。使用这些部分和 goto
语句是非常糟糕的做法,任何开发人员都应该避免。