| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> | |
| <!-- | |
| Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. | |
| --> | |
| <html> | |
| <head> | |
| <title>NetBeans IDE for PHP のエディタ</title> | |
| <meta name="KEYWORDS" content="NETBEANS, PHP, editor"> | |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | |
| <meta name="DESCRIPTION" content="NetBeans, PHP editor" > | |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css" media="screen"></head> | |
| <body> | |
| <h1>NetBeans IDE for PHP のエディタ: 概要</h1> | |
| <p>このドキュメントでは、NetBeans IDE の PHP エディタの概要を示します。</p> | |
| <p><strong>目次</strong></p><img src="../../../images_www/articles/71/netbeans-stamp.png" class="stamp" width="114" height="114" alt="このページの内容は NetBeans IDE 7.1 が対象です" title="このページの内容は NetBeans IDE 7.1 が対象です"> | |
| <ul> | |
| <li><a href="#gettingReady">はじめに</a></li> | |
| <li><a href="#editorLayout">NetBeans IDE for PHP のエディタのレイアウト</a></li> | |
| <li><a href="#SyntaxHighlighting">構文の強調表示</a></li> | |
| <li><a href="#goToDeclaration">宣言へ移動</a></li> | |
| <li><a href="#Navigator">ナビゲータ</a></li> | |
| <li><a href="#CodeFolding">コード折り畳み</a></li> | |
| <li><a href="#SmartIndent">スマートインデント</a></li> | |
| <li><a href="#Formatting">整形</a></li> | |
| <li><a href="#BracketCompletion">括弧の補完</a></li> | |
| <li><a href="#instant-rename">名前変更リファクタリングと名前の即時変更</a></li> | |
| <li><a href="#CodeCompletion">コードの補完</a> | |
| <ul> | |
| <li><a href="#snippets">スニペット</a></li> | |
| <li><a href="#contextSensitiveProposals">状況に応じた候補</a></li> | |
| <li><a href="#abbreviations">コードテンプレートと省略名</a></li> | |
| <li><a href="#cc-constructors">コンストラクタ内でのコード補完</a></li> | |
| <li><a href="#cc-sql">SQL コード補完</a></li> | |
| <li><a href="#cc-namespaces">PHP 5.3 の名前空間</a></li> | |
| <li><a href="#cc-overridden-methods">メソッドのオーバーライドと実装</a></li> | |
| <li><a href="#clever-catch-cc">高度な Try/Catch コード補完</a></li> | |
| </ul> | |
| </li> | |
| <li><a href="#rectangular">四角形選択</a></li> | |
| <li><a href="#phpdoc">PHPDocumentor のサポート</a></li> | |
| <li><a href="#code-generators">コードジェネレータ</a> | |
| <ul> | |
| <li><a href="#generate-constructors">コンストラクタ</a></li> | |
| <li><a href="#generate-getters-setters">取得メソッドおよび設定メソッド</a></li> | |
| <li><a href="#generate-overriden-methods">メソッドのオーバーライドと実装</a></li> | |
| </ul></li> | |
| <li><a href="#vartyp-cmnt">コメント内での変数の型の定義</a></li> | |
| <li><a href="#ParameterHints">パラメータヒント</a></li> | |
| <li><a href="#errorMessages">エラーメッセージ</a></li> | |
| <li><a href="#phpunit">PHPUnit と Selenium のテスト</a></li> | |
| <li><a href="#spellchecker">スペルチェッカー</a></li> | |
| <li><a href="#symfony">Symfony フレームワークと Zend フレームワークのサポート</a></li> | |
| <li><a href="#smarty"> Smarty のサポート</a></li> | |
| </ul> | |
| <p><b>このチュートリアルに従うには、次のソフトウェアとリソースが必要です。</b></p> | |
| <table> | |
| <tbody> | |
| <tr> | |
| <th class="tblheader" scope="col">ソフトウェアまたはリソース</th> | |
| <th class="tblheader" scope="col">必須バージョン</th> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a target="_blank" href="https://netbeans.org/downloads/index.html">NetBeans IDE</a></td> | |
| <td class="tbltd1">PHP ダウンロードバンドル</td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1">PHP エンジン</td> | |
| <td class="tbltd1">version 5 | |
| </tr> | |
| <tr> | |
| <td class="tbltd1">Web サーバー</td> | |
| <td><a target="_blank" href="http://httpd.apache.org/download.cgi">Apache HTTP Server 2.2</a> (推奨)<br></td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1">PHP デバッガ</td> | |
| <td><a target="_blank" href="http://www.xdebug.org">XDebug 2.0 以降</a></td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <h2><a name="gettingReady"></a>はじめに</h2> | |
| <p>NetBeans IDE for PHP で PHP アプリケーションを正常に開発および配備するには、<a href="../../trails/php.html#configuration">必要なすべてのソフトウェアがインストールされ、PHP 開発用に構成されている</a>必要があります。 </p> | |
| <h2><a name="editorLayout"></a>NetBeans IDE for PHP のエディタのレイアウト</h2> | |
| <p>エディタには次のウィンドウがあります。</p> | |
| <ul> | |
| <li>編集中のファイルを表示する「エディタ」ウィンドウ。「エディタ」には、開いているファイルごとのタブがあります。</li> | |
| <li>既存のプロジェクトのリストを表示する「プロジェクト」ウィンドウ</li> | |
| <li>各プロジェクトのファイルを表示する「ファイル」ウィンドウ</li> | |
| <li>現在使用可能な外部サービス (データベースなど) のリストを表示する「サービス」ウィンドウ</li> | |
| </ul> | |
| <p>Ctrl+7 キーを押して、左側のパネルに「ナビゲータ」ウィンドウを開くこともできます。PHP クラスがエディタ内で開いている場合、「ナビゲータ」はそのクラスの構造を表示します。クラスでない PHP ファイルは「ナビゲータ」ウィンドウに表示されません。</p> | |
| <p>これらのいずれかのウィンドウのヘルプを開くには、ウィンドウ内の任意の要素を選択し、F1 キーを押します。</p> | |
| <h2><a name="SyntaxHighlighting"></a>構文の強調表示 </h2> | |
| <p>エディタでは、PHP、HTML、JavaScript、および CSS の各コードブロックの構文が強調表示されます。 </p> | |
| <p>現在のバージョンでは次の構文要素が強調表示されます。</p> | |
| <ul> | |
| <li>PHP のキーワード </li> | |
| <li>PHP の変数 </li> | |
| <li>PHP の定数 </li> | |
| <li>HTML のタグ</li> | |
| <li>HTML の入力フォームの属性</li> | |
| <li>現在の行が水色の背景で表示される。</li> | |
| <li>PHP 変数、関数、またはクラスの内部にキャレットを配置することによって、変数のすべての出現箇所が強調表示される。 </li> | |
| <li>エラーが検出された行に赤い下線が表示される。 </li> | |
| </ul> | |
| <img src="../../../images_www/articles/71/php/editorguide/syntaxhighlighting.png" alt="NetBeans for PHP のエディタウィンドウで PHP と HTML の両方のコード要素が強調表示されたコードフラグメント" class="margin-around"><br> | |
| <p>強調表示の設定を変更するには、<tt>「ツール」>「オプション」</tt>を選択し、「フォントと色」タブをクリックします。次に設定を指定します。</p> | |
| <h2><a name="goToDeclaration"></a>宣言へ移動</h2> | |
| 「宣言へ移動」機能を使用すると、変数または関数の出現箇所から、その変数または関数が宣言または初期化されている行まで移動します。この機能を使用するには、関連する変数または関数の出現箇所にカーソルを配置し、コンテキストメニューから「ナビゲート」>「宣言へ移動」を選択するか、Ctrl-B/⌘-B キーを押すか、Ctrl- クリックを使用します。 | |
| <h2><a name="Navigator"></a>ナビゲータウィンドウ</h2> | |
| <p>「ナビゲータ」ウィンドウは、現在アクティブなファイルの PHP 構造を示す要素のリストとしてコード構造を表示します。ファイルにほかのテキストソース (たとえば HTML) が含まれる場合はその構造もリストに表示されます。リスト内の関数または変数をダブルクリックすると、クリックした要素の宣言にカーソルが配置されます。 </p> | |
| <p class="alert"><b>注意:</b> 「ナビゲータ」ウィンドウは PHP クラスの PHP コードのみ表示します。クラス外部の PHP コードは表示できません。</p> | |
| <p>ナビゲータのリストには通常は埋め込みリストは含まれませんが、複雑な文は埋め込み構造が含まれる場合があります。たとえば、PHP のクラス宣言文は、宣言されているクラスメンバーのツリーとして表示される場合があります。 </p> | |
| <p>リストは、ユーザーがコードを入力すると動的に更新されます。 </p> | |
| <p>「ナビゲータ」ウィンドウは、左側のパネルの下部に表示されます。</p> | |
| <ol> | |
| <li>「ナビゲータ」ウィンドウを開くには、Ctrl+7 キーを押すか、「ウィンドウ」>「ナビゲート」>「ナビゲータ」に移動します。HTML と PHP の構造を示すツリーが表示されます。</li> | |
| <li>特定の要素に移動するには、リスト内で該当するノードをダブルクリックします。 | |
| <br> <img src="../../../images_www/articles/71/php/editorguide/navigation.png" alt="ナビゲーションツールの使用例を示す図。クラスと関数の折り畳みと展開も示します。" class="margin-around"> </li></ol> | |
| <h2><a name="CodeFolding"></a>コード折り畳み</h2> | |
| <p>エディタでは、PHP ソースコードが含まれる現在編集中のファイルで、モジュール、クラス、または関数の表示と非表示を切り替えることができます。コードを折り畳んだり表示したりするには、コード左側の「-」または「+」のアイコンをクリックするか、Ctrl+ または Ctrl- キーを押します。 </p> | |
| <h2><a name="SmartIndent"></a>スマートインデント</h2> | |
| <p>ユーザーの入力中にコードが自動的に整形されます。 </p> | |
| <h2><a name="Formatting"></a>整形</h2> | |
| <p>コードを整形してわかりやすくするには、次の手順に従います。</p> | |
| <ol> | |
| <li>該当するコードを選択します。</li> | |
| <li>右クリックのコンテキストメニューから「整形」を選択するか、Alt+Shift+F キーを押します。</li> | |
| </ol> | |
| <h2><a name="BracketCompletion"></a>括弧の補完</h2> | |
| <p>ユーザーがコードを入力している間にエディタによって対応する括弧や引用符が自動的に追加および削除されます。 </p> | |
| <ul> | |
| <li>一重引用符 ' ' と二重引用符 " "、小括弧 ()、および角括弧 [] の最初の記号を入力すると、対応する記号が追加されます。</li> | |
| <li>行末には、一重または二重の右引用符に続けてセミコロンが追加されます。</li> | |
| <li>ユーザーが Enter キーを押すと右中括弧が追加され、スマートインデント機能が有効になります。</li> | |
| <li>一重または二重の左引用符、左小括弧、または左角括弧を削除すると、対応する右の記号も自動的に削除されますが、行末のセミコロンに影響はありません。 | |
| <li>カーソルが右の小括弧 )、中括弧 }、または角括弧 ] にあるとき、対応する左の記号が黄色で強調表示されます。 | |
| <br><img src="../../../images_www/articles/71/php/editorguide/paired-brackets-highlighting.png" alt="カーソルが右の小括弧または角括弧にあるとき、対応する左の要素が強調表示されます。" class="margin-around"></li> | |
| </ul> | |
| <h2><a name="instant-rename"></a>名前変更リファクタリングと名前の即時変更</h2> | |
| <p>クラス名などの要素の名前をプロジェクト内のすべてのファイルにわたって変更できます。この機能では、変更を行う前に変更をプレビューすることが強制されます。プレビューウィンドウではその要素のすべての場所が示され、要素の個々の出現箇所を名前の変更の対象から除外できます。</p> | |
| <p>名前変更リファクタリングは、古い機能である名前の即時変更と対比されます。名前の即時変更も引き続き使用できますが、メソッド内の変数の名前変更や、private である変数およびフィールドの名前変更など、「public 以外の」コンテキストでのみ機能します。名前の即時変更では 1 つのファイル内の要素のみ名前を変更でき、プレビューウィンドウは提供されません。</p> | |
| <p>名前の即時変更を使用するには、変更する名前にカーソルを置き、Ctrl-R キーを押します。名前の即時変更がその変数に適用される場合、その変数名または関数名のすべてのインスタンスが強調表示されます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/refactor-ctrlr.png" width="551" height="361" alt="Ctrl-R キーを押したあとの PHP コードエディタ"> | |
| <p> 名前の 1 つのインスタンスを変更すると、ファイル内のほかのすべてのインスタンスも同時に変更されます</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/refactor-afterchange.png" width="551" height="359" alt="リファクタリングされた変数名を示す PHP コードエディタ"> | |
| <p>名前変更リファクタリングを使用するには、名前を変更する要素を選択し、Ctrl-R キーを押すか、右クリックして「リファクタリング」>「名前を変更」を選択します。要素の名前を変更するダイアログが開きます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/rename-confirm.png" alt="変数の名前を変更するためのダイアログ" class="margin-around" > | |
| <p>要素の名前を変更して、「プレビュー」を押します。「リファクタリング」ウィンドウが開きます。このウィンドウでは、プロジェクト内での要素のすべてのインスタンスを検索し、その名前を変更するかどうかを決定できます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/refactoring.png" alt="「リファクタリング」ウィンドウ" class="margin-around" > | |
| <p>名前変更リファクタリングの詳細については、スクリーンキャスト「<a href="../../docs/php/screencast-rename-refactoring.html">NetBeans IDE 7.0 for PHP での名前変更リファクタリングおよびほかのエディタの改善</a>」を参照してください。</p> | |
| <h2><a name="CodeCompletion"></a>コード補完</h2> | |
| <p>コード補完は、コーディングのプロセスを高速にする一連の機能の総称です。</p> | |
| <p>次の種類のコード補完があります。 </p> | |
| <ul> | |
| <li><a href="#snippets">スニペット</a></li> | |
| <li><a href="#contextSensitiveProposals">状況に応じた候補</a></li> | |
| <li><a href="#abbreviations">省略名</a></li> | |
| <li><a href="#cc-constructors">コンストラクタ内でのコード補完</a></li> | |
| <li><a href="#cc-sql">SQL コード補完</a></li> | |
| <li><a href="#cc-namespaces">PHP 5.3 の名前空間</a></li> | |
| <li><a href="#cc-overridden-methods">メソッドのオーバーライドと実装</a></li> | |
| </ul> | |
| <div class="indent"><h3><a name="snippets"></a>スニペット </h3> | |
| <p>スニペットによってユーザーはさまざまな要素のコードを自動的に生成できます。</p> | |
| <ol> | |
| <li>「ツール」>「パレット」>「コードクリップ」を選択します。さまざまなユーザーインタフェース要素を含むパレットが右側のパネルに表示されます。</li> | |
| <li>パレット上のアイコンを、コード内の適切な場所までドラッグします。対応する要素のパラメータを指定するためのダイアログが表示されます。データを入力します。</li> | |
| <li>選択した要素を表示するコードが生成され、選択した位置に挿入されます。</li> | |
| </ol> | |
| <h3><a name="contextSensitiveProposals"></a>状況に応じた候補 </h3> | |
| <p>エディタには、次のいずれかの先頭の数文字を入力すると、状況に応じてその文字を補完する候補が表示されるという機能があります。 </p> | |
| <ul> | |
| <li>PHP キーワード (if、else、elseif、while、switch、function など) </li> | |
| <li>PHP 組み込み関数 (substr、count など)</li> | |
| <li>事前定義またはユーザー定義の変数</li> | |
| </ul> | |
| <p>エディタでは候補が表示されるだけでなく、<a href="#ParameterHints">パラメータヒント</a>も表示されます。コード補完を適用するには、次の手順に従います。 </p> | |
| <ol> | |
| <li>必要な文字列の先頭の数文字を入力します。 </li> | |
| <li>Ctrl+ スペースキーを押します。ドロップダウンリストに、状況に応じた候補が表示されます。各候補には説明とパラメータヒントがあります。入力を続けるとリストの内容が変化します。 </li> | |
| <li>現在のコンテキストで使用できる PHP キーワードのリストを取得するには、何も入力せずに Ctrl+ スペースキーを押します。 | |
| <br> <img src="../../../images_www/articles/71/php/editorguide/codecompletionabbreviations.png" alt="状況に応じた候補のリスト。各候補には説明とパラメータヒントがあります。" class="margin-around"> | |
| </li> | |
| <li>変数に関するヒントを表示するには、ドル記号「$」を入力します。現在使用可能なすべての局所変数と大域変数のリストが表示されます。 | |
| <br><img src="../../../images_www/articles/71/php/editorguide/code-completion-variables.png" alt="ユーザーが「$」と入力すると変数のリストが開きます。リストには PHP の大域変数とユーザー定義の変数が含まれます。" class="margin-around"> </li> | |
| </ol> | |
| <h3><a name="abbreviations"></a>コードテンプレートと省略名</h3> | |
| <p>この文脈では、「省略名」とは、プログラミング言語で使用されるキーワードに対応する、事前定義された一連の文字列を指します。省略名はそれぞれ完全なキーワードを含む拡張テキストと、パラメータヒントを含むキーワードのコードテンプレートに関連付けられています。この機能を適用するには、省略名を入力して Tab キーを押します。 </p> | |
| <img src="../../../images_www/articles/71/php/editorguide/abbreviations-type-abbr.png" alt="キーワード「class」の省略名「cls」を入力したところ" class="margin-around"><br> | |
| <p>省略名が対応するキーワードに置き換わり、キーワードのコードテンプレートが表示されます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/abbreviation-unfolded.png" alt="省略名の完全なテキストとクラス定義のコードテンプレートが表示されたところ" class="margin-around"><br> | |
| <p>定義されている省略名のリストとコードテンプレートを表示するには、次の手順に従います。</p> | |
| <ol> | |
| <li><tt>「ツール」>「オプション」>「エディタ」>「コードテンプレート」</tt>を選択します。 </li> | |
| <li>「言語」ドロップダウンリストから「PHP」を選択します。PHP の省略名のリストと、各省略名に定義されているコードテンプレートが表示されます。</li> | |
| <li>リストに定義を追加するか、リストから定義を削除するには、それぞれ「新規」ボタンまたは「削除」ボタンを使用します。</li> | |
| <li>定義を編集するには、該当する行を選択し、リストの下の編集フィールドでテキストを編集します。 <br> | |
| <img src="../../../images_www/articles/71/php/editorguide/code-template-definitions-list.png" alt="省略名のリストと、各省略名に定義されているコードテンプレート" width="536" height="513" class="margin-around"></li></ol> | |
| <p>詳細については、「<a href="../../docs/php/code-templates.html">NetBeans IDE for PHP でのコードテンプレート</a>」を参照してください。</p> | |
| <h3><a name="cc-constructors"></a>コンストラクタのコード補完</h3> | |
| <p><tt>new</tt> キーワードの入力後、プロジェクト内で使用可能なすべてのクラスのコンストラクタとパラメータを示すコード補完ウィンドウが表示されます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-constructor.png" width="600" height="408" alt="コンストラクタのコード補完のヒント" class="margin-around" border="1"> | |
| <h3><a name="cc-sql"></a>SQL コード補完</h3> | |
| <p>文字列が SQL のキーワード「select」で始まるときに、SQL コード補完が表示されます。最初に、データベース接続を選択します。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-sql.png" height="384" width="475" alt="データベース接続を示すコード補完" border="1" class="margin-around"> | |
| <p>IDE に登録されているすべてのデータベース接続が表示されます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-sql-dbconnections.png" alt="IDE に登録されているすべてのデータベース接続" width="554" height="185" class="margin-around"> | |
| <p>接続を選択すると、SQL コード補完には、そのデータベース接続のすべての表が表示されます。 </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/cc-sql-tables.png" height="384" width="494" alt="wishlist データベース接続のすべての表" class="margin-around" border="1"></p> | |
| <p>表に列がある場合は、列も表示されます。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/cc-sql-columns.png" height="358" width="530" class="margin-around" alt="表の列の表示" border="1"></p> | |
| <p>SQL コード補完は、表の別名にも使用できます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/cc-sql-aliases.png" alt="hotel 別名の表を示す SQL コード補完" height="352" width="537" border="1" class="margin-around"> | |
| <h3><a name="cc-namespaces"></a>PHP 5.3 の名前空間</h3> | |
| <p>PHP 5.3 から、コード補完は、完全修飾、部分修飾、および非限定の名前空間名をサポートしています。詳細については<a href="../../docs/php/namespace-code-completion-screencast.html">スクリーンキャスト</a>を参照してください。</p> | |
| <h3><a name="cc-overridden-methods"></a>メソッドのオーバーライドと実装</h3> | |
| <p>クラスメンバー間でのコード補完機能によって、メソッドのオーバーライドまたは実装が可能です。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/cc_overriden_methods.png" alt="コード補完によるメソッドのオーバーライド" width="600" height="478" class="margin-around"></p> | |
| <h3><a name="clever-catch-cc"></a>高度な Try/Catch コード補完</h3> | |
| <p>NetBeans IDE 7.1 以降では、<tt>catch</tt> 文のコード補完には、<tt>Exception</tt> から継承されたクラスのみが含まれるようになりました。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/clever-catch-cc.png" alt="catch パラメータでの高度なコード補完を表示するエディタ" width="491" height="166" class="margin-around b-all"></p> | |
| </div> | |
| <h2><a name="rectangular"></a>四角形選択</h2> | |
| <p>NetBeans IDE 7.1 for PHP では四角形選択アクションが導入されました。この編集機能は、ペーストされたコード内の行番号を削除するなどの場合に便利です。</p> | |
| <p>四角形選択を有効にするには、四角形選択トグルボタンを押すか、Ctrl-Shift-R キーを押します。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/rec-selec-togglebutton.png" alt="四角形選択トグルボタンを示すエディタ" width="600" height="321" class="margin-around b-all"></p> | |
| <p>四角形選択が有効な場合、マウスまたはキーボードで選択を実行できます。キーボードを使用する場合、キャレットを隅に配置し、SHIFT キーを押し下げた状態で、必要なだけ矢印キーで選択します。 </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/rec-selec-made.png" alt="ペーストされた行番号の四角形選択を示すエディタ" width="600" height="289" class="margin-around b-all"></p> | |
| <p>領域が選択されているときにテキストを書き込んだ場合、テキストは選択された領域の各行に配置されます。これは、クラス内の複数のフィールドにあるアクセス修飾子を同時に変更する場合などに便利なことがあります。 </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/rec-selec-addtext.png" alt="四角形選択内のすべての行にアクセス修飾子を追加したエディタ" width="435" height="342" class="margin-around b-top b-right"></p> | |
| <h2><a name="phpdoc"></a>PHPDocumentor のサポート</h2> | |
| <p>NetBeans IDE 7.0 には、PHPDocumentor の組み込みサポートが追加されました。詳細については、スクリーンキャスト「<a href="screencast-phpdoc.html">NetBeans IDE での PHP ドキュメントの生成</a>」を参照してください。</p> | |
| <p class="alert"><b>警告:</b> PHPDocumentor では、PHP 5.3 は完全にはサポートされていません。名前空間およびその他いくつかの 5.3 機能は、PHP Documentor ではドキュメント化されません。</p> | |
| <h2><a name="code-generators"></a>コードジェネレータ</h2> | |
| <p>Alt-Insert (Mac の場合は Ctrl-I) の組み合わせを押すと、メニューが開き、利用可能なすべてのコードジェネレータが表示されます。一覧表示されるジェネレータは状況に応じて異なります。キーの組み合わせを押したときの、コード内でのキャレット位置によって、表示内容は異なります。コード内の位置に応じて、データベース接続、データベース表、ロレムイプサムテキストなどを生成できます。この節では、次のコードジェネレータについてのみ説明します。</p> | |
| <ul> | |
| <li><a href="#generate-constructors">コンストラクタ</a></li> | |
| <li><a href="#generate-getters-setters">取得メソッドおよび設定メソッド</a></li> | |
| <li><a href="#generate-overriden-methods">メソッドのオーバーライドと実装</a></li> | |
| </ul> | |
| <div class="indent"> | |
| <h3><a name="generate-constructors"></a>コンストラクタ</h3> | |
| <p>キャレットがクラス本文の中にある場合、Alt-Insert (Mac の場合は Ctrl-I) キーを押してコンストラクタを生成できます。ただし、その本文内に含まれている関数の中では生成できません。「生成」の「コンストラクタ」を選択すると、ダイアログが開き、コンストラクタで初期化できるフィールドのリストが表示されます。フィールド名は、コンストラクタのパラメータとして使用されます。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/generate-constructor-fields.png" alt="コンストラクタで初期化するフィールドのダイアログ" width="352" height="299" class="margin-around"></p> | |
| <p>フィールドを選択しないこともできます。この場合、IDE は、パラメータを持たない空のコンストラクタを生成します。そのフィールドが複数のプロパティーを持つクラスである場合、プロパティーを個別に選択するか、クラスを選択することができます。クラスを選択すると、そのクラスのすべてのプロパティーが自動的に選択されます。</p> | |
| <p>詳細については、<a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generate_constructor_getters_and_setters">NetBeans PHP のブログ投稿</a>を参照してください。</p> | |
| <h3><a name="generate-getters-setters"></a>取得メソッドおよび設定メソッド</h3> | |
| <p>キャレットがクラス本文の中にある場合に、Alt-Insert (Mac の場合は Ctrl-I) を押して「取得メソッド」、「設定メソッド」、または「取得メソッドおよび設定メソッド」を選択すると、取得メソッドと設定メソッドを生成できます。利用可能な関数だけが表示されます。たとえば、利用可能なプロパティーの設定メソッドがすでにある場合は、取得メソッドのオプションだけが表示されます。</p> | |
| <p>「生成」の「取得メソッド」、「設定メソッド」、または「取得メソッドおよび設定メソッド」を選択すると、ダイアログが開き、取得メソッドまたは設定メソッドを生成できるプロパティーが表示されます。これらのプロパティーはツリーに表示されます。ある親クラスを選択すると、そのクラスのすべてのプロパティーが自動的に選択されます。</p> | |
| <p>取得メソッドまたは設定メソッドに、getName 規則または get_name 規則に従った名前を付けることができます。</p> | |
| <p>詳細については、元の <a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generate_constructor_getters_and_setters">NetBeans PHP のブログ投稿</a>および「<a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generating_getters_and_setters_improved">取得メソッドおよび設定メソッドの生成の改善</a>」の投稿を参照してください。</p> | |
| <h3><a name="generate-overriden-methods"></a>メソッドのオーバーライドと実装</h3> | |
| <p>キャレットがクラス本文の中にあり、クラスメンバーが複数存在する場合、Alt-Insert (Mac の場合は Ctrl-I) を押して、オーバーライドまたは実装されたメソッドを生成できます。挿入可能なメソッドを表示するダイアログが開き、そのメソッドがオーバーライドされるのか実装されるのかを示します。</p> | |
| <p><img class="margin-around" src="../../../images_www/articles/71/php/editorguide/generate_overriden_methods.png" alt="「オーバーライドメソッドの生成」ダイアログ" width="523" height="520"></p> | |
| <p>この機能は、「すべての抽象メソッドの実装」ヒント機能、および<a href="#cc-overridden-methods">メソッドのオーバーライドと実装をコード補完する</a>機能を補完するものです。</p> | |
| <p>詳細については、<a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/generate_overriden_implemented_methods">NetBeans PHP のブログ投稿</a>を参照してください。</p> | |
| </div> | |
| <h2><a name="ParameterHints"></a>パラメータヒント </h2> | |
| <p>エディタでは、関数またはメソッドが呼び出されているコンテキストで、関数またはメソッドの仮パラメータに関するプロンプトが表示されます。</p> | |
| <ol> | |
| <li>呼び出す関数の先頭の数文字を入力します。 </li> | |
| <li>Ctrl+ スペースキーを押します。ドロップダウンリストに状況に応じた候補と、各候補の仮パラメータが表示されます。<br> | |
| <img src="../../../images_www/articles/71/php/editorguide/parametr-hint-one.png" alt="状況に応じたヒントのリスト" class="margin-around"> | |
| </li> | |
| <li>適切な候補を選択して Enter キーを押します。選択した関数の名前がコードに挿入され、パラメータを入力するためのテンプレートが角括弧内に表示されます。 <br> | |
| <img src="../../../images_www/articles/71/php/editorguide/parametr-hint-two.png" alt="選択した状況に応じた候補のパラメータヒント" class="margin-around"> | |
| </li> | |
| </ol> | |
| <h2><a name="vartyp-cmnt"></a>コメント内での変数の型の定義</h2> | |
| <p>コメント内で変数とその型を定義できます。コメントは、<em>/* @<strong>var</strong> $<変数の型> */</em> の形式になっている必要があります。正しく記述されているコメントは、<em><strong>var</strong></em> タグがボールドフォントになります。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/vardoc-basic.png" height="319" width="600" alt="コメント内で定義された変数" class="margin-around" border="1"> </p> | |
| <p>コードテンプレート <tt>vdoc</tt> の入力後に Tab キーを押すことで、変数を定義するコメントを生成できます。変数名が選択され、変更できる状態になります。もう一度 Tab キーを押すと、型が選択されます。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/vardoc-template.png" height="269" width="600" alt="vdoc テンプレートによって生成された、変数を宣言するコメント" class="margin-around" border="1"> </p> | |
| <p>コードテンプレートによって変数名と型が自動的に設定されます。テンプレートを挿入した位置のあとで使用している変数がある場合は、その変数名がデフォルトで表示されます。テンプレートを挿入した位置のあとに変数がなく、テンプレートの前で使用している変数がある場合は、その変数名がデフォルトで表示されます。NetBeans IDE がテンプレートを使用している近くで変数を見つけることができない場合、デフォルト名は <em>variable</em> になります。変数の型は、同じ規則に従って自動的に設定されます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/vardoc-template-names.png" alt="vdoc テンプレートによって生成された、デフォルトの変数名と型を宣言するコメント" class="margin-around" border="1" height="385" width="600"> | |
| <h2><a name="errorMessages"></a>エラーメッセージ</h2> | |
| <p>エディタでは、コードの入力中にその構文が分析され、構文エラーがあった場合は該当する行に下線が表示され、その横に赤い丸が設定されます。エラーの説明を表示するには、該当する行にマウスを置くか、赤い丸をクリックします。エラーの簡単な説明を示すツールチップが表示されます。 <br> | |
| <img src="../../../images_www/articles/71/php/editorguide/error-messaging-m1.png" alt="エラーメッセージ: エラーがある行の上に表示されたツールチップ" class="margin-around"> | |
| </p> | |
| <h2><a name="phpunit"></a>PHPUnit と Selenium のテスト</h2> | |
| <p>NetBeans IDE for PHP は、コードカバレージを含む <a target="_blank" href="http://www.phpunit.de">PHPUnit</a> 自動化テストをサポートしています。NetBeans IDE 7.1 以降では、コード内のテストグループを使用できます。</p> | |
| <p>NetBeans IDE では、PHPUnit に加えて、Selenium の移植可能なテストフレームワークもサポートされています。Selenium プラグインは、アップデートセンターから入手できます。このプラグインをインストールすると、Selenium サーバーが IDE の登録済みサーバーに追加され、Selenium のテストオプションが PHP のメニューに追加されます。</p> | |
| <p>詳細については、<a href="./phpunit.html">PHPUnit と Selenium を使用したテスト</a>を参照してください。</p> | |
| <h2 id="spellchecker">スペルチェッカー</h2> | |
| <p>スペルチェッカーを使用できます。「オプション」ダイアログで、さまざまな言語のスペルチェックをオンまたはオフに切り替えることができます。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/spellchecker-options.png" class="margin-around" alt="スペルチェッカーの「オプション」ダイアログ" width="600" height="448"></p> | |
| <p>「オプション」ダイアログでは、新しい辞書を追加および削除したり、ロケールを設定したりできます。新しい辞書を追加する場合、単語を含むファイルを用意する必要があります。辞書ファイルの形式は、各単語が新規行に記載された単語のリストです。辞書ファイルのエンコードと、ファイルが使用されるべきロケールを、NetBeans に対して指示する必要があります。 </p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/spellchecker-newdictionary.png" class="margin-around" alt="スペルチェッカーへの新規辞書の追加" width="600" height="180"></p> | |
| <p>スペルチェッカーは辞書にない単語を検出すると、その単語に赤色の下線を付けます。またスペルチェッカーはその単語に、「スペルミスの単語」と表示するツールチップを追加します。HTML テキストは PHP ファイル内でチェックされます。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/spellchecker-html.png" alt="PHP ファイル内の HTML テキストで検出されたエラー" width="600" height="68" class="margin-around"></p> | |
| <h2><a name="symfony"></a>Symfony フレームワークと Zend フレームワークのサポート</h2> | |
| <p>Symfony フレームワークと Zend フレームワークのサポートが PHP エディタに組み込まれています。これは、既存の Symfony フレームワークと Zend フレームワークを認識します。新規 PHP プロジェクトウィザードの最後のパネルで、新しいプロジェクトにフレームワークを追加できます。</p> | |
| <p>Symfony または Zend をサポートする PHP プロジェクトでは、プロジェクトのコンテキストメニューから Symfony または Zend コマンドを実行できます。</p> | |
| <img src="../../../images_www/articles/71/php/editorguide/symfony-contextmenu-commands.png" alt="Symfony コマンドを表示したコンテキストメニュー" class="margin-around"> | |
| <p>次の場合に、コマンドの UI を使用します。</p> | |
| <ul> | |
| <li>Symfony/Zend コマンドをフィルタする (1)</li> | |
| <li>コマンドパラメータを指定する (2)</li> | |
| <li>コマンドを選択する (3)</li> | |
| <li> コマンドのコンテキストヘルプを参照する (4) </li> | |
| <li>実行するコマンド全体をプレビューする (5)</li> | |
| </ul> | |
| <img src="../../../images_www/articles/72/php/editorguide/symfony-command-dialog.png" class="margin-around" alt="注釈つきの Symfony コマンドダイアログ"> | |
| <p>コマンドのリストはプロジェクト固有のものです。つまり、Propel の代わりに Doctrine を使用する場合、Propel コマンドはリストされず、Doctrine のコマンドだけがリストされます。プロジェクトの Symfony プラグインからのコマンドもすべて使用できます。</p> | |
| <p>コード補完は、Symfony ビューの Symfony 変数および Zend ビューの Zend 変数で使用できます。 </p> | |
| <img src="../../../images_www/articles/72/php/editorguide/symfony-variables.png" alt="コード補完での Symfony 変数" class="margin-around" border="1"> | |
| <p>IDE には、Symfony/Zend ビューとアクション間のナビゲーションショートカットも用意されています。NetBeans 6.9 ではこれらのショーカットが改善されたほか、<em>ビュー</em>テンプレート/ファイルでのコード補完に、<em>コントローラ/アクション</em>ファイル内で宣言されている変数が含まれるようになりました。詳細は、<a target="_blank" href="http://blogs.sun.com/netbeansphp/entry/framework_support_improvements">NetBeans PHP のブログ投稿</a>を参照してください。</p> | |
| <p>Zend フレームワークのサポートの詳細は、Zend の<a href="../../docs/php/zend-framework-screencast.html">スクリーンキャスト</a>を参照してください。</p> | |
| <h2><a name="smarty"></a> Smarty のサポート</h2> | |
| <p>NetBeans IDE 7.1 には Smarty フレームワークのサポート用のプラグインが含まれています。このサポートには、基本的な Smarty 3 機能、つまり Smarty 3 のコード補完と区切り記号が含まれます。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/smarty3.png" alt="基本的な Smarty 3 のサポートを示すエディタ" width="364" height="136" class="margin-around b-all"></p> | |
| <p>「オプション」ウィンドウで Smarty 3 と Smarty 2 の動作を切り替えます。「ツール」>「オプション」(MacOS の場合は「NetBeans」>「設定」) に移動し、「PHP」を選択して、「Smarty」タブを開きます。Smarty フレームワークのプラグインがインストールされている必要があります。</p> | |
| <p><img src="../../../images_www/articles/71/php/editorguide/smarty-options.png" alt="Smarty のオプション" width="586" height="480" class="margin-around"></p> | |
| <h2><a href="/about/contact_form.html?to=3&subject=Feedback:%20PHP%20Editor%20Guide">ご意見をお寄せください</a></h2> | |
| <br style="clear:both;" > | |
| <p><a href="../../../community/lists/top.html">users@php.netbeans.org メーリングリストに登録する</a>ことによって、NetBeans IDE PHP 開発機能に関するご意見やご提案を送信したり、サポートを受けたり、最新の開発情報を入手したりできます。</p> | |
| <p><a href="../../trails/php.html">PHP の学習に戻る</a></p> | |
| </body> | |
| </html> |