Install and set up PhpStorm

Installation requirements

Download and install PhpStorm

1. Download PhpStorm for your operating system.
2. Do the following depending on your operating system:
   • Windows installation:
     1. Run the PhpStorm-*.exe file you've downloaded.
     2. Follow the instructions in the installation wizard.
   • macOS installation:
     1. Open the PhpStorm-*.dmg package that you've downloaded, and drag PhpStorm to the Applications folder.
   • Linux installation:
     1. Unpack the PhpStorm-*.tar.gz file you have downloaded to a different folder if your current Downloads folder doesn't support file execution:
        tar xfz PhpStorm-*.tar.gz <new_archive_folder>

        The recommended install location according to the filesystem hierarchy standard (FHS) is /opt. To install PhpStorm into this directory, enter the following command:

        sudo tar xfz PhpStorm-*.tar.gz -C /opt/
     2. Switch to the bin subdirectory:
        cd opt/PhpStorm-*/bin
     3. Run PhpStorm.sh from the bin subdirectory.

Earlier PhpStorm versions are available for download on the Previous PhpStorm Releases page.

Run PhpStorm for the first time

Register PhpStorm

To try and evaluate PhpStorm, you can download and install its trial version for free. The trial version is available for 30 days, whereupon you need to obtain and register a license.

1. Do one of the following:
   • On the Welcome screen, click Configure | Manage License
   • Select Help | Register from the main menu

   

2. Select how you want to register PhpStorm:
   • JetBrains Account: select this option if you have a JetBrains Account that allows you to access your purchases and manage licenses (see What is JetBrains Account? to learn more).
   • Activation code: select this option if you have an activation code for PhpStorm, and paste it to the text area.

   • License server: select this option to register PhpStorm through the License Server web application that allows you to manage floating licenses and issue licenses to users who do not have direct internet access.

     To override the URL of the system proxy during initial PhpStorm startup, use the -Djba.http.proxy property, which can be added as a JVM option.

     When performing silent install or managing PhpStorm installations on multiple machines, you can set the JETBRAINS_LICENSE_SERVER environment variable to point the installation to the license server URL.

Update PhpStorm

Out of the box, standalone PhpStorm installation is configured to check for updates automatically. It will notify you when a new version is available :

PhpStorm updates are usually patch-based: they are applied to the existing installation and only require you to restart the IDE. Note that these patches can only be applied sequentially, on top of one another. If an update is ignored or skipped, subsequent updates cannot be applied. Updating PhpStorm in this case will require either downloading and reinstalling it or using the Ignored updates list to apply updates one by one.

If the patch download takes a long time, you can send it to the background and continue working. Once download is complete, you will be prompted to restart, which should finalize the update.

If you do not want to install the proposed update for some reason, you can ignore it by clicking the Ignore This Update button in the update dialog box. The ignored build's number will be added to the Ignored updates list, and you will not be prompted to install this particular build until you remove it from the list.

Manage PhpStorm through Toolbox App

Toolbox App is a control panel that allows you to manage all JetBrains developer tools, including PhpStorm, as well as your projects, from a single point of access. It lets you maintain different versions of the same tool, install updates and roll them back if needed. It also remembers your JetBrains Account and uses it to automatically log you in when you install and register new tools.

1. Download Toolbox App.
2. Launch the setup file.
3. When the installation is complete, accept the JetBrains privacy policy and sign in to your JetBrains Account.

Now you can manage existing tools, install new tools and download updates:

Perform silent installation on Windows

Silent installation is performed without any user interface. It can be used by network administrators to install PhpStorm on a number of machines and avoid interrupting other users.

To perform silent install, run the installer with the following switches:

• /S: Enable silent install

• /D: Specify the path to the installation directory

• /CONFIG: Specify the path to the silent configuration file

For example:

Install PhpStorm as a snap package on Linux

You can install PhpStorm on Linux as a self-contained snap package. Since snaps update automatically, your PhpStorm installation will always be up-to-date.

PhpStorm is distributed via two channels:

• The stable channel includes only stable versions. To install the latest stable release of PhpStorm, run the following command:

  $ sudo snap install phpstorm --classic

• The edge channel includes EAP builds. To install the latest EAP build of PhpStorm, run the following command:

  $ sudo snap install phpstorm --classic --edge

When the snap is installed, you can launch it by running the phpstorm command.

To list all installed snaps, run sudo snap list. For more information, see the Snapcraft documentation.