WP_GET_UPLOAD_DIR() │ WP 4.5.0

Функция WP_GET_UPLOAD_DIR() позволяет получить информацию о директории загруз��и файлов. Это аналог функции wp_upload_dir(), но более легковесная, так как не пытается создать директорию для загрузок. Она предназначена для использования в темах, когда нужно лишь получать пути к директории и URL, обычно в случаях, когда файлы не загружаются.

Использование

wp_get_upload_dir();

Пример использования

1. Получение данных о директории загрузок

$dir = wp_get_upload_dir();

print_r( $dir );

/* Это выведет:
Array
(
    [path]    => /home/example.com/public_html/wp-content/uploads/2016/04
    [url]     => http://example.com/wp-content/uploads/2016/04
    [subdir]  => /2016/04
    [basedir] => /home/example.com/public_html/wp-content/uploads
    [baseurl] => http://example.com/wp-content/uploads
    [error]   =>
)
*/

// Выводим информацию о директории
echo $dir['basedir']; // /home/example.com/public_html/wp-content/uploads
echo $dir['baseurl']; // http://example.com/wp-content/uploads

Для многосайтовой установки данные будут выглядеть так:

Array
(
    [path] => /var/app/www/wp-content/uploads/sites/2/2023/09
    [url] => http://example.com/wp-content/uploads/sites/2/2023/09
    [subdir] => /2023/09
    [basedir] => /var/app/www/wp-content/uploads/sites/2
    [baseurl] => http://example.com/wp-content/uploads/sites/2
    [error] =>
)

2. Другой пример использования директории загрузок

Для получения дополнительной информации и примеров можно обратиться к описанию функции wp_upload_dir().

Возвращаемое значение

Функция возвращает массив, который содержит следующие ключи:

• path: полный путь к директории загрузок на сервере.
• url: URL, по которому доступна директория загрузок в интернете.
• subdir: поддиректория, в которой хранятся загруженные файлы.
• basedir: базовый путь к директории загрузок.
• baseurl: базовый URL директории загрузок.
• error: отображение возможной ошибки (пока пусто).

Примечания

• Функция wp_get_upload_dir() была введена в версии 4.5.0.

Программный код

function wp_get_upload_dir() {
    return wp_upload_dir( null, false );
}

Связанные функции

• Функции загрузки:

  • download_url()
  • media_handle_sideload()
  • media_handle_upload()
  • media_sideload_image()
  • wp_handle_upload()

• Функции работы с файлами и директорией:

  • get_attached_file()
  • get_home_path()
  • wp_upload_dir()

Эти функции помогают управлять загрузками и работать с директориями в WordPress.