PhpStorm 2026.1 Help

コード補完

基本コード補完は、可視性スコープ内のクラス、メソッド、キーワードの名前を補完するのに役立ちます。

PhpStorm はコンテキストを分析し、現在のキャレット位置から到達可能な選択肢を提案します。 候補には ライブテンプレートも含まれます。 補完機能は英語以外のキーボードレイアウトでも利用できます。

基本補完を呼び出す

  • デフォルトでは、PhpStorm は入力時に自動的にコード補完ポップアップを表示します。

    あるいは、 Ctrl+Space を押すか、メインメニューから コード | コード補完 | 基本 を選択することもできます。

    基本コード補完

リストからの提案を受け入れる

  • Enter を押すか、該当するリストアイテムをダブルクリックして、キャレットの左側に挿入します。

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

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

  • 特定のキーとカスタム文字を使用して、選択した補完候補を承認します。 これらの機能を有効化するには、 エディター | 一般 | コード補完 設定ページ  Ctrl+Alt+S に移動し、以下の操作を行ってください:

    1. 特定のキーを使用するには、 スペース、ドット、他のコンテキスト依存キーを押して選択された候補を挿入する チェックボックスをオンにします。 これらのキーは、言語、コンテキストなどによって異なります。

    2. カスタム文字も使用するには、 補完を受け入れるための追加文字 フィールドに文字を入力します。

機械学習による補完ランキング

PhpStorm では、他のユーザーが同様の状況で行った選択に基づいて補完提案の優先順位を設定できます。

ML 補完メカニズムは新しい要素を追加するのではなく、コードから取得した要素を順序付けます。 データはどこにも公開されず、ローカルで収集されます。

ML 補完ランキングを有効にする

  1. Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | コード補完 を選択します。

  2. 機械学習で候補を並べ替え機械学習に基づいて補完候補を並び替え オプションを有効化し、ML 補完を使用したい言語を選択してください。

    ML 支援補完設定

関連性マーカーを有効にする

  1. Ctrl+Alt+S を押して設定を開き、 エディター | 一般 | コード補完 を選択します。

  2. 次のオプションを有効化します:

    • 補完ポップアップで順位の変更箇所に印を付ける: 機械学習ランキングアップ および 機械学習ランキングダウン アイコンを使用して、提案の関連性が増加しているか減少しているかを示し、その結果、提案が候補リストを上下に移動したことを示します。

    • 補完ポップアップで最も関連性の高い項目に印を付ける: ML 関連の提案 アイコンを使用して、リストで最も適切な提案を示します。

    候補リストは次のようになり、アイコンが並べ替えと最も関連性の高いアイテムを示します。

    ML 支援の補完

コード補完設定の構成

コード補完オプションを設定するには、 エディター | 一般 | コード補完 の設定ページ  Ctrl+Alt+S へ移動します。

次の設定を選択できます:

項目

説明

大文字小文字を区別

補完候補で大文字と小文字を考慮するかどうかを選択します。 最初の文字の大文字と小文字を一致させるか、すべての文字を一致させるかを選択します。

単一の候補を自動的に挿入

基本的な型一致補完とスマート型一致補完の候補が 1 つしかない場合は、コードを自動的に補完します。

候補をアルファベット順に並べ替え

候補リストの項目を関連性ではなくアルファベット順に並べ替えたい場合は選択します。

この動作は、候補リストの をクリックして 命名で並べ替え オプションを切り替えることにより、いつでも変更できます。

入力時に候補を表示する

補完を明示的に呼び出すことなく、候補リストを自動的に呼び出す場合に選択します。 このオプションはデフォルトで有効になっています。

スペース、ドット、他のコンテキスト依存キーを押して選択された候補を挿入する

選択した候補を挿入する場合は、言語、コンテキストなどに依存する特定のキーを入力して選択します。

ドキュメントのポップアップ表示までの時間

候補リスト内の各項目に対して、ルックアップリストで現在ハイライトされているクラス、メソッド、フィールドのドキュメントを含む ポップアップを自動的に表示します

このオプションが無効になっている場合は、 Ctrl+Q を押すと要素のドキュメントが表示されます。

右側のフィールドに、ポップアップが表示されるまでの遅延(ミリ秒)を指定します。

可能な場合は丸括弧を自動的に挿入

このオプションを有効化すると、関数 / メソッドを補完する際に PhpStorm によって開き括弧と閉じ括弧のペアが自動的に挿入されます。

Insert parentheses on completion is enabled

チェックボックスをオフにすると、丸括弧の自動挿入が抑制されます。

Enter の代わりに開き括弧 ( を使用して、補完リストから選択した項目を適用すると、オプションがオンかオフかに関係なく、括弧が自動的に挿入されます。

Insert parentheses on completion is disabled. Parentheses are still inserted on completion with an opening brace.

Enter の代わりに開き括弧 ( を使用して、補完リストから選択した項目を適用するには、 設定 ダイアログ (Ctrl+Alt+S) を開き、 エディター | 一般 | コード補完 に移動して、 スペース、ドット、他のコンテキスト依存キーを押して選択された候補を挿入する チェックボックスを選択します。

詳細は、 特定のキーを使用して提案を挿入するを参照してください。

機械学習支援による補完

機械学習に基づいて補完候補を並び替え

機械学習モデルを使用して、最も適切な項目を候補リストの上位に表示したい場合は、このオプションを選択します。 機械学習に基づく提案を有効にする言語を選択してください。

補完ポップアップで順位の変更箇所に印を付ける

機械学習ランキングアップ および 機械学習ランキングダウン アイコンを使用して、提案の関連性が増加しているか減少しているかを示し、その結果、提案が候補リストの上下に移動したことを示します。

補完ポップアップで最も関連性の高い項目に印を付ける

ML 関連の提案 アイコンを使用して、リストで最も適切な提案を示します。

JavaScript

型ベース補完のみ

デフォルトでは、PhpStorm は型に関係なくシンボルの補完を提案します。 このアプローチでは、複雑な場合、リストに複数の補完バリアントが表示されます。

補完をより正確にするには、このオプションを選択します。 補完リストは PhpStorm の推論に強く依存します。 その結果、推論が不十分な場合にリストが空のままになることがあります。

Null 許容型に対してオプショナルチェイニングの使用を提案

デフォルトでは、PhpStorm は オプショナルチェイニング演算子 (?) を持つシンボルの補完を提案します。 この動作を抑制するには、このチェックボックスをオフにします。

オーバーライド時の補完でメソッド本体を展開する

デフォルトでは、親クラスやインターフェースからメソッドをオーバーライドし、補完候補リストからこのメソッドを選択すると、PhpStorm はパラメーターを自動で追加し、可能な場合は super() 呼び出しを生成し、型情報も追加します。

このチェックボックスをオフにすると、補完中のオーバーライドのためのメソッド本体が自動生成されなくなります。

命名の補完

  • 変数とパラメーターの命名を提案: デフォルトでは、チェックボックスはオフになっています。 オンにすると、PhpStorm は新しいクラスフィールド、変数、パラメーターの宣言時に命名を提案します。 これらの提案は、プロジェクト、使用しているライブラリ、標準 API で定義されているクラス、型、インターフェースの名前に基づいています。

  • クラスフィールドの命名を提案

    このオプションはデフォルトでオフになっています。

  • 提案されたパラメーター命名に型アノテーションを追加: このチェックボックスを選択すると、補完候補ごとにその型に関する情報が提供されます。

    このチェックボックスは、 変数とパラメーターの命名を提案 チェックボックスが選択されている場合にのみ使用できます。

パラメーター情報

パラメーター情報ポップアップを表示(ミリ秒単位)

このチェックボックスをオンにすると、エディターで開き角括弧を入力時や候補リストからメソッド選択時に、PhpStorm が利用可能なすべてのメソッドシグネチャーを含むポップアップを自動表示します。

右側のテキストフィールドに、ポップアップウィンドウが表示されるまでの遅延時間(ミリ秒)を入力します。

このチェックボックスが選択されていない場合は、 Ctrl+P を使用してパラメーター情報を表示します。

完全なメソッドシグネチャーを表示する

このチェックボックスをオンにすると、パラメーター情報にメソッド名や返された型などの完全なシグネチャーが表示されます。

SQL

オブジェクトを提案する

オブジェクトが提案される場所を選択します:

  • 現在の検索パスのみ: コンソールに選択されたスキーマのみ。

    スキーマの選択の詳細については、 クエリコンソールのデフォルトスキーマを設定する を参照してください。

  • 現在のスコープ: コンソールおよびシステムスキーマで現在選択されているスキーマ(例えば、PostgreSQL の pg_catalog)。

  • すべての使用可能なスキーマ: すべてのイントロスペクトされたスキーマ。

現在のパスからのみ提案されるオブジェクト
すべてのスキーマから提案されたオブジェクト
すべてのスキーマから提案されたオブジェクト

オブジェクトを修飾する

オブジェクトをデータベース、スキーマ、テーブル、ビュー、およびテーブルやビューのエイリアスで修飾するタイミングを選択します。

  • 常に: 修飾オブジェクト名は常に使用されます(例: <schema_name>.<object_name>)。

  • 競合する場合: 修飾されたオブジェクト名は、短縮名があいまいな場合 (たとえば、複数のスキーマに同じ名前のオブジェクトがある場合) にのみ使用されます。

  • 決して行わない: 修飾されていないオブジェクト名が常に使用されます。

オブジェクトは常にテーブルで修飾されます
テーブルで修飾されていないオブジェクト

オブジェクトを修飾する

特定のケースでオブジェクトをいつ修飾するか選択します。

  • 常に: 修飾オブジェクト名は常に使用されます(例: <schema_name>.<object_name>)。

  • 競合する場合: 修飾されたオブジェクト名は、短縮名があいまいな場合 (たとえば、複数のスキーマに同じ名前のオブジェクトがある場合) にのみ使用されます。

  • 決して行わない: 修飾されていないオブジェクト名が常に使用されます。

JOIN 補完内のオブジェクトは常に修飾されます
JOIN 補完内のオブジェクトは修飾されません

JOIN の補完にエイリアスを使用する

JOIN ステートメント内のテーブルに対してエイリアスを作成します。

JOIN の補完にエイリアスを使用する

自動生成された ON 句のオペランドの順序を逆にする

ON 句のオペランドを切り替えます。 チェックボックスをオフにすると、 FROM テーブルが JOIN 条件の最初に来ます。

自動生成された ON 句のオペランドの順序を逆にする

名前の一致に基づいて厳密でない外部キーを提案する

JOIN ステートメントの可能なコード補完提案のリストを生成します。 コード補完リストには、 JOIN ステートメントのテーブルの列と同じ名前を持つ他のテーブルの列の提案が含まれます。

このオプションのデバッグルールの詳細については、 仮想外部キーのデバッグルール を参照してください。

名前の一致に基づいて非厳密な外部キーを提案する
名前の一致に基づいて厳密でない外部キーを提案するはオフです

テーブル名を補完する際にエイリアスを自動的に追加する

テーブル名のエイリアスを作成します。

テーブル名を補完する際にエイリアスを自動的に追加する

テーブル名の後の補完でエイリアス名を提案する

コード補完(Ctrl+Space )を使用するときにテーブル名のエイリアスを提案します。

テーブル名の後の補完でエイリアス名を提案する

カスタムエイリアス (テーブル)

このテーブルに使用するテーブル名とエイリアスを追加できます。 テーブルとエイリアスのペアを追加するには、 エイリアスの追加 ボタン(エイリアス追加ボタン )をクリックします。

パスの補完

このタイプの補完により、ファイルとフォルダーの選択が高速化されます。 その目的で使用されるダイアログは、たとえば、外部ツールまたはバージョン管理エンジンのインストールフォルダーを指定したり、 PHP インタープリターを構成したりするときに、頻繁に呼び出されます。

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

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

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

    完全なパス

    入力すると、候補リストが縮小され、一致するパスのみが表示されます。

    Ctrl+Space を押して、候補リストを表示することもできます。

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

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

コード番号を入力して HTTP 定数を自動補完する

  • http などのインポートされたパッケージ名を指定した後、 404 と入力して値を http.StatusNotFound に自動補完できます。

候補リストを絞り込む

  • 単語の一部 (途中の文字でも可) を入力するか、ドット区切り記号または -戻り値のラップダイアログ の後にコード補完を呼び出すことによって、候補リストを絞り込みます。

    PhpStorm は入力した文字の位置に関係なく、それを含む候補を表示します。 これにより、ワイルドカードの使用は不要になります。

    suggestion_list_wildcards.png

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

リファレンスを表示する

  • 候補リストのエントリを選択した状態で Ctrl+Shift+I を押すと、 クイック定義ビューを利用できます:

    補完クイック定義
  • Ctrl+Q を押すか、候補リストのエントリを選択すると 自動的に クイック情報ビューを使用できます。

    クイックドキュメント

コード階層を表示する

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

  • Ctrl+H: 型階層の表示

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

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

トラブルシューティング

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

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

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

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

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

  • 補完オプションの収集に時間がかかりすぎる場合、コード補完ポップアップは自動的に表示されないことがあります。 例: コンピューターが別のタスクでビジー状態の場合。 この場合でも、 Ctrl+Space を介して補完ポップアップを手動でアクティブ化できます。

2026 年 5 月 22 日