共有インデックス

共有インデックスを使用すると、PhpStorm によるプロジェクト解析にかかる時間を短縮できます。プロジェクトを解析するたびにローカルで作成される通常のインデックスとは異なり、共有インデックスは一度生成され、必要に応じて他のコンピューターで再利用されます。

PhpStorm は、プロジェクトのコードに対して共有インデックスを構築して使用できます。IDE がプロジェクトを再解析する必要があるときはいつでも、利用可能な共有インデックスを使用し、プロジェクトの残りの部分にはローカルインデックスを構築します。通常、これはプロジェクト全体をローカルで最初から解析するよりも高速です。

プラグインがインストールされていることを確認する

共有プロジェクトインデックスを使用できるようにするには、共有プロジェクトインデックス(英語)バンドルプラグインを設定で有効にする必要があります。

Ctrl+Alt+S を押して設定を開き、プラグインを選択します。
インストール済みタブに切り替えて、Shared Project Indexes と入力し、その横にあるチェックボックスが選択されていることを確認します。
それ以外の場合は、チェックボックスを選択してプラグインを有効にします。
変更を適用してダイアログを閉じます。プロンプトが表示されたら IDE を再起動します。

共有プロジェクトインデックス

共有プロジェクトインデックスは、プロジェクトソースとその依存関係に基づいて構築されます。単一のコンピューターでインデックスを生成し、他のコンピューターに配布することで、各マシンでプロジェクト分析プロセスを繰り返す必要がなくなります。これにより、各コンピューターは、高コストなプロジェクト分析操作を個別に実行することなく、事前に計算されたインデックスを活用できます。これが、通常のインデックスと比較した共有インデックスの主な利点です。

始める前に

共有プロジェクトインデックスを構築するコンピューターと、これらの共有インデックスを使用するすべてのコンピューター:

インデックスの互換性を確保するには、同じ IDE バージョンを使用する必要があります。
異なるオペレーティングシステムを使用できます。
ただし、以前の PhpStorm バージョンでは、共有プロジェクトインデックスは OS 固有でした。このページの左上隅にあるバージョンスイッチャーを使用して、IDE バージョンに対応するドキュメントを参照してください。

共有プロジェクトインデックスをインフラストラクチャに組み込む前に、コマンドラインツールを実行して、プロジェクト分析にかかる時間をどれだけ節約できるかを評価できます。

結果に満足したら、共有インデックスを使い続けることができます。より複雑なシナリオでは、IntelliJ 共有インデックスツールの例(英語)リポジトリのサンプルスクリプトをカスタマイズできます。たとえば、JSON 設定ファイルを使用して、共有インデックスの生成時に xz 圧縮を無効にしたり、gzip 圧縮を使用したりできます。

共有インデックスを使用してプロジェクト分析時間を評価する

ワークフローで共有プロジェクトインデックスを使用する前に、どれだけの時間を節約できるかを確認できます。評価中、ツールは指定したディレクトリにいくつかのファイルを生成します。

コマンドラインツール(英語)の最新バージョンをダウンロードし、アーカイブを解凍します。
コマンドラインで、コマンドラインツールのディレクトリに移動し、次のコマンドを実行してバイナリファイルを実行します。
.\bin\ij-shared-indexes-tool-cli.bat boost
./bin/ij-shared-indexes-tool-cli boost
./bin/ij-shared-indexes-tool-cli boost
次のオプションを使用します。
- --ij : ローカルにインストールされた IDE への (必須) パス。
  ローカルにインストールされた IDE へのパスは、インストール方法によって異なる場合があります。
- --project : 共有インデックスを構築するプロジェクトへの (必須) パス。
- --port : ローカルサーバーを実行するためのポート。デフォルトのポートは 25561 です。
- --data-directory : 生成されたインデックスとサーバーデータを保存するディレクトリ。デフォルトのディレクトリは ./ij-shared-indexes-tool-data です。
例:
./bin/ij-shared-indexes-tool-cli boost --ij "/Users/jetbrains/Library/Application Support/JetBrains/Toolbox/apps/PhpStorm/ch-1/232.8660.153/PhpStorm2025.3 EAP.app" --project "/Users/jetbrains/PhpStormProjects/demo-php-project"
しばらくお待ちください。その後、共有インデックスありとなしのプロジェクト分析時間が表示されます。

時間の差を比較することで、ワークフローで共有プロジェクトインデックスを使用するかどうかを決定できます。

プロジェクトインデックスを生成する

インデックスファイルを生成するには、次の手順に従います。インデックスが生成されたら、ファイルをファイルサーバーまたは S3 互換ストレージにアップロードするを実行する必要があります。

コマンドラインツール(英語)の最新バージョンをダウンロードし、アーカイブを解凍します。
コマンドラインで、コマンドラインツールのディレクトリに移動し、次のコマンドを実行してコマンドライン経由でバイナリファイルを実行します。
.\bin\ij-shared-indexes-tool-cli.bat indexes
./bin/ij-shared-indexes-tool-cli indexes
./bin/ij-shared-indexes-tool-cli indexes
次のオプションを使用します。
- --ij : (必須) ローカルにインストールされた IDE へのパス。
- --project : 共有インデックスを構築するプロジェクトへの (必須) パス。
- --base-url : (必須) インデックスサーバーの URL。共有インデックスがホストされる完全な URL を定義するために使用されるベース URL。
- --data-directory : 生成されたインデックスとサーバーデータを保存するディレクトリ。デフォルトのディレクトリは ./ij-shared-indexes-tool-data です。このディレクトリから、base-url パラメーターで指定されたサーバーにファイルをアップロードする必要があります。
例:
./bin/ij-shared-indexes-tool-cli indexes --ij "/Users/jetbrains/Library/Application Support/JetBrains/Toolbox/apps/PhpStorm/ch-1/232.8660.153/PhpStorm2025.3 EAP.app" --project "/Users/jetbrains/PhpStormProjects/demo-php-project"
プロジェクトインデックスが生成されると、プロジェクト内の共有インデックスを構成するために必要な情報を含むメッセージが表示されます。

インデックスを生成すると、indexes コマンドの実行時に指定したディレクトリに、server と temp の 2 つのフォルダーが表示されます。インデックスファイルは、server ディレクトリ内に保存されます。

ファイルをストレージにアップロードする

共有インデックスをリモートストレージにアップロードする

server ディレクトリから data および project フォルダーをファイルサーバーまたは S3 互換ストレージにアップロードします。ストレージの場所のベース URL は、インデックスの生成時に base-url パラメーターを使用して定義された URL と同じである必要があります。

ローカルでテストするときに共有インデックスを公開する

共有インデックスをテストする場合、server コマンドを使用して、生成されたファイルでサーバーを起動できます。

コマンドラインで、コマンドラインツールのディレクトリに移動し、次のコマンドを実行してバイナリファイルを実行します。
.\bin\ij-shared-indexes-tool-cli.bat server
./bin/ij-shared-indexes-tool-cli server
./bin/ij-shared-indexes-tool-cli server
次のオプションを使用します。
- --port : ローカルサーバーを実行するためのポート。
- --server-directory : サーバーデータのディレクトリ。デフォルトのディレクトリは ./ij-shared-indexes-tool-data/server です。
例:
.\bin\ij-shared-indexes-tool-cli.bat server --port 8080 --server-directory "C:\Users\jetbrains\ij-shared-indexes-tool-data\server"
./bin/ij-shared-indexes-tool-cli server --port 8080 --server-directory "/Users/jetbrains/ij-shared-indexes-tool-data/server"
./bin/ij-shared-indexes-tool-cli server --port 8080 --server-directory "/home/jetbrains/ij-shared-indexes-tool-data/server"

共有インデックスへのアクセスを構成する

プロジェクトインデックスをファイルストレージにアップロードすると、別のコンピューターにダウンロードして適用できるようになります。

プロジェクトディレクトリで、新しいファイル intellij.yaml を作成し、ターミナルからの情報を新しいファイルにコピーします。例:
プロジェクトがまだ分析されていない場合、またはシステムキャッシュをクリアしている場合は、IDE は共有インデックスをダウンロードして使用します。
デフォルト設定では、IDE は共有インデックスを自動的にダウンロードします。これを変更して、ダウンロードごとに手動で確認することもできます。