私は Phpdocumentator2 ( http://phpdoc.org/ )を使い始めました。
/**
@param STRING $url_p URL du WSDL
*/
public function TestPHPdoc($url_p)
{
echo('yes');
}
Phpdocumentator は、この TestPHPdoc(STRING $url_p) のようなドキュメントを正しく作成します
パラメータ STRING $url_p
URL du WSDLですが、私が書いたとき(phpdocが推奨する正しい書き方)
/**
* @param STRING $url_p URL du WSDL
*/
public function TestPHPdoc($url_p)
{
echo('yes');
}
生成されたドキュメントは次のように醜いです:
TestPHPdoc( $url_p)
- @param STRING $url_p URL du WSDL パラメータ $url_p
(もちろん、ドキュメンテーション専用のコメントを書くと、さらに悪化します)
どうすればこれを解決できますか
Windows で wamp を使用し、composer を使用して Phpdocumentator2 をインストールし、この ligne (powershell で) を使用してドキュメントを生成します。
C:\wamp\www\phpdoc\vendor\bin\phpdoc.php.bat -d C:\wamp\www\phpdoc\vendor\bin\source -t C:\wamp\www\phpdoc\vendor\bin\destination
はい、私はそれが美しい方法ではないことを知っています(スクリプトリポジトリで直接生成します:しかし、それはテスト用です)