为什么人们依赖评论作为业务逻辑？（例如 CakePHP、Doctrine）
教义示例（从他们的文档中，教义与代码本身一样依赖注释）：
/**
* @Entity @Table(name="products")
**/
class Product
{
/** @Id @Column(type="integer") @GeneratedValue **/
protected $id;
/** @Column(type="string") **/
protected $name;
...
几周前，我不得不在一个 CakePHP 应用程序中进行更改，我遇到了一个没有调用回调的问题，只是深入挖掘了他们的内心，我发现我需要在函数定义之前放置一个 docblock 注释被认出来叫了，我在袜子里。不幸的是，我现在没有代码可以给你一个例子。
我使用了很多编程语言，但我发现这种我只在 PHP 中看到的趋势非常烦人，我认为这违反了编程规则。
也许有人可以对此有所了解，在我看来这是一个非常糟糕的做法，但我期待听到你的意见。
谢谢