WSL

WSL を設定する

1. Windows マシンで Microsoft ストアから WSL ディストリビューション（例: Ubuntu）をダウンロードしてインストールします。

   この手順では、最新の「Fall Creators Update」(最小バージョン 1709、ビルド 16299.15) を適用した少なくとも Windows 10 以降を使用してください。 手順については、公式ガイド Linux 用の Windows サブシステムをインストールするを参照してください。

   WSL 2 を使用するには、Windows のバージョンが 10 ビルド 18917 以降である必要があります。 これらの手順(英語)に従って、ディストリビューションを切り替えます。

   PhpStorm は、システムを Windows 10 のビルド 16299.15 以降にアップグレードする前にインストールした可能性がある 既存の WSL をサポートしていないことに注意してください。 この場合、WSL ディストリビューションを更新する必要があります。

2. Linux ディストリビューションを実行します。

   最初の起動時に、システムは Windows のオプション機能を有効にするように求めるメッセージを表示する場合があります。 この場合、次のことを行う必要があります。

   • 管理者として Windows PowerShell を開き、実行します

     Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

   • コンピューターを再起動してください。

3. Linux インストール内で、PHP がインストールされていることを確認してください。 インストール手順の詳細については、 Debian GNU/Linux インストールノート(英語)を参照してください。 Ubuntu を使用している場合は、ターミナルで次のコマンドを実行して、PHP をすばやくインストールできます。

   sudo apt install php php-mbstring php-xml php-zip php-curl php-xdebug

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

1. 通常どおり、Windows 上でローカルに IntelliJ IDEA を インストールして実行します。

2. Ctrl+Alt+S を押して設定を開き、 PHP を選択します。

3. 表示される PHP ページで、 CLI インタープリター リストの横にある をクリックします。

4. 表示される CLI インタープリターダイアログで、左側のペインの をクリックして、ポップアップメニューから Docker、Vagrant、VM、WSL、リモートなど を選択します。

5. 開いた リモート PHP インタープリターの構成 ダイアログで、 WSL メソッドを選択し、接続パラメーターを指定します。

   

   Field	説明
   Linux ディストリビューション	ドロップダウンリストから、使用するインストールされている Linux ディストリビューションの 1 つを選択します。
   PHP インタープリターのパス	選択したリモート開発環境の構成に従って、 PHP 実行ファイルの場所を指定してください。 WSL の場合、PhpStorm はデフォルトで /usr/local/bin/php を提案します。 別のフォルダーを指定するには、 をクリックし、表示されるダイアログで関連するフォルダーを選択します。 PHP のホームディレクトリは、編集のために開いている必要があることに注意してください。

6. OK をクリックします。 PhpStorm は、PHP 実行ファイルが PHP インタープリターパス フィールドで指定されたフォルダーに実際に保存されているかどうかを確認します。

   • PHP 実行ファイルが見つからない場合、PhpStorm は、インタープリターの構成を検索し続けるかどうかを確認するエラーメッセージを表示します。

   • PHP 実行ファイルが見つかった場合は、 CLI インタープリター ダイアログに戻り、インストールフォルダーと検出されたバージョンの PHP インタープリターが表示されます。

   • このプロジェクトでのみ表示する チェックボックスを選択すると、インタープリターの使用が現在のプロジェクトのみに制限されます。

   • 「PHP 実行可能ファイル 」フィールドの横にある「 」をクリックすると、別の情報ウィンドウが開き、インストールの詳細、ロードされた拡張機能と構成されたオプションのリストが表示されます。

WSL ベースの PHP インタープリターを構成済み PHP インタープリターの一覧から選択し、 スクリプトや Composer コマンドの実行、 PHP 品質ツールの実行など、すべての一般的なタスクで利用できます。

WSL ファイルシステムに新しいプロジェクトを作成

1. 通常どおり、Windows 上でローカルに IntelliJ IDEA を インストールして実行します。

2. 'ようこそ' 画面で、 新規プロジェクト をクリックします。

3. 表示されたページで、作成するプロジェクトの種類を選択します。

4. 右ペインで、 ロケーション フィールドにプロジェクトのパスを指定します。 WSL のプロジェクト場所には、WSL ファイルシステムへの絶対パス（ \\wsl$ で始まる）が表示されます。

   

5. 作成 をクリックします。

   IntelliJ IDEA は WSL にプロジェクトを作成し、IDE を移動せずに WSL 環境内でプロジェクトを開発およびビルドできます。

WSL ファイルシステムに保存されているプロジェクトを開く

IntelliJ IDEA では、WSL ファイルシステムに保存されているプロジェクトを直接開いて、他のプロジェクトと同じように操作できます。

1. 'ようこそ' 画面 の 開く をクリックするか、メインメニューから ファイル | オープン を選択します。

2. 開いた パスの選択ダイアログで、開くプロジェクトが含まれている WSL ファイルシステム内のフォルダーを選択するか、プロジェクトの場所へのパスを手動で入力します。

   パス構文は \\wsl.localhost\DistributionName です。ここで、 DistributionName はLinuxディストリビューションの名前（例：Ubuntu、Debian、Archなど）です。

   

プロジェクトの場所を構成する

作成または開くすべてのプロジェクトで、適切な WSL の場所が使用されるようにできます。

1. Ctrl+Alt+S を押して設定を開き、 外観 & 振る舞い | システム設定 を選択します。

2. Project セクションの デフォルトのプロジェクトディレクトリ フィールドで、適切な WSL ディレクトリを指定し、 OK をクリックして変更を保存します。

   

   今後、プロジェクトを 作成、 開く 、または クローンするたびに、指定したディレクトリがデフォルトで選択されます。