回答編集履歴
1
リンク修正等
test
CHANGED
@@ -1,12 +1,14 @@
|
|
1
|
-
コメント自体についてはmaisumakunさんの回答の通りです。
|
1
|
+
コメント自体についてはmaisumakunさんのご回答の通りです。
|
2
|
-
|
3
|
-
これの何が嬉しいかというと、phpDocumentorというツールを使って 、クラスドキュメントの自動生成ができることです。
|
4
|
-
|
5
|
-
サンプルは下記のようなものになりますが、例えばご質問の@propertyをきちんとコメントに書いておくと、メソッドの引数説明のところに想定している値は何であるかを出力してくれます。
|
6
2
|
|
7
3
|
|
8
4
|
|
5
|
+
これの何が嬉しいかというと、[phpDocumentor](https://www.phpdoc.org/)というツールを使って 、クラスドキュメントの自動生成ができることです。
|
6
|
+
|
7
|
+
サンプルは下記のようなものになりますが、例えばご質問の`@property`をきちんとメソッドのコメントに書いておくと、メソッドの引数説明のところにコメントに記載した内容(想定している値は何であるか等)を出力してくれます。
|
8
|
+
|
9
|
+
|
10
|
+
|
9
|
-
http://demo.phpdoc.org/Clean/classes/
|
11
|
+
[http://demo.phpdoc.org/Clean/classes/phpDocumentor.Application.html](http://demo.phpdoc.org/Clean/classes/phpDocumentor.Application.html)
|
10
12
|
|
11
13
|
|
12
14
|
|