PhpStorm 2026.1 Help

PHP

このページとこのノードのすべてのページは、 PHP プラグインが有効な場合にのみ使用できます。 PHP プラグインは PhpStorm にバンドルされており、デフォルトで有効になっています。 プラグインが無効になっている場合は、 プラグインのマッピングの説明に従って 設定 | プラグイン で有効にします。

このページで、利用可能な PHP インタープリターの中から選択して、プロジェクトの PHP 開発およびユニットテストのサポートを構成できます。

項目

ツールチップ /

ショートカット

説明

PHP 言語レベル

このリストでは、コーディング支援を受ける PHP 機能の範囲を指定します。 各機能スコープは、この機能をサポートする PHP バージョンに関連付けられています。 現在、 PHP 5.3PHP 5.4PHP 5.5PHP 5.6PHP 7PHP 7.1PHP 7.2PHP 7.3PHP 7.4PHP 8.0PHP 8.1PHP 8.2 レベルがサポートされています。 詳細については、 「サポートされている PHP バージョン」を参照してください。

プロジェクトで使用する PHP バージョンと、PhpStorm で設定されている PHP 言語レベルの間に強制的な相関関係はありません。 各インタープリターの言語バージョンは自動的に検出されますが、異なる言語レベルに対応したコーディング支援を PhpStorm に提供させることもできます。 ただし、指定した言語レベルでサポートされていないコード構成を使用しようとすると、PhpStorm は PHP <version> に切り替える; クイックフィックスを提案します。

既存のプロジェクトを開くと、PhpStorm は使用されている言語機能を分析し、適切な言語レベルを自動的に設定します。

CLI インタープリター

このリストで、現在のプロジェクトでデフォルトで使用する PHP インタープリターを選択します。 リストには、現在設定されているすべてのローカルおよびリモート PHP インタープリターが含まれています。 詳細については、 ローカル PHP インタープリターを構成するリモート PHP インタープリターの構成 を参照してください。

閲覧ボタン

Shift+Enter

CLI インタープリター リストの横にあるこのボタンをクリックし、開いた CLI インタープリター ダイアログで新しい PhpStorm 全体の PHP インストール構成を作成します。

詳細については、 ローカル PHP インタープリターを構成する および リモート PHP インタープリターの構成 を参照してください。

パスマッピング

SFTP、Vagrant、Docker、WSL 経由でアクセス可能な リモートインタープリターを構成する場合、この読み取り専用フィールドには、対応するデプロイ構成、 Vagrantfile Dockerfile から取得されたパスマッピングが表示されます。 これらのマッピングは読み取り専用です。

カスタムマッピングを提供するには、フィールドの横にある 閲覧ボタン をクリックして、表示される プロジェクトパスマッピングの編集 ダイアログで指定します。

  • カスタムマッピングを追加するには、 追加ボタン をクリックして、プロジェクト内のパスとリモートランタイム環境の対応するパスをそれぞれ ローカルパス フィールドと リモートパス フィールドに指定します。 手動でパスを入力するか、 閲覧ボタン をクリックして表示されるダイアログで関連ファイルまたはフォルダーを選択します。

  • カスタムマッピングを削除するには、リスト内でカスタムマッピングを選択し、 削除ボタン をクリックします。

インクルードパスタブ

この領域には、構成された インクルードパスのリストが表示されます。 インクルードパスは、 PHP ライブラリ 、つまり、 require()含める() など、ファイルパスを引数として使用する一部の関数 / メソッドで補完および参照解決に使用されるサードパーティコードを保持するために使用されます。

  • 追加 および 削除 を使用してフォルダーパスを追加および削除します。

  • スピード検索を使用することでリストを検索できます。アイテムの名前をすぐに入力するか、 Ctrl+F を押して検索フィールドを表示してください。

  • プロジェクト分析からフォルダーの内容を除外します。 これを行うには、フォルダーを選択し、ツールバーの このパス以下を除外 をクリックし、表示されるファイル検索ダイアログで除外するネストされたフォルダーへのパスを選択します。

「PHP ランタイム」タブ

この領域には、利用可能な PHP スタブが一覧表示されます。これらは注釈付きの関数・メソッド・クラスのシグネチャー、定数定義などを含む通常の構文的に正しい PHP ファイルです。 PHP スタブは、すべての Standard PHP ライブラリ コンポーネントおよび一般的な拡張機能へのコーディング支援を強化するために、PhpStorm の内部知識に追加されます。

  • 対応するスタブを有効または無効にするには、各項目の横にあるチェックボックスを使用します。

  • 現在構成されている CLI インタープリター用にロードされている拡張機能のセットと一致するスタブのセットをロードするには、「インタープリターによる拡張機能の同期 」ボタンをクリックします。 インタープリターの構成の詳細については、「」および「リモート PHP インタープリターの構成 」を参照してください。

プロジェクトツールウィンドウ では、現在ロードされているスタブが 外部ライブラリノードに表示されます。

詳細設定エリア

必要に応じて、PhpStorm で使用するカスタム PHP スタブのセットをロードできます。 デフォルトスタブパス フィールドの横にある 閲覧ボタン をクリックし、開いたダイアログでスタブフォルダーの場所を指定します。 この方法で、追加の PhpStorm スタブをロードしたり、バンドルされているものをオーバーライドしたりできます。

PHP スタブは Composer パッケージ(英語)として使用できるため、サードパーティパッケージの依存関係として宣言およびインストールできます。 この場合、プロジェクト内の vendor/jetbrains/phpstorm-stubs フォルダーに保存されます。

Composer パッケージスタブと PhpStorm バンドルスタブの競合を防ぐには、次のいずれかを実行してください:

  • プロジェクトで Composer パッケージスタブを使用するには、 デフォルトスタブパス フィールドにそれらの場所へのパスを明示的に指定します。

  • PhpStorm にバンドルされた PHP スタブを使用するには、 デフォルトスタブパス フィールドがクリアされ、 vendor/jetbrains/phpstorm-stubs フォルダーがプロジェクトから除外されていることを確認してください。

    • 設定 ダイアログ(Ctrl+Alt+S )の PHP | Composer ページで パッケージをライブラリとして追加する オプションが有効化されている場合、PhpStorm は vendor/jetbrains/phpstorm-stubs フォルダーを自動的に 除外としてマークします。 デフォルトでは、このオプションは有効になっています。

    • パッケージをライブラリとして追加する が無効になっている場合は、 スタブパッケージフォルダーを手動で除外できます。 これを行うには、 プロジェクト ビューで vendor/jetbrains/phpstorm-stubs フォルダーを右クリックし、コンテキストメニューから ディレクトリをマーク | 除外 を選択します。

「分析」タブ

特定の PhpStorm インスペクションの動作を設定するには、このタブを使用します。

例外分析

このセクションでは、例外分析を構成できます。これにより、 未処理の例外冗長な catch 節@throws タグ不足冗長な @throws タグインスペクションの挙動が変更されます。

項目

ツールチップ /

ショートカット

説明

呼び出しツリー分析の深さ

このリストを使用して、希望する例外分析の深さレベルを設定します。 デフォルトでは 1 が選択されており、この場合 PhpStorm は例外をスローする親メソッドおよびそれを直接呼び出しているメソッドの未処理例外を報告します。 より大きな値を選択すると、呼び出し階層をより深く掘り下げることができます。

0 が選択されている場合、例外解析は親メソッドに限定されます。

定数パラメーターの呼び出しをスキップする

このチェックボックスを選択すると、例外分析中に PhpStorm がインスタンス生成式で特定のメソッド呼び出しをスキップします:

  • パラメーターとして文字列や定数のみを持つメソッド呼び出しはスキップされます:

    $date = new DateTime('2019-01-01');
  • 変数、整数、配列などをパラメーターとして持つメソッド呼び出しはスキップされません:

    $date = new DateTime($myDate);

非チェック例外

このリストを使用して、PhpStorm が未チェックとして扱う例外を指定します。 このような例外は、例外解析中にスキップされます。

クラスの追加

Alt+Insert

このボタンをクリックすると、クラスが 非チェック例外 リストに追加されます。 表示される クラスの選択 ダイアログで、 名前で検索する タブまたは プロジェクト タブを使用して目的のクラスを見つけます。

削除ボタン

Delete

選択したクラスを 非チェック例外 リストから削除するには、このボタンをクリックします。

カスタムフォーマット関数

このセクションを使用して、カスタム文字列フォーマット関数を フォーマット関数パラメーターの不一致インスペクション分析スコープに含めます。 このインスペクションは、フォーマット関数パラメーターと仕様変換エントリ間の不一致を報告し、デフォルトで標準の PHPprintf(英語) および sprintf(英語) 関数の使用箇所を分析します。

項目

ツールチップ /

ショートカット

説明

追加ボタン

Alt+Insert

このボタンをクリックして、新しい関数レコードをカスタム形式関数リストに追加します。 開いた カスタムフォーマット関数の追加… ダイアログで、クラスメソッドまたは関数の名前を指定し、フォーマットテンプレートが存在する引数のインデックスを指定します。

削除ボタン

Delete

カスタムフォーマット関数リストから関数レコードを削除するには、このボタンをクリックします。

編集ボタン

Enter

このボタンをクリックして、選択した関数レコードを編集します。

インクルード分析

このセクションを使用して、 $_SERVER['DOCUMENT_ROOT'] 式が解決する必要があるカスタムフォルダーを定義し、 解決できない include インスペクションの動作を変更します。

指定されたパスは、 コード補完で、ファイルパスを引数として使用する関数 / メソッド(たとえば、 require() または 含める() )に使用されます。 パスを空白のままにすると、コード補完はプロジェクトルートに関連するパスを提案します。

通常、この設定は、Web サーバー構成で定義されたドキュメントルートフォルダーが PhpStorm プロジェクトのルートフォルダーと異なる場合に変更する必要があります。

項目

説明

$SERVER['DOCUMENTROOT']

このフィールドに、 $_SERVER['DOCUMENT_ROOT'] 式が解決するフォルダーを指定します。

デフォルト値は空白です: この場合、 $_SERVER['DOCUMENT_ROOT'] 式はプロジェクトのルートフォルダーに解決されます。 それを別のフォルダーに解決するには、プロジェクトルートからの相対パスを入力するか、 ディスクから開く をクリックして開きたいダイアログボックスで目的のフォルダーを選択します。

2026 年 5 月 22 日