問題タブ [phpdoc]

Eclipse は次のような変数のパラメーター化をサポートしていないと聞きました。

/**

@var DBProxy

*/

$proxy;

また

/**

@var Uri

*/

$uri = Registry::get('uri');

$uri->...

しかし、利用可能な補完はありません

他の解決策はありますか？

プロジェクト全体でPHPDocコメントをEclipseで表示するにはどうすればよいのでしょうか。現時点では、現在開いているファイルでのみ機能します。

関数自体のファイルの外で、各関数の前に入力したすべての@paramsと説明をチェックできるのは素晴らしいことです。

どうもありがとう！

次のように、渡された引数に応じてミューテーターまたはアクセサーとして動作する関数が与えられます。

これをPHPDocまたは同様の自動ドキュメント作成者でどのように文書化しますか？私はもともと次のように書いていました：

ただし、これをphpDocで実行すると、2つのreturnタグがあり、最初の@param $cacheName説明が2番目の説明で上書きされるため、文句を言います。

これを回避する方法はありますか？

Netbeans 6.8 で PHP プロジェクトの PHPDoc ドキュメントを生成する方法はありますか?

数日間、PHPの作業にNetBeans6.8を使用しています。ただし、クラスファイルが含まれ、メソッドが公開されていてphpDocが使用されている場合でも、NetBeansは毎回ウィンドウに「提案なし」と表示します。

たとえば、私はタイプします

Ctrlキーを押しながらSpaceキーを押すと、すべてのメソッドと変数が必要ですが、表示されていません。アイデア？

インクルード ファイルに含まれているクラスの提案を取得するのに問題があります。

たとえば、「He​​ader.php」ファイルの内容は次のとおりです。

ファイル 'Example.php' に Header.php を含めると、提案が表示されません。

User:: と入力した後、クラス User のメソッドと変数を提案として調べましたが、何もありません。「User.php」を「Example.php」に直接含めると機能しますが、それは役に立ちません。この問題を解決するには？

PHP Docblock ( Doxygenなどのツールでドキュメントを生成するために使用される) を、PHP で検査できる構造に変換する方法を探しています。

たとえば、解析したい

次のようなものに：

PEARやそのようなライブラリを明示的に使用することはできません。比較的スタンドアロンである必要があります。 コメントのアウトラインを取り除いた後に正規表現の束を使用するよりも優れたソリューションはどれもすばらしいものです。

phpdoc で生成されたドキュメントを、既存の docbook ドキュメントに含めたいと考えています。

私のアイデアは、phpdoc に docbook 形式でドキュメントを生成させ、XInclude を使用してその一部 (パッケージとサブパッケージに基づく) をインポートさせることでした。ドキュメントに Docbook 5 を使用しています。これを達成する方法はありますか？

XML:DocBook/peardoc2:defaultこれまで試したことは、phpdoc パラメータとして使用して docbook を生成することです。

PHPDocumentor の docbook はいくつかのファイルに分割されています。

私が理解している限り、これらは外部エンティティですが、DTD で参照する必要があります。phpdoc によって生成された DTD がなく、すべてのクラスとメソッドにファイルを含めたくないため、私の努力には役に立ちません。手で。

説明するのは少し難しいかもしれないので、いくつかのサンプルコードを示します。NetBeans IDE（最新）を使用していることに注意してください。

NetBeansで開発しているときに、「$ s->」と入力した後、ctrl+spaceを押すことでオートコンプリートを呼び出すことができます。次のヒントウィンドウには、「say（）」という項目があります。これは、javadocがsay_somethingがDummyを返し、NetBeansが解析したDummyクラスを「say（）」というメソッドがあることを認識していると言っているためです。

ここまでは順調ですね。

私の問題は配列にあります。コード例は次のとおりです。

オートコンプリートをもう一度試してみましたが、代わりに「$ s [0]->」を使用すると、Dummyクラスのメソッドが取得されません。これは、JavaDocで、それが配列であり、値の型ではないと言っただけだからです。

したがって、問題は、JavaDoc構文、チート、配列で予期される変数のタイプをJavaDocに指示できるものはありますか？

PHPコードを文書化するための何らかの標準の使用を開始しようとしています。私のコードのほとんどは WordPress プラグインの形式であり、一部は非常に複雑になっているため、文書化する必要があります。

私の質問は簡単です.WordPressはコードを文書化するためにどのシステムを使用していますか?