Install and set up PhpStorm
- 1 GB RAM minimum, 2 GB RAM recommended
- 1.5 GB hard disk space + at least 1 GB for caches
- 1024x768 minimum screen resolution
JRE 1.8 is bundled with the PhpStorm distribution. You do not need to install Java on your computer to run PhpStorm.
| Microsoft Windows 10/8/7/Vista/2003/XP |
(32 or 64 bit)
| macOS 10.8 or later |
(only 64-bit systems are supported)
Download and install PhpStorm
- Download PhpStorm for your operating system.
- Do the following depending on your operating system:
- Windows installation:
- macOS installation:
- Linux installation:
- Unpack the
PhpStorm-*.tar.gzfile 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/
- Switch to the
- Unpack the
Earlier PhpStorm versions are available for download on the Previous PhpStorm Releases page.
Run PhpStorm for the first time
Import PhpStorm settings
When you start PhpStorm for the first time, or after you have upgraded it from a previous version, the Complete Installation dialog opens where you can select whether you want to import the IDE settings:
When you start PhpStorm for the first time, or after you have upgraded it from a previous version, the Complete Installation dialog opens where you can select whether you want to import the IDE settings. If this is your first instance of PhpStorm, choose the Do not import settings option.
Perform initial configuration
Next, you are suggested to select your preferred keymap scheme and the color themes for the IDE and the code editor.
- Select the Enable opening files and projects from the command line checkbox, and specify the name the command-line launcher script to be created.
Windows users can simply complete the dialog, since there is no need to specify a command line tool. Later, for opening a file or project from command line, it will be enough to launch the
*.exe file with the project or file name as a command line argument.
Start a project in PhpStorm
- create a new project
- open an existing project
- or check out an existing project from a version control system (clone from a remote repository)
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.
- Do one of the following:
- 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.
Out of the box, PhpStorm 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 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.
- Download Toolbox App.
- Launch the setup file.
Now you can manage existing tools, install new tools and download updates: