自動インポート

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

1. Ctrl+Alt+S を押して設定を開き、エディター | 一般 | 自動インポートを選択します。

2. 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;

1. 実行中のネームスペースのインポートを有効にします。

2. 編集するファイルを開き、クラスの短い名前を入力し始めます。

3. コード補完候補リストから、希望のクラス名を選択します。PhpStorm は短いクラス名を補完させ、選択されたクラスが定義されている名前空間を持つ use ステートメントを挿入します。

   

1. 編集用にファイルを開き、PHP クラスを参照します。参照されたクラスが見つからない場合、PhpStorm はそれをハイライトします。

   

2. Alt+Enter を押して、クラスの宣言が検出された名前空間をインポートするという提案を受け入れます。

   PhpStorm は名前空間宣言ステートメント（use ステートメント）を挿入します。

   

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

1. メインメニューで、コード | コードのクリーンアップに移動します。

2. 開いたコードクリーンアップスコープの指定ダイアログで、インスペクションプロファイルを適用するスコープを選択します。

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

   

4. OK をクリックしてコードのクリーンアップを開始します。

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

1. エディターで、不要な完全修飾名または完全修飾名の使用インスペクションでハイライトされている完全修飾クラス名にキャレットを置きます。

2. をクリックするか Alt+Enter を押して、ポップアップメニューからコードのクリーンアップを選択します。

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

1. プロジェクトツールウィンドウ（表示 | ツールウィンドウ | プロジェクト）でファイルまたはディレクトリを選択します。

2. 以下のいずれかを行います。

   • メインメニューで、コード | インポートの最適化に移動します (または Ctrl+Alt+O を押します)。

   • コンテキストメニューからインポートの最適化を選択します。

3. （ディレクトリを選択した場合）ディレクトリ内のすべてのファイルでインポートを最適化するか、ローカルで変更されたファイルのみでインポートを最適化するか（プロジェクトがバージョン管理下にある場合）を選択し、実行をクリックします。

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

1 つのファイルでインポートを最適化する

1. キャレットをインポートステートメントに置き、Alt+Enter を押すか、 アイコンを使用します。

2. use ステートメントを削除を選択します。

コミット時にインポートを最適化する

プロジェクトがバージョン管理されている場合は、変更されたファイルを VCS にコミットする前に、PhpStorm を構成して、変更されたファイルのインポートを最適化できます。

1. Alt+0 を押してコミットツールウィンドウを開き、コミットオプションを表示 をクリックします。

2. をクリックし、コミットメッセージ領域でインポートの最適化チェックボックスを選択します。

   

保存時にインポートを自動的に最適化する

変更が保存されたときに、変更されたファイルへのインポートを自動的に最適化するように IDE を構成できます。

1. Ctrl+Alt+S を押して設定を開き、ツール | 保存時のアクションを選択します。

2. インポートの最適化オプションを有効にします。

   さらに、すべてのファイルタイプリストから、インポートを最適化するファイルのタイプを選択します。

3. 変更を適用し、ダイアログを閉じます。

ファイルの再フォーマット時にインポートを最適化する

再フォーマットされるたびに、ファイル内のインポートを最適化するように PhpStorm に指示できます。

• エディターでファイルを開き、Ctrl+Alt+Shift+L を押して、開いたファイルの整形ダイアログでインポートの最適化チェックボックスが選択されていることを確認します。

  

その後、このプロジェクトで Ctrl+Alt+L を押すたびに、PhpStorm はインポートを自動的に最適化します。

フォルダー内のすべてのファイルのインポートを最適化する

1. プロジェクトツールウィンドウでフォルダーを右クリックし、インポートの最適化を選択します。

2. インポートの最適化ダイアログで、実行をクリックします。