Получить копию с другой строкой запроса Uri::withQuery

Модуль: main — подключать отдельно не нужно

Метод Uri::withQuery возвращает копию адреса с другой строкой запроса. Метод заменяет строку целиком. Чтобы изменить отдельные параметры, используйте addParams и deleteParams. Метод входит в интерфейс PSR-7 UriInterface.

Сигнатура метода в классе Bitrix\Main\Web\Uri:

public function withQuery(string $query): UriInterface

Параметры

Обязательные параметры обозначены *

Параметр Тип Описание
query* string Задает строку запроса без ?. Метод не кодирует значение. Пустая строка убирает строку запроса

Возвращаемое значение

Метод возвращает новый объект Uri.

Примеры

Пример. Код заменяет строку запроса:

<?php
use Bitrix\Main\Web\Uri;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$uri = new Uri('/units/?page=2&sort=name');

echo $uri->withQuery(http_build_query(['view' => 'grid']))->getUri() . ' ' . $uri->withQuery('')->getUri();

Код выведет /units/?view=grid /units/.

Смотрите также