feat: add immutable URI query replacement helpers

[memleakd]

Description

This PR follows up on the recently added URI::withQueryVar() / withQueryVars() helpers by adding the remaining immutable query helpers for the existing mutable query APIs:

$uri = new URI('https://example.com/users?q=bob&page=1');

$next = $uri->withQuery('page=2');

$filtered = $uri->withQueryArray([
    'q'    => 'alice',
    'role' => 'admin',
]);

$withoutPage = $uri->withoutQueryVars('page');

$onlyFilters = $uri->withOnlyQueryVars('q', 'role');

Each method returns a cloned URI and leaves the original instance unchanged.

The naming follows the direction discussed in #10242:

• setQuery() -> withQuery()
• setQueryArray() -> withQueryArray()
• stripQuery() -> withoutQueryVars()
• keepQuery() -> withOnlyQueryVars()

I kept withQueryParams() out of this because PSR-7 uses that name on ServerRequestInterface, not UriInterface, and withQueryArray() keeps the URI-side API clearer.

Tests cover cloning behavior, query replacement, raw query strings, fragments, filtering/removal, and invalid query strings.

Checklist:

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

[michalsn]

Thanks, this looks like a good direction to me.

One thing I think would make this clearer for users is adding a small table to the URI user guide that lists the mutable query methods next to their immutable alternatives, for example:

Mutable method	Immutable alternative
setQuery()	withQuery()
setQueryArray()	withQueryArray()
addQuery()	withQueryVar() / withQueryVars()
stripQuery()	withoutQueryVars()
keepQuery()	withOnlyQueryVars()

It would also be useful to add a short note that the with*() methods return a cloned URI and do not modify the original instance, while the older methods modify the current instance.

For the mutable methods, could you also add TODO/docblock notes that they should eventually be deprecated in the next major version in favor of the immutable alternatives?

Maybe something like:

@TODO Deprecated in the next major version. Use withQuery() instead for immutability.

adjusted per method.

[michalsn]

Actually, this feels like something for a follow-up PR. If you have time and energy to work on it, I would really appreciate it.

[memleakd]

Thanks @michalsn, really appreciate the review and approval. I'll leave this PR as-is now and prepare a small follow-up for the docs.