Описание функции wp_upload_dir()
Функция wp_upload_dir() возвращает массив с информацией о директории загрузок, включая URL, путь к директории, и текущую дату. Она используется для работы с загрузками файлов в WordPress, предоставляя информацию о том, где будут храниться загружаемые файлы.
Функция полезна при загрузке изображений, документов и других файлов в библиотеку медиа.
Параметры
$time
Тип: string
Обязательный: Нет
По умолчанию: Текущая дата в формате ‘Y/m’
Описание: Время, используемое для генерации пути загрузки
Возможные значения:
0: YYYY-MM-DD
1: timestamp
2: current date
$mimes
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив MIME-типов, разрешенных для загрузки
Возвращаемое значение
Тип: array
Описание: Массив с информацией о директории загрузок
Возможные значения:
• Массив с ключами ‘path’, ‘url’, ‘subdir’, ‘basedir’, ‘baseurl’, ‘error’
• Возвращает false при ошибке получения пути
Примеры использования
Базовый пример получения URL директории загрузок
$upload_dir = wp_upload_dir();
echo $upload_dir['url'];
// Выводит URL директории загрузок
Получение информации о загрузках за определенную дату
$upload_dir = wp_upload_dir('2023-10-01');
// Получение пути для 1 октября 2023 года
Безопасность
Валидация входных данных: Функция проверяет входные параметры
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Необходимо проверять массив перед использованием, чтобы избежать ошибок
— Связанные функции
Обрабатывает загрузку файла
Получает URL вложения по его ID
— Хуки
Фильтрует массив с информацией о директории загрузок
— Примечания
– Ограничения
Возвращает информацию только для стандартных директорий загрузок
– Частые проблемы
- Ошибки при изменении настроек загрузки
- Неправильные пути при использовании кастомных загрузок
