PhpStorm 2017.1 Help

Tuning PhpStorm

In this part:

Changing PhpStorm properties

You can make PhpStorm work faster by editing the default Java Virtual Machine (JVM) settings. These operations require certain understanding of the JVM functionality and may cause unexpected problems. Therefore it is strongly recommended that you address the JetBrains Support whereupon you will be provided with detailed instructions regarding which settings you need to update and what values should be assigned to them.

See also Reporting Issues and Sharing Your Feedback.

PhpStorm makes it possible to change *.vmoptions and files without editing them in the PhpStorm installation folder.

To create an empty file or to copy *.vmoptions file, choose the Help | Edit Custom Properties or Help | Edit Custom VM Options on the main menu respectively. Refer to the menu items description for details.

Managing *.vmoptions file

The location of the *.vmoptions file depends on the operating system you are currently using:

  • For Windows: <PhpStorm installation folder>/bin/phpstorm.exe.vmoptions or <PhpStorm installation folder>/bin/phpstorm64.exe.vmoptions
  • For *NIX: <PhpStorm installation folder>/bin/phpstorm.vmoptions or <PhpStorm installation folder>/bin/phpstorm64.vmoptions
  • For macOS, you need to make a copy of the phpstorm.vmoptions file in the IDE preferences folder and then edit this copy. The reason is that the app bundle is signed and you should not modify any files inside the bundle.
    • Since version 2016.1, the /Applications/ file must be copied to ~/Library/Preferences/PhpStorm/phpstorm.vmoptions.
    • For earlier versions, the /Applications/PhpStorm<version>.app/Contents/bin/idea.vmoptions file must be copied to ~/Library/Preferences/PhpStorm<version>/idea.vmoptions.

To avoid editing files in the PhpStorm installation folder, do one of the following:

  • From the main menu, choose Help | Edit Custom VM Options to create a copy of the phpstorm.vmoptions file in the user home directory. Refer to Edit Custom VM Options for details.
  • Copy the existing file from the PhpStorm installation folder somewhere and save the path to this location in the WEBIDE_VM_OPTIONS environment variable .
  • Copy the existing <PhpStorm installation folder>/bin/phpstorm.exe.vmoptions or the <PhpStorm installation folder>/bin/phpstorm64.exe.vmoptions file from the PhpStorm installation folder into your user home directory.

Then edit this file in the new location.

If the WEBIDE_VM_OPTIONS environment variable is defined, or the *.vmoptions file exists, this file is used instead of the one located in the PhpStorm installation folder.

Example: Increasing the heap size

To increase PhpStorm heap size, you should copy the original phpstorm.vmoptions file to the above-mentioned location, and then modify the -Xmx setting.

Managing file

The file located in the bin directory of the PhpStorm installation folder should not be edited. Instead of editing the original file, create an file in the following location, open it for editing and add the required properties:

  • For Windows: %USERPROFILE%\.PhpStormXX
  • For *NIX: ~/.PhpStormXX
  • For macOS: ~/Library/Preferences/PhpStormXX

Example: Changing case of unicode literals

PhpStorm allows defining whether non-ascii characters should use literals like '\u00AB' or '\00ab'.

This behavior is controlled by the system property idea.native2ascii.lowercase. By default, upper case characters are used.

If it is desirable to use lower case characters, create the file in the location specified above, open it for editing and add the following line:


Specifying custom JDK, properties or vmoptions files across platforms

A custom JDK, *.properties and *.vmoptions files are specified across platforms in a unified way.

All the launchers look at the following environment variables:


See Also

Last modified: 19 July 2017