Skip to main content

Quick Project Switching in PhpStorm

Warning: This post is over a year old. I don't always update old posts with new information, so some of this information may be out of date.

How to quickly switch between projects in PhpStorm.

Following a recent conversation on Twitter with socketwench about project switching in PhpStorm, I thought I’d document my workflow here.

Here is the original tweet and my initial response. I also have a lot of PhpStorm projects, and as I’m always working on multiple projects I regularly need to switch between them.

On the PhpStorm welcome screen that displays when you first open it, your recent projects are displayed on the left-hand side of the screen, and are filterable. That means that I can start typing a project name, e.g. oli, and I will only see projects that start with that input.

The PhpStorm welcome screen with filters applied to the project list{.with-border .with-padding}

That’s great when opening a project from scratch, but what about when we’re already within a project and just want to be able to switch to another?

There’s also a way to access this list once PhpStorm is open, by clicking 'Open Recent' within the File menu. The issue here though is that this list is not filterable.

You can also access this list using the keyboard, though the 'Search everywhere' or 'Find action' panes, and these are filterable.

Using the 'find action' pane to find 'Open Recent'{.with-border .with-padding}

Once the 'Open Recent' option is selected, you see the same project list as on the welcome screen, which is filtered in the same way by starting to type potential project names.

The filtered project list{.with-border .with-padding}

Adding a Keyboard Shortcut

We can make this easier by adding a new keyboard shortcut. Within the Keymap preferences, you can search for 'Open Recent' and right-click it to add a new keyboard shortcut and define the key combination.

Finding the 'Open Recent' shortcut in the Keymap preferences{.with-border .with-padding}

Assigning a keyboard shortcut{.with-border .with-padding}

This this shortcut added, you can now use it to instantly bring up your recent projects list, filter it and switch project.

Comments or questions? I'm @opdavies on Twitter.