PhpStorm 2020.3 ヘルプ

PHP

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

このページを使用して、使用可能な PHP インタープリターの 1 つを選択して、プロジェクトで PHP 開発およびユニットテストのサポートを設定します(ローカル PHP インタープリターを構成するおよびリモート PHP インタープリターの構成を参照)。

項目 ツールチップ /
ショートカット
説明
PHP 言語レベル

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

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

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

CLI インタープリター

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

the Browse button Shift+Enter

CLI インタープリターリストの横にあるこのボタンをクリックして、表示される CLI インタープリターダイアログに PhpStorm 全体の新しい PHP インストール設定を作成します。

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

パスマッピング

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

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

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

インクルードパスタブ

このエリアには、設定されたインクルードパスのリストが表示されます。インクルードパスは、require()include() など、引数としてファイルパスを使用する関数 / メソッドの補完と参照解決に使用されるサードパーティのコードを保持するために使用されます。

  • Add およびRemoveを使用してパスを追加および削除します。

  • Move upMove downを使用して、リスト内の項目を並べ替えます。

  • the Sort Alphabetically button をクリックして、パスを昇順でアルファベット順にソートします。

PHP ランタイムタブ

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

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

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

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

詳細設定エリア

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

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 によってチェックされていないものとして処理される例外を指定します。このような例外は、例外解析中にスキップされます。
Add class Alt+Insert このボタンをクリックすると、クラスが未チェックの例外リストに追加されます。表示されるクラスの選択ダイアログで、名前で検索タブまたはプロジェクトタブを使用して目的のクラスを見つけます。
Remove button Delete 選択したクラスを未チェックの例外リストから削除するには、このボタンをクリックします。

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

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

項目 ツールチップ /
ショートカット
説明
Add button Alt+Insert

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

Remove button Delete

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

Edit button Enter

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

インクルード分析

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

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

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

項目 説明
$_SERVER['DOCUMENT_ROOT']

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

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

関連ページ:

プラグインを管理する

PhpStorm のユーザーインターフェースはデフォルトでは英語です。日本語化する場合は、日本語言語パックのインストールを参照してください。プラグインは以下に示すように PhpStorm のコア機能を拡張します。バージョン管理システム、アプリケーションサーバー、およびその他のツールとの統合を提供する...

ローカル PHP インタープリターを構成する

ローカル PHP インタープリターは、リモート PHP インタープリターの反対側にコンピューターにインストールされた PHP エンジンであり、リモートホストまたはVagrantインスタンスにセットアップされた仮想環境にインストールできます。リモート PHP インタープリターの構成を参照してください。...

リモート PHP インタープリターの構成

リモート PHP インタープリターという用語は、リモートホストまたは仮想環境にインストールされた PHP エンジンを意味します。リモート PHP インタープリターという用語は、コンピューターにインストールされているローカル PHP インタープリターの反対語として使用されます。ローカル PHP インタ...

結果の取得と問題の解決

インスペクションがあなたのコードに問題を検出した場合、すぐにエディターで修正を適用することができます。ハイライトされたコード部分にキャレットを置き、 を押します。一部のインスペクションでは、 を押してプレビューを開くことができます。インスペクションを手動で起動した場合は、解析が終了した後に自動的に開...

ユーザーインターフェースの概要

PhpStorm でプロジェクトを開くと、デフォルトのユーザーインターフェースは次のようになります。プラグインのセットと構成設定によっては、IDE の外観と動作が異なる場合があります。エディター :フォーカス:エディターを使用して、ソースコードの読み取り、書き込み、探索を行います。アクションインジケ...

プロジェクトツールウィンドウ

プロジェクトツールウィンドウでは、様々な視点からプロジェクトを見て、新しいアイテム(ディレクトリ、ファイル、クラスなど)の作成、エディターでのファイルのオープン、必要なコードフラグメントへのナビゲートなど、様々なタスクを実行することができます。このツールウィンドウのほとんどの機能には、コンテンツペイ...