# pre_attachment_url_to_postid

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

Тип: хук-фильтр.
Появился в версии: 6.7.0.

## Сигнатура

```php
apply_filters( 'pre_attachment_url_to_postid', int|null $post_id, string $url )
```

## Описание

Позволяет плагинам обойти поиск идентификатора вложения. Плагины, использующие эту функцию, должны возвращать:

0 (целое число), чтобы указать, что вложение не найдено,

идентификатор вложения (целое число), чтобы указать найденный идентификатор вложения,

null, чтобы указать, что WordPress должен продолжить поиск.

Предупреждение: идентификатор записи может быть null или ноль, и оба этих значения приводятся к логическому false. Сведения о приведении к логическим значениям см. в документации PHP.
При разработке фильтров с использованием этого хука для проверки идентификатора записи используйте оператор ===.

## Параметры

- `$post_id` `int|null` — обязательный. Результат поиска идентификатора записи. Null означает, что поиск не выполнялся. По умолчанию null.
- `$url` `string` — обязательный. URL, по которому выполняется поиск.

## Фильтруемое значение

Результат поиска идентификатора записи. Null означает, что поиск не выполнялся. По умолчанию null.

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

Файл: `wp-includes/media.php:5524`

```php
$post_id = apply_filters( 'pre_attachment_url_to_postid', null, $url );
```

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

- 6.7.0 — Introduced.

## Связанные

Используется в: [`attachment_url_to_postid`](https://chugunov.pro/api-wordpress/functions/attachment_url_to_postid/).

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