# get_search_link()

URL: https://chugunov.pro/api-wordpress/functions/get_search_link/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 3.0.0.

## Сигнатура

```php
get_search_link( string $query = '' ): string
```

## Описание

Извлекает постоянную ссылку для поиска.

## Параметры

- `$query` `string` — необязательный, по умолчанию `''`. Строка запроса для использования. Если пусто, используется текущий запрос.

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

`string`

## Исходный код

Файл: `wp-includes/link-template.php:1184`

```php
function get_search_link( $query = '' ) {
	global $wp_rewrite;

	if ( empty( $query ) ) {
		$search = get_search_query( false );
	} else {
		$search = stripslashes( $query );
	}

	$permastruct = $wp_rewrite->get_search_permastruct();

	if ( empty( $permastruct ) ) {
		$link = home_url( '?s=' . urlencode( $search ) );
	} else {
		$search = urlencode( $search );
		$search = str_replace( '%2F', '/', $search ); // %2F(/) is not valid within a URL, send it un-encoded.
		$link   = str_replace( '%search%', $search, $permastruct );
		$link   = home_url( user_trailingslashit( $link, 'search' ) );
	}

	/**
	 * Filters the search permalink.
	 *
	 * @since 3.0.0
	 *
	 * @param string $link   Search permalink.
	 * @param string $search The URL-encoded search term.
	 */
	return apply_filters( 'search_link', $link, $search );
}
```

## История изменений

- 3.0.0 — Introduced.

## Связанные

Использует: [`get_search_query`](https://chugunov.pro/api-wordpress/functions/get_search_query/), [`user_trailingslashit`](https://chugunov.pro/api-wordpress/functions/user_trailingslashit/), `WP_Rewrite::get_search_permastruct`, [`home_url`](https://chugunov.pro/api-wordpress/functions/home_url/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`get_search_feed_link`](https://chugunov.pro/api-wordpress/functions/get_search_feed_link/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_search_link/