feat: [FileCollection] add function to reatain multiple patterns

[christianberkman]

Description
Supersedes #8953

Add a method to FileCollection that accepts an array of strings to retain multiple patterns in the file collection.

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[kenjis]

LGTM! Thank you.

[christianberkman]

LGTM! Thank you.

Thanks. I assume adding a similar function for removePattern() would just be for convenience sake since removePattern() can be called consecutively to remove multiple patterns, opposed to calling retainPattern consecutively.