自動インポート

現在のファイルの外で定義された PHP クラスを参照すると、PhpStorm がそのクラス定義を見つけて、次のいずれかを実行できます：

クラスが定義されている名前空間を含む、完全修飾クラス名を自動的に補完します。
短いクラス名を自動的に補完させ、クラスが定義されている名前空間をインポートします。
クイックフィックスを使用してネームスペースを手動でインポートします。

使用 ステートメントがインポートセクションに追加されますが、キャレットは現在の位置から移動せず、現在の編集セッションは中断されません。この機能はインポートアシスタントとして知られています。

JavaScript および TypeScript ファイルでは、PhpStorm は、モジュール、クラス、コンポーネント、エクスポート可能なその他のシンボルや XML 名前空間のインポートステートメントを自動的に追加します。 JavaScript での自動インポート、 TypeScript での自動インポート、 XML 名前空間のインポートの詳細を参照してください。

インポートステートメントを自動的に追加する

選択肢がない場合は、インポートステートメントを自動的に追加するように IDE を設定できます。

Ctrl+Alt+S を押して設定を開き、エディター | 一般 | 自動インポートを選択します。
PHP セクションで、名前空間の自動インポートを設定します。
- PhpStorm で、貼り付けたコードブロック内のクラスやメソッドに対して自動的に 使用 ステートメントを追加するには、インポートの挿入リストから希望の動作を選択してください：
  - すべて: import ステートメントは、貼り付けられたコードブロックにあるすべての見つからないクラスとメソッドに対して自動的に追加されます。
  - 確認する：PhpStorm はインポートしたいクラスやメソッドを選択するように促します。
    貼り付けられたクラスがターゲットコードでエイリアスを介してすでに参照されている場合、PhpStorm は新しいインポートステートメントを作成する代わりに、そのエイリアスの再利用を促します。
  - なし: インポート文は追加されず、未解決の参照について尋ねられることはありません。
  貼り付け時にインポートを追加できるのは、コピーした要素がコード内で適切に解決され (つまり、未定義のクラスまたは未定義のメソッドインスペクションによってハイライトされていない)、プロジェクト分析が完了している場合のみであることに注意してください。
  サードパーティのクリップボードマネージャー(英語)を使用すると、この機能が妨げられる可能性があります。問題が発生した場合は、クリップボードマネージャーを無効にすることを検討してください。
- 特定のネームスペースに属していないファイルを入力するときに自動ネームスペースインポートを適用するには、ファイルスコープで自動インポートを有効化チェックボックスをオンにします。
- 特定の名前空間に属するクラスまたはファイルを入力中に、PhpStorm が自動的に PHP 名前空間をインポートし、 use ステートメントを追加し、短いクラス名を即時補完するには、名前空間スコープで自動インポートを有効化チェックボックスを選択します。このチェックボックスはデフォルトで選択されています。
- 必要に応じて、クラス、関数、定数に対して個別にグローバル名前空間からの自動インポートを設定します。
  - FQN を優先する：選択した場合、PhpStorm は、グローバル名前空間からのシンボルの完全修飾名を、先頭にバックスラッシュを付けた形で自動的に挿入します。例：
    namespace A; $myException = new \Exception(); $a = \strlen("Test"); echo \PHP_EOL;
  - インポートを優先する：選択した場合、PhpStorm は 使用 ステートメントをグローバル名前空間からのシンボルに対して自動的に追加します（これが競合しない場合）、例：
    namespace A; use Exception; use const PHP_EOL; use function strlen; $myException = new Exception(); $a = strlen("Test"); echo PHP_EOL;
  - フォールバックを優先：選択した場合、PhpStorm は関数や定数の完全修飾名を挿入せず、また 使用 ステートメントによるインポートも行いません。この場合、フォールバックグローバル関数または定数が優先されます：
    namespace A; use Exception; $myException = new Exception(); $a = strlen("Test"); echo PHP_EOL;

自動インポートを無効にする

自動インポートを完全に無効化したい場合は、次のことを確認してください：

すべてのインポートツールチップが無効になっています。
インポートステートメントの自動挿入は無効になっています。

その場で PHP ネームスペースをインポートする

実行中のネームスペースのインポートを有効にします。
編集するファイルを開き、クラスの短い名前を入力し始めます。
コード補完候補リストから、希望のクラス名を選択します。 PhpStorm は短いクラス名を補完し、選択したクラスが定義されている名前空間の 使用 ステートメントを挿入します。

クイックフィックスを使用してクラスをインポートする

編集用にファイルを開き、PHP クラスを参照します。参照されたクラスが見つからない場合、PhpStorm はそれをハイライトします：
Alt+Enter を押して、クラスの宣言が検出された名前空間をインポートするという提案を受け入れます。
PhpStorm は名前空間宣言ステートメント（使用 ステートメント）を挿入します。

コードクリーンアップを使用して完全修飾クラス名を短くする

PhpStorm は、完全修飾クラス名を短くするための次のインスペクションおよびクイックフィックスを提供します：

完全修飾名の使用インスペクションは、 使用 ステートメントを追加することによって削除できる完全修飾クラス名をハイライトしています。
不要な完全修飾名インスペクションは、 使用 ステートメントを追加せずに削除できる完全修飾クラス名をハイライトしています。

コードのクリーンアップを使用すると、対応するクイックフィックスを特定のスコープに自動的に適用できます。

特定のスコープのコードをクリーンアップする

メインメニューでコード | コードのクリーンアップへ移動します。
開いたコードクリーンアップスコープの指定ダイアログで、インスペクションプロファイルを適用するスコープを選択します。
リストからインスペクションプロファイルを選択するか、構成をクリックして、開いたコードのクリーンアップインスペクションダイアログで新しいプロファイルを構成します。また、構成をクリックして、適用される修正を確認し、不要な完全修飾名および完全修飾名の使用インスペクションが有効になっていることを確認することもできます。
OK をクリックしてコードのクリーンアップを開始します。

現在のファイルのコードをクリーンアップする

エディターで、不要な完全修飾名または完全修飾名の使用インスペクションでハイライトされている完全修飾クラス名にキャレットを置きます。
をクリックするか Alt+Enter を押して、ポップアップメニューからコードのクリーンアップを選択します。

インポートの最適化

インポートの最適化機能は、未使用のインポートを削除し、現在のファイルまたはディレクトリ内のすべてのファイルのインポートステートメントを一度に整理できます。

すべてのインポートを最適化する

プロジェクトツールウィンドウ（表示 | Tool Windows | プロジェクト）でファイルまたはディレクトリを選択します。
以下のいずれかを行ってください：
- メインメニューで、コード | インポートの最適化に移動します (または Ctrl+Alt+O を押します)。
- コンテキストメニューからインポートの最適化を選択します。
（ディレクトリを選択した場合）ディレクトリ内のすべてのファイルでインポートを最適化するか、ローカルで変更されたファイルのみでインポートを最適化するか（プロジェクトがバージョン管理下にある場合）を選択し、実行をクリックします。

インポートを最適化する際、PhpStorm は 使用 ステートメントをアルファベット順または長さ順に自動的に並べ替えることができます。優先オプションを選択するには、設定ダイアログ (Ctrl+Alt+S) でエディター | コードスタイル | PHP に移動し、コード変換タブに切り替えます。次に、 'use' ステートメントを並べ替えるチェックボックスを選択し、 使用 ステートメントの並べ替え方法を選択します。