Как использовать фильтры для изменения путей загрузки файлов в WordPress

В WordPress стандартная директория для загрузки файлов — это папка wp-content/uploads. Однако в ряде случаев бывает необходимо изменить путь загрузки файлов, например, для разделения пользовательских файлов, организации хранения по проектам или для оптимизации безопасности. Сделать это можно с помощью фильтров WordPress, которые позволяют изменить базовые параметры загрузки без вмешательства в ядро.

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

WordPress предлагает несколько фильтров, которые позволяют изменить путь и URL загрузок:

• upload_dir — фильтр, который изменяет массив параметров директории загрузки, включая пути и URL;
• wp_handle_upload_prefilter — фильтр для проверки и изменения файла перед загрузкой;
• wp_handle_upload — фильтр для обработки результата загрузки.

Самый универсальный способ изменить путь к директории загрузки — использовать фильтр upload_dir. Он позволяет задать новые значения для ключей path, url, basedir и baseurl.

Как работает фильтр upload_dir: структура и параметры

Фильтр получает массив с ключами:

• path — полный физический путь к директории с текущим годом и месяцем;
• url — URL для доступа к директории с текущим годом и месяцем;
• subdir — часть пути с месяцем и годом, например, /2024/06;
• basedir — базовый физический путь до папки uploads;
• baseurl — базовый URL до папки uploads;
• error — сообщение об ошибке (если есть).

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

Практический пример: изменение директории загрузки на /custom-uploads/

Рассмотрим пример, когда нам нужно хранить все загруженные файлы в отдельной папке custom-uploads в корне сайта, а не в стандартной директории wp-content/uploads.

add_filter('upload_dir', 'wpupload_custom_upload_dir');
function wpupload_custom_upload_dir($dirs) {
    // Задаем новую базовую директорию для загрузок
    $custom_dir = ABSPATH . 'custom-uploads';
    $custom_url = home_url('/custom-uploads');

    // Обновляем параметры массива
    $dirs['basedir'] = $custom_dir;
    $dirs['baseurl'] = $custom_url;
    $dirs['path'] = $custom_dir . $dirs['subdir'];
    $dirs['url'] = $custom_url . $dirs['subdir'];

    return $dirs;
}

В этом коде мы использовали константу ABSPATH — корень WordPress, и функцию home_url() для формирования правильного URL. Теперь все загруженные файлы будут попадать в папку custom-uploads/год/месяц.

Как задать загрузку файлов по типу контента

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

Пример кода, который загружает файлы с расширением .pdf в папку pdf-files:

add_filter('upload_dir', 'wpupload_pdf_upload_dir');
function wpupload_pdf_upload_dir($dirs) {
    if (!empty($_FILES['async-upload']['name'])) {
        $file_name = $_FILES['async-upload']['name'];
        $ext = pathinfo($file_name, PATHINFO_EXTENSION);

        if (strtolower($ext) === 'pdf') {
            $custom_dir = $dirs['basedir'] . '/pdf-files';
            $custom_url = $dirs['baseurl'] . '/pdf-files';

            $dirs['path'] = $custom_dir . $dirs['subdir'];
            $dirs['url'] = $custom_url . $dirs['subdir'];
            $dirs['basedir'] = $custom_dir;
            $dirs['baseurl'] = $custom_url;
        }
    }
    return $dirs;
}

Такой подход помогает разделять загруженный контент по типам и упрощает управление файлами.

Особенности работы с мультисайтом и пользовательскими директориями

Для сайтов с включенным мультисайтом WordPress пути к загрузкам могут строиться иначе, учитывая ID сайта. При изменении директорий загрузки важно учитывать это, чтобы не нарушить структуру. Рекомендуется проверять константу is_multisite() и, если нужно, строить пути с учетом подкаталогов мультисайта.

Кроме того, если вы хотите хранить файлы в папках, доступ к которым ограничен — например, вне веб-директории — можно изменить basedir на абсолютный путь вне ABSPATH. Тогда для доступа к файлам придется реализовать прокси-скрипты или ссылки с контролем доступа.

Использование плагинов для управления путями загрузки

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

Отладка и проверка правильности путей загрузки

Чтобы убедиться, что пути загрузки изменены корректно, можно вывести текущие параметры загрузки прямо в шаблоне или административной части:

add_action('admin_notices', 'wpupload_show_upload_dir');
function wpupload_show_upload_dir() {
    $dirs = wp_upload_dir();
    echo '<div class="notice notice-info">';
    echo '<p>Current upload directory: ' . esc_html($dirs['path']) . '</p>';
    echo '<p>Current upload URL: ' . esc_html($dirs['url']) . '</p>';
    echo '</div>';
}

Это поможет оперативно увидеть, как именно WordPress обрабатывает пути, и быстро исправить ошибки.

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

Фильтр upload_dir — мощный инструмент для гибкой настройки загрузок в WordPress. Используйте его, чтобы:

• Организовать хранение файлов по типам или проектам;
• Переместить загрузки в защищённые или нестандартные директории;
• Оптимизировать структуру сайта и упростить резервное копирование.

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