首先,我不是在问如何从 PHP 源代码生成文档。使用 Doxygen 或 PHPDocumentor 之类的库很容易做到这一点。我正在寻找的是一种为类、方法、属性等自动生成基于 phpdoc 的内联注释存根的方法。是否有任何预先存在的库可以做到这一点?我进行了一些搜索,但一无所获。
我只是问,因为我有一种痒,我想自己写。我倾向于一次花费数小时编写代码,将文档保存为最后一步(我知道,我真的应该边做边做)。问题是,即使意识到内联文档的重要性,在连续 8 小时编码和编写具有数十种方法和属性的十几个类之后,不得不停下来开始编写这些东西有点令人反感。
显然,我无法自动创建 COMPLETE 文档。诸如类、属性和方法的详细描述之类的东西必须手动输入。但是,使用反射,我可以轻松获得足够的信息来创建带有填充空白占位符的评论存根。
如果有人可以帮助我寻找这样的解决方案,太棒了。如果没有,我将创建一个新的 Github 存储库并为社区贡献一些有用的东西。:)