Ignore symlinks in project (indexing, code-completion etc)

Is there a feature for telling PHPStorm on a global basis to completly ignore symlinks in a project?

Either hiding them completly or just stop indexing them.

From reading various articles about this topic I already know that I can simly mark the folder as excluded. But it would be really nice, to just tell PHPStorm to stop doing this for every symlink in every project. I read about scopes but I am not sure if this can be configured that way...is there a pattern that matches only symlinks?


Hi there,

There are no such options AFAIK. And such option does not make much sense in general -- what if somebody wants to keep some big shared library outside of the project and use it via symlink (think about old style projects where no composer or any other dependency management system is used (e.g. not even git)) .. or just some other helper code that is not needed beyond development environment (IDE helpers etc).

Right now only marking such folders as Excluded or marking individual files (if there few of them) as Plain Text is the real way to go. Custom scopes will not help here at all (they are not taken into consideration when doing Code Completion/Indexing)

On related note:



Well it would be easy to fix:

  • Ignore symlinks within the same project
  • Accept symlinks which point outside the project

Did you get anywhere Michael? Symlink indexing (I think) is locking up my system and I can't work. I excluded the web directory but the indexer still goes there. I followed the advice at this link and it's still locking up. Maybe it's not even the indexer as there is no "indexing" status on the bottom status bar. 




@Richard Riley I think you misunderstood. It would be easy to fix (for Jetbrains), but it's not fixed until now.

Still waiting for a feedback...


No I didn't misunderstand. Jetbrains have refused it as their issue, There is a another list on this - probably at the github for the symfony extension. Putting my PC into "low power mode" fixes it btw.



This just affected me. REALLY freaking annoying and quite frankly absurd this hasn't been resolved.


Hi yes I'd like to add my support for this:

I have a project with a number of docker containers as subprojects under the root, but they share common code using symlinks ( and docker build context ).

Every time I search, I find 10 occurrences of the code I'm looking for, and I'm constantly fighting 'background changes / load from disk'  when trying to refactor anything.

Having intellJidea etc ignore symlinks for the purpose of search and refactor would be desireable


Beep We REALLY need a solution to this. I am working on a 3rd party project that has symlinks in the web subdirectory pointing to millions of files. IDEA is just freezing. It can't be that hard to turn off indexing for symlinks or directories with some sort of IGNORE directive surely (like "ignore" in the project hierarchy directory tagging)? I have set both my HUGE hierarchies to "ignore" and no dice. PLEASE fix this.


Please sign in to leave a comment.