Описание функции wp_get_upload_dir()
Функция wp_get_upload_dir() возвращает массив с информацией о каталоге загрузок WordPress, включая путь к каталогу, URL и базовый путь. Она используется для получения актуальной информации о загрузках файлов, что полезно для загрузки изображений и других медиафайлов.
Массив, возвращаемый функцией, может использоваться в темах и плагинах для динамической работы с медиафайлами.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для получения информации о каталоге загрузок
Возможные значения:
year: Год, к которому относится загруженный файл
month: Месяц, к которому относится загруженный файл
subdir: Подкаталог, если используется
Возвращаемое значение
Тип: array
Описание: Массив с информацией о каталоге загрузок
Возможные значения:
• Массив с элементами ‘path’, ‘url’, ‘subdir’, ‘basedir’, ‘baseurl’
• Пустой массив в случае ошибки
Примеры использования
Базовый пример получения информации о каталоге загрузок
$upload_dir = wp_get_upload_dir();
// Выводим путь к каталогу загрузок
echo $upload_dir['path'];
// Выводим URL загрузок
echo $upload_dir['url'];
Путь и URL для загрузок
Пример работы с подкаталогами для определенного месяца
$upload_dir = wp_get_upload_dir();
$upload_dir['path'] .= '/2023/10';
// Добавляем подкаталог для октября 2023
echo $upload_dir['path'];
Использование года и месяца в пути
Безопасность
Валидация входных данных: Функция не принимает пользовательские входные данные, поэтому проверки не требуются
Санитизация: Параметры автоматической очистки не применяются
Рекомендации: При выводе данных используйте esc_url() для URL
— Связанные функции
Загружает файл и возвращает массив с информацией о загруженном файле
Обрабатывает загрузку файла и возвращает массив с информацией о загруженном файле
— Примечания
– Ограничения
Возвращает информацию только для текущего загруженного каталога
– Частые проблемы
- Проблемы с правами доступа к каталогу загрузок
- Ошибки при отсутствии каталога загрузок