meraの日記: ライブラリー
日記 by
mera
JavaにはJavadocとかいうのがあるが、PHP にはまんまそっくしの PHPDocというものがあったりするのでこれを利用して今までプログラムしたソースコードから自動でマニュアルを生成。 これで忘れた引数をソースコードを読んで理解という事も無し。 後はコメントを埋めていく作業が難儀かも~。
ただ、このPHPDocには欠点があって、クラス以外は解析してくれない(定数とかは見てくれるっぽいけど)。せめて関数名と引数の部分くらいは見て欲しかったかも。
ついでにPHPは型はあるけど型の指定が無いので(代入された値が型を持ってるのか?)あらかじめ変数名に型を表すプレフィックスをつけてわかりやすく管理するようにしてみた。 とりあえず自己流で。
整数 i
文字列 st
オブジェクト o
ブーリアン bool
配列 a
複合 m
関数型 fn
ただ、このPHPDocには欠点があって、クラス以外は解析してくれない(定数とかは見てくれるっぽいけど)。せめて関数名と引数の部分くらいは見て欲しかったかも。
ついでにPHPは型はあるけど型の指定が無いので(代入された値が型を持ってるのか?)あらかじめ変数名に型を表すプレフィックスをつけてわかりやすく管理するようにしてみた。 とりあえず自己流で。
整数 i
文字列 st
オブジェクト o
ブーリアン bool
配列 a
複合 m
関数型 fn
ライブラリー More ログイン