04.12.2025・TechStuff
04.12.2025・TechStuff

Troubleshooting – PHP Storm on Mac

Bruno Correia

A couple of weeks ago, PHP Storm started taking too long to perform the most simple tasks – even navigating through the file tree to find a specific location would trigger the Mac’s iconic spinning beach ball. My first suspicion had to to with the file indexing, but changing the setup and disabling file indexing did not help.

Mac wait cursor, a colored spinning ball,

It came to a point where it was unbearable to work, as all of a sudden a minor change in code would freeze the whole PHP Storm for minutes – strangely, it never crashed.

I googled for solutions, and every effort failed: I updated the software and plugins, closed and reopened the program, restarted the dev environment numerous times after fiddling with the configurations, doubled memory when the notification of „insufficient memory“ popped up (and then redoubled) , cleared cache, and eventually, disabled all plugins. But nothing seemed to help.

Mac's Activity Monitor showing a memory usage of 9,53GB

A colleague who works with linux had a suggestion. Not the most elegant solution, but no more time could wasted trying to figure out what could be wrong.

First, we removed PHP Storm project configuration. In Command Line, inside the project folder, we ran the mv command to rename the .idea configuration file (we renamed it .idea_bak as it would a backup, if we needed to revert the change).

mv .idea .idea_bak

As that also did not solve the issue, we removed the whole PHP Storm configuration.

Starting from the root folder, we went to the Library folder

cd Library/
cd Application\ Support/
mv JetBrains JetBrains_bak


But attention, you will lose all configuration and all plugins, so you will have to reset everything in your PHP Storm. That was our last ditch effort, but well, it worked!

Jetbrains has a nice overview, were to find the configuration on the different operating systems.