PhpStorm 2024.3 ヘルプ

外部ツール

サードパーティのコマンドラインアプリケーションを外部ツールとして構成して、PhpStorm から実行します。例: ワークフローでは、特定のスクリプト、コードジェネレーター、アナライザー、プリプロセッサーまたはポストプロセッサー、データベースユーティリティなどの実行が必要になる場合があります。外部ツールとして構成することにより、PhpStorm は専用のアクションを提供します。これは、メインメニューや特定のコンテキストメニューから実行したり、ショートカットを割り当てたり、特定の実行構成を起動するときに実行したりできます。

組み込み IDE マクロを使用して、現在のファイルやプロジェクトソースパスなど、コンテキスト依存のコマンドライン引数をツールに渡すことができます。必要に応じて、PhpStorm はツールの出力をコンソールに出力します。

PhpStorm は、次のタイプの外部ツールをサポートしています。

  • ローカルツールは、コンピューター上でローカルに実行されます。

  • リモートツールは SSH を介してリモートサーバー上で実行されます。

ローカル外部ツールを追加する

この例は、OptiPNG(英語) を外部ツールとして追加し、それを使用してプロジェクト内のイメージを最適化する方法を示しています。

  1. Ctrl+Alt+S を押して設定を開き、ツール | 外部ツールを選択します。

  2. the Add button をクリックし、ツールの設定を指定します。

    The Create Tool dialog

    詳細は、外部ツールを参照してください。

    この場合、OptiPNG-o4 $FilePath$ 引数を使用して実行されます。プロジェクト名、現在のファイルパス、PHP 実行可能ファイルへのパスなどを参照できるマクロを使用できます。the Insert Macros icon をクリックすると、使用可能なすべてのマクロとその値をリストするマクロダイアログが開きます。

  3. OK をクリックしてツールを追加してから変更を適用します。

追加されたローカル外部ツールを実行する

新しく追加されたツールイメージで選択したファイルを開くには、次のいずれかを実行します。

  • ツール | イメージ | PNG の最適化に移動します。

  • プロジェクトツールウィンドウでファイルを右クリックして、コンテキストメニューからツール | イメージ | PNG の最適化を選択します。

    Run External tool
  • ツールを実行するためのショートカットを作成します。

    Ctrl+Alt+S を押して設定を開き、キーマップを選択します。外部ツールノードにある PNG の最適化アクションを見つけて、ショートカットを割り当てます。

    Create a shortcut for an external tool

ツールを実行すると、出力が実行ツールウィンドウに表示されます。

リモート外部ツールを追加する

リモート SSH 外部ツールはローカル外部ツールと同様に構成されますが、実行されるリモートサーバーも定義し、SSH 経由で接続するための資格情報を必要とします。組み込み SSH ターミナルの使用方法の詳細については、「SSH ターミナルを実行する」を参照してください。

この例では、SSH を介してリモートサーバーで実行され、現在の日付と時刻を返すリモート SSH 外部ツールとして date を追加する方法を示します。

  1. Ctrl+Alt+S を押して設定を開き、ツール | リモート SSH 外部ツールを選択します。

  2. the Add button をクリックしてツールの作成ダイアログを開きます。

    The Create Tool dialog

    このダイアログでは、ローカル外部ツールを追加するときと同じ設定セットが提供されますが、リモート接続を選択することもできます。接続設定を指定しない場合、PhpStorm はサーバー上でツールを実行するたびに、ホスト、ポート、関連する SSH 資格情報を要求します。詳細については、リモート SSH 外部ツールを参照してください。

  3. OK をクリックしてツールを追加してから変更を適用します。

追加されたツールをリモートサーバーで実行する

以下のいずれか 1 つを実行します:

  • メインメニューで、ツール | リモートツールと追加されたリモート外部ツールの名前に移動します。

  • ツールを実行するためのショートカットを作成します。

    Ctrl+Alt+S を押して設定を開き、キーマップを選択します。設定したリモート外部ツールの名前のアクションを見つけて、ショートカットを割り当てます。

ホスト、ポート、資格情報を指定した後、PhpStorm は SSH 経由でサーバーに接続して date コマンドを実行し、PhpStorm の実行ツールウィンドウに出力を返します。

ウェブブラウザー

Web ブラウザーを使用して、プロジェクトから任意のファイルを開くことができます。デフォルトでは、HTML ファイルの出力をプレビューしたり、Web アプリケーションを実行およびデバッグしたりするために使用されます。

Web ブラウザーでファイルを開く

PHP プログラムの出力を Web ブラウザーでレンダリングするには、次のいずれかを実行します。

  • ファイルをエディターで開き、Alt+F2 を押します。

  • プロジェクトツールウィンドウ内のファイルを右クリックし、ブラウザーで開くを選択します。

  • メインメニューで、表示 | ブラウザーで開くに移動します。

  • エディターウィンドウの右上部分にあるブラウザーポップアップ (マウスを置くと表示されます) を使用します。ブラウザーボタンをクリックして Web サーバーファイル URL を開くか、Shift+Click をクリックしてローカルファイル URL を開きます。

    Show in browser

ブラウザーのリストを表示および構成する

  • 設定ダイアログ(Ctrl+Alt+S)で、ツール | ウェブブラウザーとプレビューを選択します。

The Web Browsers page in Settings

標準の手順を使用してブラウザーをインストールした場合は、パスフィールドのエイリアスが正しい場所を指しているはずです。そうでない場合は、対応する実行可能ファイルへのパスを指定します。

カスタムプロファイルと設定を使用する

Firefox および Chrome ファミリブラウザー用のカスタムプロファイルを設定できます。

  1. 設定ダイアログ(Ctrl+Alt+S)で、ツール | ウェブブラウザーとプレビューを選択します。

  2. リストからブラウザーを選択して the Edit button をクリックします。

    • Firefox の場合は、profiles.ini ファイルへのパスを指定し、使用するプロファイルを選択します。詳細については、Firefox のブラウザープロファイル(英語)を参照してください。

    • Chrome の場合は、カスタムユーザーデータディレクトリを使用するを選択し、ユーザーデータディレクトリ(英語)の場所を指定します。

      PhpStorm から Chrome を実行するときに使用する追加のコマンドラインオプションを指定することもできます。詳細については、Chrome アドレスバーの chrome://flags を開いてください。

関連ページ:

組み込みの IDE マクロ

PhpStorm は、外部ツールや実行構成のさまざまなパス、オプション、その他のコマンドライン引数を指定するために使用できる変数である、多数の組み込みマクロを提供します。値としてマクロを受け入れるダイアログフィールドには、プラスアイコンが表示されます。マクロの値は現在のコンテキストによって異なります。例: 現在のファイルを含むディレクトリの名前を渡す必要がある場合は、完全なパスが必要な場合はを使用します。現在のプロジェクトが属するワークスペースへのパス。ワークスペースは、開いているファイル階層の...

外部ツール

このページでは、ローカル外部ツールに対して構成できる設定について説明します。外部ツールの追加と使用の詳細については、「外部ツール」を参照してください。ツールバーボタンを使用して、使用可能な外部ツールのリストを管理します。保持したいがメニューで使用できないツールとグループのチェックボックスをオフにします。追加新しい外部ツールを追加します。除去選択したツールまたはグループを削除します。編集選択したツールを編集します。上へ選択したツールをリスト内で上に移動します。

リモート SSH 外部ツール

このページでは、リモート外部ツールで行うことができる設定について説明します。外部ツールの追加と使用の詳細については、「外部ツール」を参照してください。ツールバーボタンを使用して、使用可能な外部ツールのリストを管理します。保持したいがメニューで使用できないツールとグループのチェックボックスをオフにします。追加新しい外部ツールを追加します。除去選択したツールまたはグループを削除します。編集選択したツールを編集します。上へ選択したツールをリスト内で上に移動します。

プロジェクトツールウィンドウ

プロジェクトツールウィンドウを使用すると、さまざまな視点からプロジェクトを確認し、新しい項目 (ディレクトリ、ファイル、クラスなど) の作成、エディターでのファイルのオープン、必要なコードフラグメントへの移動などのさまざまなタスクを実行できます。このビューには、作成されたスクラッチファイル、クエリコンソール、拡張スクリプトを管理できるスクラッチとコンソールフォルダーも含まれています。ビュー:ツールウィンドウにはいくつかのビューがあります。プロジェクトビュー。このビューには、すべてのプロジェク...

スコープとファイルの色

スコープは、プロジェクト内のファイルとフォルダーのグループです。スコープを使用して、さまざまな IDE ビューでプロジェクト項目を視覚的に区別し、特定の操作の範囲を制限できます。スコープは、プロジェクト内のファイルを論理的に編成するように設計されています。テストソースはテスト関連のスコープに移動でき、製品コードは製品ファイルのスコープに関連付けることができます。これらの論理チャンクにより、プロジェクトの管理が容易になります。例: テスト関連のインスペクションをテストクラスでのみ実行すると、アプリ...

ブラウザー

PhpStorm には、HTML ファイルの出力の実行、デバッグ、プレビュー中に IDE から自動的にインストールおよび起動できる最も一般的なブラウザーの事前定義リストが付属しています。PhpStorm は、標準の手順に従ってブラウザーをインストールすることを前提としており、各インストールに、ブラウザーの実行可能ファイルまたは macOS アプリケーションへのデフォルトパスを表すエイリアスを割り当てます。デフォルトリストのブラウザーに加えて、カスタムブラウザーのインストールを設定できます。Php...