Как изменять пути к медиа файлам в WordPress без ошибок: практическое руководство

Автор: Ольга Игнатьева | Опубликовано: 13.02.2026

В процессе работы с WordPress иногда возникает необходимость изменить пути к медиафайлам. Это может быть связано с переносом сайта на другой домен, сменой структуры папок или использованием CDN. Однако делать это нужно аккуратно, чтобы не сломать отображение картинок и других медиа объектов.

Почему важно правильно менять пути к медиафайлам в WordPress

По умолчанию WordPress хранит URL медиафайлов в базе данных и использует их для вывода изображений, видео и других вложений. Если просто изменить структуру папок на сервере или домен, но не обновить пути в базе, то медиа перестанут отображаться, появятся ошибки 404.

Особенно актуально это при переносе сайта с локального сервера на боевой, при смене домена или при использовании CDN для ускорения загрузки. Важно понимать, что WordPress не хранит абсолютные пути к файлам на диске, а именно URL для вывода в браузере, и именно их надо корректно править.

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

Где хранятся пути к медиафайлам в WordPress

Основные данные о медиафайлах хранятся в таблице wp_posts с типом записи attachment. Поле guid содержит оригинальный URL файла. Также пути встречаются в post_content у вложений, если это изображения в контенте, и в мета-данных, например, в _wp_attached_file (таблица wp_postmeta).

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

Особенности поля guid

Поле guid не рекомендуется менять без особой необходимости, так как оно служит уникальным идентификатором записи. Однако для корректного отображения медиа при смене домена иногда приходится обновлять и его.

Как изменить пути к медиафайлам через поиск и замену в базе

Самый распространённый способ — это выполнить поиск и замену URL в базе данных. Это можно сделать с помощью плагина или вручную через SQL.

Использование плагина Better Search Replace

Плагин Better Search Replace позволяет выполнять поиск и замену строк в базе данных, поддерживает сериализованные данные, что критично для WordPress.

Установите и активируйте плагин.
Перейдите в Инструменты > Better Search Replace.
В поле поиска введите текущий URL, например: https://staryj-site.ru/wp-content/uploads.
В поле замены введите новый URL, например: https://novyj-site.ru/wp-content/uploads.
Выберите таблицы для замены (рекомендуется выбрать все или хотя бы wp_posts, wp_postmeta).
Запустите сначала тестовый режим, чтобы увидеть результаты без изменений.
Если всё корректно, выполните замену.

Ручная замена через WP-CLI

Если у вас есть доступ к WP-CLI, можно выполнить команду:

wp search-replace 'https://staryj-site.ru/wp-content/uploads' 'https://novyj-site.ru/wp-content/uploads' --all-tables --precise --recurse-objects

Эта команда безопасно обновит все вхождения с учётом сериализации.

Изменение путей к медиафайлам через фильтры WordPress

Если вы хотите динамически переопределять URL медиафайлов без вмешательства в базу, можно использовать фильтр wp_get_attachment_url. Это удобно для временного решения или тестов.

function wphow_filter_attachment_url( $url, $post_id ) {
    // Заменяем старый домен на новый
    $old_domain = 'https://staryj-site.ru';
    $new_domain = 'https://novyj-site.ru';
    if ( strpos( $url, $old_domain ) === 0 ) {
        $url = str_replace( $old_domain, $new_domain, $url );
    }
    return $url;
}
add_filter( 'wp_get_attachment_url', 'wphow_filter_attachment_url', 10, 2 );

Этот код автоматически подменит URL медиа при выводе без изменения базы данных.

Примеры плагинов для управления медиа и путями

Помимо Better Search Replace, есть специализированные решения:

Media File Renamer — позволяет переименовывать файлы и автоматически обновлять ссылки.
WP Offload Media — для загрузки медиа в облачные хранилища и работы с CDN.
Clearfy Pro — оптимизирует работу сайта, в том числе управляет кэшированием и URL, что может помочь с медиа.

Для большинства задач по смене путей комбинируйте поиск и замену с фильтрами, чтобы избежать ошибок.

Как избежать ошибок и сохранить SEO при смене путей к медиа

При смене URL медиа важно не потерять позиции в поисковых системах и не получить битые ссылки. Вот несколько советов:

Делайте полный бэкап базы и файлов перед изменениями.
Используйте 301 редиректы со старых URL на новые, чтобы поисковики перенесли вес.
Проверьте, что все ссылки в контенте обновились.
Используйте инструменты проверки битых ссылок, например, плагин WPRemark или онлайн-сервисы.
Обновите sitemap с новыми URL.

Практический пример: смена домена медиа с помощью кода и плагина

Допустим, у вас есть сайт на https://old-domain.ru, и вы хотите перенести медиа на https://cdn.new-domain.ru/uploads. Для этого:

Установите плагин Better Search Replace и выполните замену https://old-domain.ru/wp-content/uploads на https://cdn.new-domain.ru/uploads.
Добавьте фильтр в functions.php для динамической подмены (если нужно временно):

function wphow_filter_attachment_url( $url, $post_id ) {
    $old_url = 'https://old-domain.ru/wp-content/uploads';
    $new_url = 'https://cdn.new-domain.ru/uploads';
    if ( strpos( $url, $old_url ) !== false ) {
        $url = str_replace( $old_url, $new_url, $url );
    }
    return $url;
}
add_filter( 'wp_get_attachment_url', 'wphow_filter_attachment_url', 10, 2 );

Это позволит избежать ошибок, пока CDN не будет окончательно настроен.

Выводы и рекомендации

Изменение путей к медиафайлам в WordPress — задача, требующая аккуратности и понимания устройства CMS. Используйте поиск и замену с поддержкой сериализации, комбинируйте с фильтрами для динамической подмены, обязательно делайте резервные копии и проверяйте сайт после изменений.

Для оптимизации и удобства рекомендуем обратить внимание на плагин Clearfy Pro, который помогает с управлением URL и оптимизацией загрузки медиа.