PhpStorm 2019.2ヘルプ

コードとパスの自動補完

このセクションでは、コーディングプロセスのスピードアップを可能にするコンテキスト対応コード補完のさまざまなテクニックについて説明します。

基本補完

基本コード補完を使用すると、可視性の範囲内でクラス、メソッド、およびキーワードの名前を完成させることができます。コード補完を起動すると、PhpStormはコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します(提案にはライブ・テンプレートも含まれます)。

基本コード補完がフィールド、パラメーター、または変数宣言の一部に適用されている場合、PhpStormは項目タイプに応じて可能な名前のリストを提案します。

基本コード補完を2回目に呼び出すと、アクセスできないクラスとメンバーが表示されます(これらはインテンションアクションを適用することで公開できます)。

基本補完を呼び出す

  1. 名前の入力を開始します。

  2. Ctrl+Space を押すか、メインメニューからコード | 補完 | 基本を選択してください。

    Basic Code Completion

  3. 必要に応じて、Ctrl+Space を2回押します(または Ctrl+Alt+Spaceを押します)。

    これは、アクセスできないクラスとメンバー、および静的なフィールドとメソッドを示しています。

    Basic Code Completion Static Methods

スマート補完

スマートコード補完は候補リストをフィルタリングし、現在のコンテキストに適用可能なタイプのみを表示します。

スマートな補完を呼び出す

  1. 入力を開始します。

  2. Ctrl+Shift+Space を押すか、メインメニューからコード | 補完 | スマート入力を選択してください。

    現在のコンテキストに最も適した提案が強調表示されます。

    Smart type completion

ステートメント補完

文の補完を使用して、構文的に正しいコード構成体を作成できます。必要な構文要素(括弧、中括弧、セミコロン)を挿入して、次のステートメントの入力を開始できる位置に移動します。

メソッド宣言を補完する

メソッド宣言の入力を開始し、左括弧の後に Ctrl+Shift+Enter を押します。

complete declaration 1
complete declaration 2

コード構成を補完する

コード構成の入力を開始し、Ctrl+Shift+Enterを押します。

Completing code construct

PhpStormは自動的に構文を完成させて必要な句読点を追加し、キャレットは次の編集位置に配置されます。

completing code construct

メソッド呼び出しの引数をラップする

  1. 式を入力する

    "test"

  2. メソッド呼び出しを入力します: strlen が候補リストにフォーカスを当てたら、それを Ctrl+Shift+Enterで選択します:

    Auto-encapsulation

    結果のコードは次のようになります。

    Auto-encapsulation

ヒッピー補完

ヒッピー補完は、目に見える範囲でテキストを分析し、現在のコンテキストから提案を生成する補完エンジンです。それは現在開いているファイルのどれからでもどんな単語でも完成させるのに役立ちます。

キャレットの文字列を既存の単語に展開する

  1. 最初の文字列を入力し、次のいずれかを実行します。

    • Alt+/ を押すか、コード | 補完 | 循環的に単語を展開を選択して、キャレットの前に一致する単語を検索します。

    • Shift+Alt+/ を押すか、コード | 補完 | 循環的に単語を展開 (後方)を選択して、キャレットの後ろにある他の開いているファイルで一致する単語を検索します。

    提案された最初の値が表示され、プロトタイプがソースコードで強調表示されます。

    Expand word
  2. 提案を受け入れるか、Alt キーを押しながら希望の単語が見つかるまで / を押し続けます。

後置コード補完

後置コード補完を使うと、コードを書くときの後方キャレットジャンプを減らすことができます。既にタイプされた式は、ドット、式のタイプ、およびそのコンテキストの後に入力する接尾辞に基づいて別のものに変換できます。

  • 使用可能なポストフィックステンプレートの全リストを表示するには、設定/環境設定ダイアログ(Ctrl+Alt+S)でエディター | 一般 | 後置補完に移動します。

  • 接尾辞テンプレートを展開するには、Tab , Spaceまたは Enter を選択します。

後置でステートメントを変換する

  • 式を入力し、ドットの後に接尾辞を入力します(例: .if:)。

    function m(arg) { arg.if }

    最初の式は if ステートメントでラップされます。

    function m(arg) { if (arg) { } }

特定の後置補完テンプレートを無効にするには、設定/環境設定ダイアログ(Ctrl+Alt+S)でエディター | 一般 | 後置補完を選択します。

接尾辞テンプレートを拡張するには、Tab , Spaceまたは Enter を選択できます。

たとえば、長いキーを短いキーに置き換えるか、適用可能な式の種類のリストを展開するなど、あらかじめ定義されたポストフィックステンプレートを編集できます。

カスタム後置テンプレートを作成する

  1. 設定/環境設定ダイアログ(Ctrl+Alt+S)で、エディター | 一般 | 後置補完に進みます。

  2. ツールバーの the Add button をクリックします。表示されるポップアップメニューで、後置テンプレートを作成するのに必要な言語を選択してください。

  3. キー、つまりテンプレートを呼び出すシンボルの組み合わせを指定し、新しいテンプレートを適用する式の種類を選択して、ターゲット式を $EXPR$ <target_expression>$EXPR$ !== nullなど)の形式で入力します。

    テンプレートが適用された後にキャレットを配置する $END$ を追加します。たとえば、次のようになります。

    $EXPR$ !== null; $END$
  4. テンプレートが呼び出されたときにPhpStormが最上位の適用可能な式を自動的に変換するようにするには、一番上の式に適用するチェックボックスを選択します。

    それ以外の場合、チェックボックスをオフにすると、PhpStormはテンプレートを呼び出すときに式を選択するように求めます。

    apply custom postfix template

タグと属性の完成

PhpStormは、多くのファイルタイプのタグと属性の名前と値を自動的に補完します。

タグと属性名の補完は、ファイルが関連付けられているDTDまたはスキーマに基づいています。スキーマ関連がない場合、PhpStormはファイル内容(タグと属性名とその値)を使用して入力を完了します。

タグ名の補完

  1. < を押し、タグ名の入力を開始します。PhpStormは、現在のコンテキストで適切なタグ名のリストを表示します。

    Tags completion
    ArrowUpArrowDown のボタンを使ってリストをスクロールします。

  2. Enter を押して、リストから選択を受け入れます。ファイルがスキーマまたはDTDに関連付けられている場合、PhpStormはそれに応じて必須属性を自動的に挿入します。

コード補完設定を構成する

補完オプションを設定する

  1. 設定/環境設定ダイアログ(Ctrl+Alt+S)で、エディター | 一般 | コード補完を選択します。

  2. 以下を実施:

    • 候補リスト自動的に表示するには、入力時に候補を表示するチェックボックスを選択します。チェックボックスをオフにすると、コード補完を明示的に呼び出す必要があります。これは、Ctrl+Space を基本補完のために、または Ctrl+Shift+Space をスマートな補完のために押すことによって行われます。

      また、単一の候補を自動的に挿入にある補完タイプを選択するだけで、自動的に候補を挿入することもできます。

    • アルファベット順に候補並べ替えるには、関連性によってソートするのではなく、候補をアルファベット順にソートするチェックボックスを選択します。

      また、候補リストの右下隅にある the Sort Alphabetically button または the Sort by Relevance button をクリックすると、これらのモードを切り替えることができます。

    • 補完オプションを提案する際に大文字小文字を考慮するには、大/小文字を区別するを選択して、大文字と小文字を区別するか、すべての文字を大文字にするかを選択します。

    • 候補リストをスクロールするときに、その候補リスト内の各項目ごとに資料ポップアップを自動的に表示したい場合は、ドキュメントのポップアップを表示するオプションを選択します。右側のフィールドで、ポップアップが表示されるまでの遅延(ミリ秒)を指定します。

パスの完成

このタイプの補完は、ファイルとフォルダーの選択をスピードアップします。この目的のために使用されるダイアログは、たとえば、外部ツールまたはバージョン管理エンジンのインストールフォルダーを指定するか、PHPインタープリターを設定する場合など、頻繁に呼び出されます。

  1. ファイルメニューでファイルを開くを選択するか、パスが必要なフィールドの横にある参照 the Browse button をクリックして、パス選択ダイアログを開きます。

  2. パスフィールドが表示されていることを確認します。フィールドが非表示の場合は、パスを表示リンクをクリックします。

  3. パスを入力してください。PhpStormはすぐに必要なディレクトリーを見つけることができるリストを提案します。

    ps_complete_path_1.png
    入力すると、候補リストが縮小され、一致するパスのみが表示されます。
    ps_complete_path_2.png
    Ctrl+Space を押して、候補リストを表示することもできます。

  4. 関連する提案をリストから選択します。

補完のヒントとテクニック

候補リストを絞り込む

単語の任意の部分(途中の文字からでも)を入力するか、ドット区切り記号または ->の後にコード補完を呼び出すことによって、候補リストを絞り込むことができます。PhpStormはどんな位置にも入力した文字を含む提案を表示します。

これはワイルドカードの使用を不要にします:

suggestion_list_wildcards.png

CamelCaseまたはsnake_caseの名前の場合は、最初の文字のみを入力します。PhpStormは最初の文字を自動的に認識して一致させます。

提案を受け入れる

次のいずれかの方法で、リストから提案を受け入れることができます。

  • Enter を押すか、リスト項目をダブルクリックして、キャレットの左側に挿入します。

  • Tab を押して、キャレットから右にある文字を置き換えます。

  • Ctrl+Shift+Enter を使用して、現在のコード構成を構文上正しいものにします(括弧のバランス、欠落している中括弧とセミコロンの追加など)。

特定のキーを使用して選択した補完候補を挿入することもできます。設定/環境設定ダイアログ(Ctrl+Alt+S)でエディター | 一般 | コード補完を選択し、スペース、ドット、その他のコンテキスト依存キーを押して選択した候補を挿入するオプションを選択します。これらのキーは言語、あなたの文脈などに依存します。

リファレンスを表示する

  • 候補リストの項目を選択するときに Ctrl+Shift+I を押すと、定義を使用できます。

    completion quick definition

  • 候補リストの項目を選択するときに Ctrl+Q を押すと、クイックインフォメーションビューを使用できます。

    Quick documentation

コード階層を表示する

候補リストからエントリを選択したときにコード階層を表示できます。

  • Ctrl+H : ビュー型階層

  • Ctrl+Alt+H : 呼び出し階層を表示します。

  • Ctrl+Shift+H : メソッドの階層を表示します。

トラブルシューティング

コード補完が機能しない場合は、次のいずれかの理由が考えられます。

  • 省電力モードがオンです(ファイル | 省電力モード)。これをオンにすると、エラー強調表示、オンザフライインスペクション、コード補完などのバックグラウンド操作を排除してラップトップの電力消費を最小限に抑えられます。

  • ファイルはコンテンツ・ルートに存在しないため、コード補完に必要なクラス定義とリソースを取得しません。

  • 補完候補リストに表示するクラスと関数を含むファイルは、プレーンテキストファイルとしてマークされています。

  • 補完候補リストに表示する関数を含む外部ライブラリーは、依存関係やグローバルライブラリーとして追加されません。

最終更新日: 2019年9月3日

関連事項

リファレンス:

関連ページ:

ライブ・テンプレート

ライブテンプレートを使用することで、頻繁に使用される構造をコードに挿入できます: 例:ループ、条件、さまざまな宣言、またはprintステートメントコードスニペットを拡張するには、対応するテンプレートの略語を入力して を押します。 を押し続けると、テンプレート内のある変数から次の変数にジャンプします...

インテンション・アクション

エディターで作業するときに、PhpStormはコードを分析し、コードを最適化する方法を検索し、潜在的な問題と実際の問題を検出します。IDEがコードを変更する方法を見つけるとすぐに、エディターの現在行の隣に黄色い電球のアイコンが表示されます。このアイコンをクリックすると、現在のコンテキストで利用可能な...

スタイル・シート

PhpStormを使用すると、Sass、Less、SCSS、Stylusなど、CSSおよびそれにコンパイルされるさまざまな言語でスタイル定義を記述できます。スタイルシートのドキュメントを参照したり、ルールセットを作成および移動したり、変数を抽出したりすることもできます。コード補完:PhpStormは...

React

Reactは、カプセル化されたコンポーネントから複雑なインタラクティブユーザインターフェースを構築するためのJavaScriptライブラリーです。ライブラリーの詳細については、React公式サイトを参照してください。PhpStormは、Reactと統合され、lintの設定、編集、実行、デバッグ、およ...

補完

コード補完をPhpStormの重要な機能の1つとすることで、プラグインは、キーワード、事前定義された関数、XPath式で使用される変数とパラメータ、テンプレート名、およびテンプレート呼び出しに渡すことができるパラメータの名前を完成させるいくつかの可能性を提供します。XPath式の補完:通常の式属性の...

npmおよびYarn

PhpStormはnpmおよびYarnパッケージマネージャーと統合されているため、IDE内から再利用可能なコードのパッケージをインストール、検索、アップグレード、および削除できます。Node.jsとNPMページは、パッケージを管理するための専用UIを提供します。もちろん、ビルトインターミナルのコマン...