Docker 接続設定
PhpStorm から Docker エンジン API にアクセスするための設定を指定します。 Docker と PhpStorm の統合の使用方法の詳細については、 Docker を参照してください。
Docker プラグインを有効化
この機能は Docker(英語) プラグインに依存しており、PhpStorm にはデフォルトでバンドルされ有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。
Ctrl+Alt+S を押して設定を開き、 を選択します。
Docker プラグインを見つけて、 許可 をクリックします。
PhpStorm が Docker デーモンと対話するために使用する Docker CLI(英語) 実行可能ファイルへのパスを指定できます。
PhpStorm は、デフォルトのインストール場所にある Docker CLI 実行可能ファイルを自動的に検出できるはずです。 ただし、Docker をカスタムの場所にインストールした場合は、パスを手動で指定する必要がある場合があります。 Docker CLI がインストールされていない場合は、 PhpStorm から直接ダウンロードできます。
- 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(英語) に接続することもできます。 詳細については、 個別のファイルを適用するを参照してください。
- SSH
既存の SSH 構成を介してリモート Docker デーモンに接続するか、新しい構成を作成します。
- WSL
Windows Subsystem for Linux (WSL) で実行されている Docker デーモンに接続します。
- Minikube
minikube(英語) を実行している場合は、このオプションを選択して、minikube の Docker エンジン環境を自動的に検出して接続します。
PhpStorm が minikube を検出できない場合、またはリモートで実行されている場合は、
minikube docker-envコマンドを実行して必要な接続情報を取得し、 TCP ソケットに次のように設定します。エンジン API URL:
DOCKER_HOSTの値 (tcpの代わりにプロトコルとしてhttpsを使用)証明書フォルダー:
DOCKER_CERT_PATHの値
IDE から Docker CLI をダウンロード
PhpStorm では、リモート Docker エンジンに接続する場合も含め、イメージをビルドして Docker Compose を実行するためにローカル Docker CLI が必要です。
PhpStorm がマシン上で Docker CLI を見つけられない場合、IDE はダウンロードするオプション付きの Docker CLI がインストールされていません 通知を表示します。 同じ警告が Docker 設定ページの上部に表示されます。
PhpStorm は、Docker が提供する次のツールをダウンロードします:
Docker CLI 29.6.2 版
Docker Buildx 0.35.0 版
Docker Compose 5.3.1 版
ダウンロードしたツールには Docker エンジンが含まれていません。 コンテナーを実行するには、リモート Docker エンジンに接続するか、マシンに Docker エンジンをインストールしてください。
ダウンロードしたツールは docker-cli ディレクトリに保存されます:
macOS | ~/Library/Application Support/JetBrains/docker-cli |
|---|---|
Windows | %APPDATA%\JetBrains\docker-cli |
Linux | ~/.local/share/JetBrains/docker-cli |
Windows および macOS ホストの仮想マシンパスマッピング
Docker エンジンは Linux 上でネイティブに実行されます。 Windows および macOS では、Docker は軽量の Linux 仮想マシン内で実行されるため、コンテナーはその VM 内に存在するファイルにのみアクセスできます。
Docker 接続構成オプションの表では、ローカルファイルシステムと Docker エンジンを実行している仮想マシン間のマッピングを構成して、コンテナー内のボリュームマウントに使用できるようにすることができます。
追加 Alt+Insert
新しいマッピングを追加します。
除去 Ctrl+Y
選択したマッピングを削除します。
Edit Enter
選択したマッピングを編集します。
- 仮想マシンのパス
この Docker エンジンを実行するために使用される仮想マシン内のディレクトリへのパスです。
- ローカルパス
仮想マシン内の対応するディレクトリにマッピングするローカルフォルダーへのパスです。 このフォルダーの外部にあるものを、この Docker エンジンが実行するコンテナーにバインドマウントすることはできません。
PhpStorm は、これらのマッピングを Windows および macOS ホストにのみ適用します。 デフォルトでは、テーブルは Windows で C:\Users を /c/Users に、macOS で /Users を /Users にマッピングします。 サービス ツールウィンドウでコンテナーのバインドマウントを構成すると、ホストパスのファイルチューザーにはこのテーブルのローカルフォルダーのみが表示され、PhpStorm はローカルパスを対応する仮想マシンパスに置き換えます。 テーブルが空の場合、PhpStorm はまず Docker 設定でパスマッピングを構成するよう求めます。
パスマッピングを追加する
既存のマッピングでカバーされないローカルフォルダーからファイルをバインドマウントする必要がある場合は、マッピングを追加します。
Docker 接続オプションの下にあるテーブルで、
(Alt+Insert) をクリックします。
仮想マシンのパス フィールドで、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 でデータを管理する(英語) 」を参照してください。