Shared indexes
One of the possible ways of reducing the indexing time is by using shared indexes. Unlike the regular indexes that are built locally, shared indexes are generated once and are later reused on another computer whenever they are needed.
PhpStorm can build shared indexes for your project's code. Whenever PhpStorm needs to reindex your application, it will use the available shared indexes and will build local indexes for the rest of the project. Normally, this is faster than building local indexes for the entire application from scratch.
Make sure the plugin is installed
To be able to use shared project indexes, the Shared Project Indexes bundled plugin must be enabled in the settings:
Press Ctrl+Alt+S to open the IDE settings and select .
Switch to the Installed tab, type
Shared Project Indexes, and make sure that the checkbox next to it is selected.Otherwise, select the checkbox to enable the plugin.
Apply the changes and close the dialog. Restart the IDE if prompted.
When you launch a project, PhpStorm processes local and shared indexes together at the same time. This might increase CPU usage on your computer. If you want to avoid this, enable the Wait for shared indexes option in .
Shared project indexes
Shared project indexes are built for project sources and its dependencies. By generating indexes on a single computer and distributing them to other computers, you can avoid duplicating the indexing process on each machine. This way, each computer can benefit from the precomputed indexes without having to perform the expensive indexing operations individually. This is the main advantage of shared indexes over ordinary indexes.
Using shared indexes is reasonable for large projects, where indexing might take a lot of time, creating inconveniences for the teams involved. For smaller projects, we recommend other ways of reducing the indexing time.
Before you begin
To ensure index compatibility, use the same IDE version on the source and the target computer.
You can have different operating systems on the source and the target computer.
However, in previous PhpStorm versions, project shared indexes were OS-specific. Refer to the documentation that corresponds to your IDE version by using the version switcher in the top-left corner of this page.
Before incorporating shared project indexes into your infrastructure, you can evaluate how much time they can save on indexing by running the command-line tool.
If you are satisfied with the results, you can keep using shared indexes from the command line. In more complex scenarios, you can customize sample scripts from the IntelliJ Shared Indexes Tool Example repository.
Evaluate indexing time with shared indexes
Before using shared project indexes in your workflow, you can see how much time they are able to save you. During evaluation, the tool will generate some files that you can keep locally or on a storage.
Download the command-line tool and unzip it.
Execute the binary file via the command line by running:
./bin/ij-shared-indexes-tool-cli boostwith the following options:
--ij: (mandatory) path to a locally installed IDE.--project: (mandatory) path to the project for which you want to build shared indexes.--port: port for running a local server. The default port is 25561.--data-directory: directory for storing generated indexes and server data. You can use a server running locally or any S3-compatible storage. The default directory is ./ij-shared-indexes-tool-data.
Wait for some time. After that, you will see the indexing time with shared indexes and without them.
By looking at the difference in time, you can decide whether you want to use shared project indexes in your workflow or not.
Generate indexes from the command line
Download the command-line tool and unzip it.
Execute the binary file via the command line by running:
./bin/ij-shared-indexes-tool-cli indexeswith the following options:
--ij: (mandatory) path to a locally installed IDE.--project: (mandatory) path to the project for which you want to build shared indexes.--port: port for running a local server. The default port is 25561.--data-directory: directory for storing generated indexes and server data. You can use a server running locally or any S3-compatible storage. The default directory is ./ij-shared-indexes-tool-data.
Once the project indexes have been generated, you will see a message with the information required to configure shared indexes in your project.
Other commands that you can run:
- version
Displays shared indexes version information. Options:
--ij: (mandatory) path to a locally installed IDE.
- server
Starts a server on local indexes. Options:
--port: port for running a local server. The default port is 25561.--server-directory: directory for server data. The default directory is ./ij-shared-indexes-tool-data/server.
You can keep using shared indexes from the command line. In more complex scenarios, you can customize sample scripts from the IntelliJ Shared Indexes Tool Example repository.
Configure access to shared indexes
Once the project indexes are uploaded to the file storage, they can be downloaded and applied on another computer.
In the project directory, create a new file intellij.yaml and copy the information from the terminal to the new file, for example:
In the default configuration, the IDE will be downloading shared indexes automatically. You can choose to confirm every download manually.
Restart your project.
Project indexes will be downloaded to index/shared_indexes in the IDE system directory.
When the indexes are being downloaded, the progress is displayed in the status bar.
When everything is ready, you will see a corresponding notification in the Notifications tool window.
Change the way indexes are downloaded
In the default configuration, the IDE will be downloading shared indexes automatically. You can choose to confirm every download manually.
From the intellij.yaml file, remove the
consentssection and restart your project.In the Settings dialog (Ctrl+Alt+S), select and in the Shared Project Indexes area, select Ask before download.
Apply the changes and close the dialog.