PHP リファレンス

このノードのページとすべてのページは、 PHP プラグインが有効になっている場合にのみ使用できます。 PHP プラグインは IntelliJ IDEA にバンドルされていませんが、 JetBrains Marketplace からプラグインをインストールするに従って、設定 | プラグインページの Marketplace タブでインストールできます。

このページを使用して、使用可能な PHP インタープリターの 1 つを選択して、プロジェクトでの PHP 開発および単体テストのサポートを構成します。

項目	ツールチップ / ショートカット	説明
PHP 言語レベル(P)		このリストでは、コーディング支援を受ける PHP 機能の範囲を指定します。各機能スコープは、この機能をサポートする PHP バージョンに関連付けられています。現在、 PHP 5.3、 PHP 5.4、 PHP 5.5、 PHP 5.6、 PHP 7、 PHP 7.1、 PHP 7.2、 PHP 7.3、 PHP 7.4、 PHP 8.0、 PHP 8.1、 PHP 8.2 レベルがサポートされています。詳細については、「サポートされている PHP バージョン」を参照してください。プロジェクトで使用される PHP バージョンと IntelliJ IDEA で構成された PHP 言語レベルの間に強制的な相関関係はありません。各インタープリターの言語バージョンは自動的に検出されますが、さまざまな言語レベルに対応するコーディング支援を提供するように IntelliJ IDEA に指示することもできます。ただし、指定された言語レベルでサポートされていないコード構成を使用しようとすると、IntelliJ IDEA は PHP <version> に切り替えるクイックフィックスを提案します。既存のプロジェクトを開くと、IntelliJ IDEA は使用されている言語機能を分析し、適切な言語レベルを自動的に設定します。ステータスバーから直接 PHP 言語レベルを設定することもできます。 PHP 言語バージョンが composer.json で制限されており、設定ダイアログ (`Ctrl+Alt+S`) の Composer のページで composer.json との設定同期が有効になっている場合、リストは非アクティブになります。
CLI インタープリター		このリストで、現在のプロジェクトでデフォルトで使用する PHP インタープリターを選択します。リストには、現在構成されているすべてのローカル PHP インタープリターとリモート PHP インタープリターが含まれます。詳細については、ローカル PHP インタープリターを構成するおよびリモート PHP インタープリターの構成を参照してください。
	`Shift+Enter`	CLI インタープリターリストの横にあるこのボタンをクリックして、開く CLI インタープリターダイアログで新しい IntelliJ IDEA 全体の PHP インストール構成を作成します。詳細については、ローカル PHP インタープリターを構成するおよびリモート PHP インタープリターの構成を参照してください。
パスマッピング		SFTP、Vagrant、Docker、WSL 経由でアクセス可能なリモートインタープリターを構成する場合、この読み取り専用フィールドには、対応するデプロイ構成、 Vagrantfile 、 Dockerfile から取得されたパスマッピングが表示されます。これらのマッピングは読み取り専用です。カスタムマッピングを提供するには、フィールドの横にあるをクリックして、表示されるプロジェクトパスマッピングの編集ダイアログで指定します。カスタムマッピングを追加するには、をクリックして、プロジェクト内のパスとリモートランタイム環境の対応するパスをそれぞれローカルパスフィールドとリモートパスフィールドに指定します。手動でパスを入力するか、をクリックして表示されるダイアログで関連ファイルまたはフォルダーを選択します。カスタムマッピングを削除するには、リスト内でカスタムマッピングを選択し、をクリックします。除外済みとしてマークされているプロジェクトファイルまたはフォルダーには、パスマッピングを設定できません。

インクルードパスタブ

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

およびを使用してフォルダーパスを追加および削除します。
スピード検索を使用することでリストを検索できます。アイテムの名前をすぐに入力するか、 Ctrl+F を押して検索フィールドを表示してください。
フォルダーの内容をプロジェクトの解析から除外します。これを行うには、フォルダーを選択し、ツールバーのこのパス以下を除外をクリックし、表示されるファイル検索ダイアログで除外するネストされたフォルダーへのパスを選択します。

「PHP ランタイム」タブ

このエリアには、利用可能な PHP スタブが一覧表示されます。スタブは、アノテーション付きの関数、メソッド、クラスのシグネチャーや定数定義などを含む、通常の構文的に正しい PHP ファイルです。 PHP スタブは IntelliJ IDEA の内部知識に追加され、すべての標準 PHP ライブラリコンポーネントおよび一般的な拡張機能に対するコーディング支援を強化します。

対応するスタブを有効または無効にするには、各項目の横にあるチェックボックスを使用します。
現在構成されている CLI インタープリター用にロードされている拡張機能のセットと一致するスタブのセットをロードするには、「拡張機能をインタープリターと同期」ボタンをクリックします。インタープリターの構成の詳細については、「ローカル PHP インタープリターを構成するおよびリモート PHP インタープリターの構成」を参照してください。

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

詳細設定エリア

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

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

Composer パッケージスタブと IntelliJ IDEA バンドルスタブ間の競合を防ぐには、次のいずれかを実行します。

プロジェクトで Composer パッケージスタブを使用するには、デフォルトスタブパス(D) フィールドにそれらの場所へのパスを明示的に指定します。
IntelliJ IDEA にバンドルされている PHP スタブを使用するには、デフォルトスタブパス(D) フィールドがクリアされ、 vendor/jetbrains/phpstorm-stubs フォルダーがプロジェクトから除外されていることを確認してください。
- 設定ダイアログ (Ctrl+Alt+S) の言語 & フレームワーク | PHP | Composer ページでパッケージをライブラリとして追加する(A) オプションが有効になっている場合、IntelliJ IDEA は自動的に vendor/jetbrains/phpstorm-stubs フォルダーを除外としてマークします。デフォルトでは、このオプションは有効になっています。
- パッケージをライブラリとして追加する(A) が無効になっている場合は、スタブパッケージフォルダーを手動で除外できます。これを行うには、プロジェクトビューで、 vendor/jetbrains/phpstorm-stubs フォルダーを右クリックし、コンテキストメニューからディレクトリを指定項目にする | 除外を選択します。

「分析」タブ

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

例外分析

このセクションを使用して、例外解析を構成します。これにより、未処理の例外、冗長な catch 節、欠落した @throws タグ、冗長な @throws タグインスペクションの動作が変更されます。

項目	ツールチップ / ショートカット	説明
呼び出しツリー解析の深さ		このリストを使用して、例外解析の深さレベルを設定します。デフォルトでは 1 が選択されており、この場合、IntelliJ IDEA は例外をスローする親メソッドおよびそれを直接呼び出しているメソッドに対して、未処理の例外をレポートします。より大きい値を選択すると、呼び出し階層をより深く追跡することができます。 0 が選択されている場合、例外解析は親メソッドに限定されます。 1 より大きい値は、IDE のパフォーマンスに悪影響を与える可能性があります。
定数パラメータを使用する呼び出しをスキップ		例外分析中に IntelliJ IDEA がインスタンス作成式で特定のメソッド呼び出しをスキップするようにするには、このチェックボックスを選択します。パラメーターとして文字列または定数のみを持つメソッド呼び出しはスキップされます。 $date = new DateTime('2019-01-01'); 変数、整数、配列などをパラメーターとして持つメソッド呼び出しはスキップされません。 $date = new DateTime($myDate);
非チェック例外		このリストを使用して、IntelliJ IDEA によってチェックされていないものとして処理される例外を指定します。このような例外は、例外解析中にスキップされます。
	`Alt+Insert`	このボタンをクリックすると、クラスが非チェック例外リストに追加されます。表示されるクラスの選択ダイアログで、名前で検索タブまたはプロジェクトタブを使用して目的のクラスを見つけます。
	`Delete`	選択したクラスを非チェック例外リストから削除するには、このボタンをクリックします。

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

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

項目	ツールチップ / ショートカット	説明
	`Alt+Insert`	このボタンをクリックして、新しい関数レコードをカスタム形式関数リストに追加します。開いたカスタムフォーマット関数の追加… ダイアログで、クラスメソッドまたは関数の名前を指定し、フォーマットテンプレートが存在する引数のインデックスを指定します。
	`Delete`	カスタム形式関数リストから関数レコードを削除するには、このボタンをクリックします。
	`Enter`	このボタンをクリックして、選択した機能レコードを編集します。

項目

ツールチップ /

ショートカット

説明

Alt+Insert

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

Delete

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

Enter

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

インクルード分析

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

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

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

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

項目

説明

$SERVER['DOCUMENTROOT']

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

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

2026 年 3 月 30 日