問題タブ [phpdoc]

コードを実行して javaDoc ブロックの欠陥を検出できるツールを知っていますか? (PHP、C# などの他の言語も解析するとよいでしょう)。

少し前に、次のように netbeans を使用して php の任意のコードにコメントを付けることができました。

/* ENTER と入力すると、netbeans が上記の行を表示してくれました。次に @ と入力すると、使用可能なすべてのタグ (author、param など) の完全なリストが表示されました。

Macを再インストールしましたが、それ以来機能していません。

誰かが理由と方法を知っていますか? 私はphp専用のnetbeansをインストールしました。

そのため、フォルダー PayPal には、API を使用するための複数のクラスがあります。

すべてのクラスを順番に使用する方法についてのドキュメントを作成したいと考えています。ここに私の質問があります：

1. それらのパッケージを作成するにはどうすればよいですか? 上記の各クラスの原因は、phpdoc タグ @package PayPal を使用したことです。PHPのパッケージは単なるフォルダーですか?

2. パッケージのドキュメントはどこに置くのですか? これにはベストプラクティスがありますか? ...という名前のフォルダー内のファイル？

3. クラスまたはパッケージ固有の例の配置方法。ステップ 1 ブラ ブラ、ステップ 2 ブラ ブラ? ありがとう！

私は開発にOSXを使用しています。PHPと今私はPHPDocを試す必要がありますが、どうやって？ソンバーディはソフトウェアを知っていますか？またはどうすればそれを行うことができますか？

ここhttp://manual.phpdoc.org/HTMLSmartyConverter/HandS/ric_INSTALL.htmlを調べてみますが、GUIソフトウェアを見つけることができます。:)

すべての助けのためのタンク。

PHPDocを使用して関数の変更を文書化するための最良の方法は何ですか？何かのようなもの

素晴らしいことだ。しかし、@changeオプションがないと仮定します...とにかくそれを追加した場合、PHPDocはそれをどのように処理しますか？または、機能の変更を文書化するためのより良い/より正しい方法はありますか？

私はこのような多重継承を持っています：PHPで複数のクラスを使用してクラスを拡張できますか？（このアプローチ自体については説明しないでください）そして、継承されたクラスのメソッドとプロパティについてIDEに知らせてください。PhpDocでそれを行う方法はありますか？

PHP アプリケーションでいくつかの連想配列を使用しており、PHP ドキュメンターを使用してソースにコメントを付けています。配列内の配列にコメントを指定したことは一度もありませんでしたが、今はそれを行う必要があり、その方法がわかりません。

@varこの配列に正しい方法でコメントを付けるにはどうすればよい@paramですか? 私はこのようにこれを行うことができますが、これが正しいかどうかはわかりません:

しかし、@var部品に対してこれを行う方法は?

さて、私はphpDocumentatorにうんざりしています。それは、私が喜んで与えるよりもはるかに多くのメモリ（1.4 GB）と時間（2.6GHz Core 2 Duoでは5分）を消費します。PHPコードのドキュメントを生成するための本当に互換性のあるプログラムはありますか？

見栄えのするPHPDoctorを試しましたが、機能が不足しています。ただし、これまでに試したすべてのソリューションから置き換えるのがおそらく最も近いでしょう。

私もPhpDocGenを試しましたが、Perlエラーが発生し、勉強するのが面倒です。

Doxygenも私たちの情報源とうまく連携していないようです。

PS：ドキュメントはphpMyAdmin用ですが、少し古いドキュメントがここにあります。

更新：コードには、オブジェクトだけでなく多くの関数が含まれています。Doxygenの最大の問題は、それらを整理できないためです。

ファイル内の最初の phpDoc スタイルのコメント (他のライブラリは使用しない) のみを解析しようとしている次のコードを検討してください (ファイルの内容は、テスト目的で $data 変数に入れられます)。

@todo の後のすべて (コメント ブロックとコードを含む)bar()が の値と見なされるという事実を除いて、これはほとんど機能し@todoます。

最初のコメント ブロックのみが解析されるようにコードをどのように変更する必要がありますか (つまり、最初の "*/" が検出された後に解析を停止する必要があります)

私はこれを持っています：

@token データ以外をすべて削除する正規表現を探しているので、結果は次のようになります。

私は今これを持っています：

これは部分的に機能します。各行の前にある * のみを削除します。/** と最後のスラッシュ / も取り除くように、誰が私を助けることができますか? どんな助けでも大歓迎です！

PS: たとえば、commentlbock に次のようなものが含まれているとします。

その場合、明らかに @foo の後のスラッシュは削除されない可能性があります。結果は次のようになります。

そこに正規表現の第一人者がいることを願っています:-)