Docker 接続設定

PhpStorm から Docker エンジン API へのアクセス設定を指定します。 Docker と PhpStorm の統合の詳細については、 Docker を参照してください。

PhpStorm が Docker デーモンと対話するために使用する Docker CLI 実行可能ファイルのパスを指定できます。

PhpStorm は、デフォルトのインストール場所にある Docker CLI 実行可能ファイルを自動検出できるはずです。 ただし、Docker をカスタムの場所にインストールした場合は、パスを手動で指定する必要がある場合があります。

Docker 実行可能ファイル

ベース Docker CLI 実行可能ファイルへのパスを指定します。 デフォルトの場所:

macOS および Linux	/usr/local/bin/docker
Windows	C:\Program Files\Docker\Docker\resources\bin\docker.exe

Docker Compose 実行可能ファイル

Docker Compose スタンドアロン実行可能ファイルへのパスを指定します。 デフォルトでは、Compose V2 は Docker CLI プラットフォームに統合され、 docker compose コマンドを介して Docker Compose に同じ実行可能ファイルを使用します。

Compose V1 を使用している場合、メインの Docker 実行可能ファイルは Docker Compose では機能しません。 この場合、 docker-compose へのパスを指定する必要があります。 詳細については、「docker-compose 対 docker compose(英語) 」を参照してください。

それぞれが別々の Docker デーモンへの接続を表す複数の Docker 構成を追加できます：

Docker

新しい Docker 構成を追加します。

削除 Alt+Delete

選択した Docker 構成を削除します。

Docker 構成ごとに、名前を指定し、オペレーティングシステムに応じて接続タイプを選択します：

Windows 用 Docker

Windows で Docker Desktop を使用する場合は、このオプションが推奨されます。

Mac 用 Docker

macOS で Docker Desktop を使用する場合は、このオプションがおすすめです。

Unix ソケット

Linux で Docker Desktop を使用する場合は、このオプションが推奨されます。

TCP ソケット

Docker エンジン API(英語) への URL を手動で構成します。

エンジン API URL フィールドでは、リモート Docker デーモンまたは任意の Docker ソケットパス (カスタムローカルソケットを含む) への TCP 接続を指定できます。 例: ルートレスモード(英語)では、Docker デーモンは一意の識別子を持つ systemd ユーザーサービスを介して実行されるため、ソケットパスは unix:///run/user/1000/docker.sock のようなものになります。

デフォルトでは、macOS および Linux では、Docker デーモンは unix:///var/run/docker.sock の Unix ソケットで Docker エンジン API 要求をリッスンします。

Windows で Docker デスクトップ(英語)を使用している場合は、 npipe:////./pipe/docker_engine の名前付きパイプまたは tcp://localhost:2375 の TCP ソケットを介して Docker エンジンに接続できます。

Docker エンジン API と同等の API を備えた Podman(英語) に接続することもできます。 詳細については、 Podman を参照してください。

SSH

既存の SSH 構成 を使ってリモート Docker デーモンへ接続するか、新規作成します。

WSL​

Linux 用 Windows Subsystem（WSL）で実行中の Docker デーモンに接続します。

Minikube（ミニキューブ）

minikube(英語) を実行している場合は、このオプションを選択して、minikube の Docker エンジン環境を自動的に検出して接続します。

PhpStorm が minikube を検出できない場合、またはリモートで実行されている場合は、 minikube docker-env コマンドを実行して必要な接続情報を取得し、 TCP ソケットに次のように設定します：

• エンジン API URL: DOCKER_HOST の値 (tcp の代わりにプロトコルとして https を使用)

• 証明書フォルダー: DOCKER_CERT_PATH の値

Windows および macOS ホストの仮想マシンパスマッピング

Docker エンジンは Linux 上でネイティブに実行されます。 Windows および macOS では、Docker は軽量の Linux 仮想マシン内で実行されるため、コンテナーはその VM 内に存在するファイルにのみアクセスできます。

Docker 接続構成オプションの表では、ローカルファイルシステムと Docker エンジンを実行している仮想マシン間のマッピングを構成して、コンテナー内のボリュームマウントに使用できるようにすることができます。

追加 Alt+Insert

新しいマッピングを追加します。

削除 Ctrl+Y

選択したマッピングを削除します。

編集 Enter

選択したマッピングを編集します。

仮想マシンのパス

この Docker エンジンを実行するために使用される仮想マシン内ディレクトリのパスです。

ローカルパス

仮想マシン内の対応するディレクトリにマッピングしたいローカルフォルダーのパスです。 このフォルダー外のものは、この Docker エンジンが実行するコンテナにはバインドマウントできません。

例: Docker コンテナーにバインドマウントしたすべてのファイルを /Users/jsmith/docker-share に保持するとします。 Docker エンジン接続用に、このディレクトリを仮想マシン上の /dockerShare にマップできます。 この Docker エンジンは、 /Users/jsmith/docker-share からマップしたファイルにアクセスできるため、 /dockerShare からコンテナーにファイルを効果的にバインドマウントします。

コンテナを実行するユーザーとしては、ホストマシン上のパスとコンテナ内のパス間のマッピングとしてバインドマウントやボリュームの設定を引き続き行うため、影響はありません。 ただし、マッピングした仮想マシンのディレクトリ以外はマウントできません。

コンテナーを実行し、ホスト上のアプリケーションアーティファクト /Users/jsmith/docker-share/out を含むディレクトリをコンテナー内の /usr/local/tomcat/webapps にマウントするとします。 この場合、Docker エンジンは仮想マシンマッピングを通じてファイルにアクセスできる場所であるため、実際には /dockerShare/out をマウントします。

ボリュームとバインドマウントの詳細については、「Docker でデータを管理する(英語) 」を参照してください。