こんにちは。JavaScriptってPythonに似ているってことがだんだんわかってきたtanakaです。 みなさん、PHPでソースコード内ドキュメント、書いてますか。僕は今まで割とさぼりぎみでした。ごめんなさい。しかし、これから紹介するvimプラグインでドキュメントブロックを無理なく書いていけるでしょう。 さて、phpソースコード内の /** * index * * @param string $hoge * @param array $fuga * @access public * @return void */ function index($hoge='hoge', $fuga=array()) { } といった風に、メソッドやクラスの宣言の前に整形されたコメントが記述されているのを見たことがある方もいると思います。何のためにプログラムの実行に影響しないこんなものを書くのかというと
![phpDocumentor形式のドキュメントブロックを生成するvimプラグイン | バシャログ。](https://cdn-ak-scissors.b.st-hatena.com/image/square/e09ad8f655ea0962c3fc07c12b65c5a618375e0d/height=288;version=1;width=512/https%3A%2F%2Fbashalog.c-brains.jp%2Fimages%2Fcat_tools.png)