Multi-line Regex Searches in PhpStorm

A quick tip about how to do multi-line regular expression searches in PhpStorm.

By Bob Ray  |  September 17, 2024  |  2 min read
Multi-line Regex Searches in PhpStorm

This is a quick tip about doing multi-line regular expression (regex) searches in PhpStorm. Even if you don't use PhpStorm, you might find this helpful if your editor can do regex searches, but by default won't do multi-line searches.

The Problem

Sometimes, you want to use a regular expression that searches for text that might be on more than one line. Without a multi-line search, there's no way to do it. When you do a regex search in code, you can set it to do a multi-line search with a modifier at the end of the pattern. This is no help, though, when you want to do the search in your editor and there's no easy way to tell it to include line breaks in the pattern.

There may be a way to tell PhpStorm's editor to do a multi-line search, but if there is, I haven't found it.

The Solution

The answer is to use a character class that will cover any end of line character. The easiest pattern for that is [\s\S]. This will include any space character, and any non-space character. In other words, any character at all, including newlines.

Say, for example, that you want to find the strings string1 and string2 in a file but the two strings may not be on the same line. You can use this pattern:

^.*string1[\s\S]+?string2

The question mark after [\s\S]+ makes the search "non-greedy," so it will stop at the first match. If you want all the text between the first occurrence of string1 and the last occurrence of string2, you can remove it.


Bob Ray is the author of the MODX: The Official Guide and dozens of MODX Extras including QuickEmail, NewsPublisher, SiteCheck, GoRevo, Personalize, EZfaq, MyComponent and many more. His website is Bob’s Guides. It not only includes a plethora of MODX tutorials but there are some really great bread recipes there, as well.