自動インポート

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

インポートの最適化

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

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

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

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