PhpStorm 2025.3 ヘルプ

PhpStorm の高度な Vagrant 機能の使用

このチュートリアルでは、PhpStorm での Vagrant 統合の高度な機能の使用方法について説明します。Vagrant(英語) および Oracle VirtualBox(英語) の使用方法の詳細は、このチュートリアルの範囲外です。詳細については、それぞれのドキュメントを参照してください。

Vagrant ページに記載されている前提条件に注意してください。また、Vagrant ボックスが作成され、初期化されていることを確認してください。

組み込みの SSH ターミナルを使用して Vagrant マシンに接続する

PhpStorm は、リモートマシンに接続するために使用できる組み込みの SSH ターミナルを備えています。

接続の開始

Vagrant マシンに接続するには、メインメニューのツール | SSH セッションの開始に移動します。これにより、接続できるホストのリストが開きます。

構成された Vagrant マシンは、このリストに自動的に追加されます。それをクリックすると、この Vagrant マシンによって公開されている SSH エンドポイントへの接続が開きます。資格情報の編集 ... メニュー項目では、接続情報を手動で入力できます。ただし、ここでは仮想ボックスの使用に限定します。

SSH の使用

Vagrant を選択した後、PhpStorm は SSH サーバーを使用して Vagrant マシンに接続し、使用するターミナルを表示します。

Vargant int he terminal

SSH ターミナルでは、次のことができます。

  • 上矢印キーと下矢印キーを使用してコマンドの履歴をスクロールします

  • クリップボードの操作を実行する

共有フォルダーの操作

Vagrant では、ホストマシンと Vagrant マシンの間でフォルダーを共有できます。たとえば、これらのフォルダーを使用して、現在の PhpStorm プロジェクトの Web ルートの内容を Vagrant マシンの Apache 仮想ホストディレクトリに自動的にマップすることができます。

パスマッピングの追加

編集用に Vagrantfile を開き(F4、パスマッピングの設定項目を追加:

Vagrant.configure("2") do |config| config.vm.synced_folder "src/", "/srv/website" end

Vagrant の再ロード

メインメニューからツール | Vagrant | 再ロードを選択して、Vagrantfile を再ロードします。

Reload vagrant

コマンド実行の結果は、実行ツールウィンドウに表示されます。

Vagrant reloading results

Vagrant マシンが再ロードされると、新しいパスマッピングが使用可能になります。例: 組み込みの SSH ターミナルを使用して Vagrant マシンに接続すると、PhpStorm のローカルプロジェクトフォルダーにマップされている /vagrant フォルダーの内容が表示されます。注意: このフォルダーからファイルを削除すると、両端のファイルが削除されます。

Vagrant インスタンスフォルダーの指定

デフォルトでは、Vagrantfile および他のすべての Vagrant 仕様 (Puppet マニフェストなど) は、PhpStorm プロジェクトのルートに配置されます。これは常に望ましいとは限らないため、PhpStorm が Vagrantfile を検索するインスタンスフォルダーは、設定の Vagrant ページで構成できます。

Specifying the Vagrant instance folder

設定による Vagrant プラグインの管理

設定の Vagrant ページでは、Vagrant プラグインも管理できます。タブプラグインで、ツールバーボタンを使用して、プラグインをインストール、アンインストール、更新します。

Adding a Vagrant plugin

VMWare 上で Vagrant マシンを実行できる VMWare Fusion Provider(英語) などのライセンスをインストールすることもできます。

プロバイダのサポート

Vagrant は、デフォルトで仮想化プラットフォームとして Oracle VirtualBox(英語) と連携して動作します。ただし、プロバイダーを使用して仮想化プラットフォームを変更できるため、VirtualBox 以外のシステム (たとえば、VMWare(英語) または Amazon EC2(英語)) で仮想マシンを実行できます。利用可能な Vagrant プラグインのリスト(英語)で利用可能なプロバイダーを見つけます。

コマンドごとに、使用するプロバイダーを Vagrant に渡す必要があります。このプロセスを簡素化し、PhpStorm がプロバイダー名をすべての Vagrant コマンドに自動的に追加するようにするには、設定の Vagrant ページでプロバイダーを指定します。マシンにインストールされているすべてのプロバイダーは、設定から利用できます。選択すると、プロバイダーは PhpStorm ですべての Vagrant コマンドを実行するために使用されます。

Redefining the vagrant provider

Vagrant マシンの(再)プロビジョニング

Vagrantfile には一連のプロビジョナが含まれていても、仮想マシンの実行後にインストールおよび設定ルーチンを起動できます。

ツール | Vagrant | プロビジョンのメインメニューコマンドは、仮想マシンを最初に破棄することなく、すでに稼働している Vagrant マシン上で構成されたプロビジョナを起動します。

詳細については、プロビジョニング(英語)のドキュメントを参照してください。

環境変数の操作

Vagrantfile の環境変数は、Puppet ノード、Puppet 環境、カスタムファクト、AWS キーに使用できます。

設定ダイアログの Vagrant ページで、Vagrantfile に渡すプロジェクト固有の環境変数を指定します。

Adding an environment variable

設定されると、これらの環境変数は、#{ENV['name_of_variable']} という構文を使用して、Vagrantfile で参照されます。

Newly added environmental variable in the Vagrantfile
2024 年 10 月 09 日