PhpStorm 2026.3 Help

Docker 接続設定

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

Docker プラグインを有効化

この機能は Docker(英語) プラグインに依存しており、PhpStorm にはデフォルトでバンドルされ有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

  1. Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。

  2. 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 構成を追加します。

the Remove button削除 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

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

the Remove button除去 Ctrl+Y

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

the Edit buttonEdit Enter

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

仮想マシンのパス

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

ローカルパス

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

PhpStorm は、これらのマッピングを Windows および macOS ホストにのみ適用します。 デフォルトでは、テーブルは Windows で C:\Users を /c/Users に、macOS で /Users を /Users にマッピングします。 サービス ツールウィンドウでコンテナーのバインドマウントを構成すると、ホストパスのファイルチューザーにはこのテーブルのローカルフォルダーのみが表示され、PhpStorm はローカルパスを対応する仮想マシンパスに置き換えます。 テーブルが空の場合、PhpStorm はまず Docker 設定でパスマッピングを構成するよう求めます。

パスマッピングを追加する

既存のマッピングでカバーされないローカルフォルダーからファイルをバインドマウントする必要がある場合は、マッピングを追加します。

  1. Docker 接続オプションの下にあるテーブルで、 追加ボタン (Alt+Insert) をクリックします。

  2. 仮想マシンのパス フィールドで、Docker エンジンを実行する仮想マシンがフォルダーを認識するパスを指定します。

  3. ローカルパス フィールドで、ローカルフォルダーを指定します。

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

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 エンジンを実行する仮想マシンのパスマッピング

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

2026 年 11 月 9 日