WordPress как на ладони
wordpress jino

download_url() WP 2.5.0

Загружает УРЛ (файл) во временный каталог PHP, работает на основе HTTP класса WordPress. Имейте ввиду, при вызове функции всегда нужно удалять файл через unlink()!

Во фронт-энде для работы функции нужны следующие файлы:

require_once( ABSPATH . 'wp-admin/includes/file.php' );
Используется в: media_sideload_image().
Работает на основе: wp_safe_remote_get(), wp_tempnam()

Хуков нет.

Возвращает

Строку/WP_Error. Название файла (абсолютный путь до файла на сервере), если файл успешно загружен. WP_Error объект в случае ошибки.

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

download_url( $url, $timeout );
$url(строка) (обязательный)
УРЛ файла, который нужно загрузить во временную директорию.
$timeout(число)
Время после которого функция перестанет загружать файл. По умолчанию 300 секунд.
По умолчанию: 300

Примеры

#1 Пример загрузки файла во временный каталог PHP

В этом примере загрузим логотип WordPress и проверим загрузку на ошибки. Также после обработки удалим временный файл на сервере.

require_once( ABSPATH . "wp-admin" . '/includes/file.php');

$tmp = download_url( 'https://s.w.org/style/images/wp-header-logo.png' );

if( is_wp_error( $tmp ) )
	echo $tmp->get_error_messages();
else
	echo $tmp; // выведет: /tmp/wp-header-logo.tmp

// делаем что-либо с файлом ...

// удаляем временный файл
@ unlink( $tmp );

Код download url: wp-admin/includes/file.php WP 4.8.2

<?php
function download_url( $url, $timeout = 300 ) {
	//WARNING: The file is not automatically deleted, The script must unlink() the file.
	if ( ! $url )
		return new WP_Error('http_no_url', __('Invalid URL Provided.'));

	$url_filename = basename( parse_url( $url, PHP_URL_PATH ) );

	$tmpfname = wp_tempnam( $url_filename );
	if ( ! $tmpfname )
		return new WP_Error('http_no_file', __('Could not create Temporary file.'));

	$response = wp_safe_remote_get( $url, array( 'timeout' => $timeout, 'stream' => true, 'filename' => $tmpfname ) );

	if ( is_wp_error( $response ) ) {
		unlink( $tmpfname );
		return $response;
	}

	if ( 200 != wp_remote_retrieve_response_code( $response ) ){
		unlink( $tmpfname );
		return new WP_Error( 'http_404', trim( wp_remote_retrieve_response_message( $response ) ) );
	}

	$content_md5 = wp_remote_retrieve_header( $response, 'content-md5' );
	if ( $content_md5 ) {
		$md5_check = verify_file_md5( $tmpfname, $content_md5 );
		if ( is_wp_error( $md5_check ) ) {
			unlink( $tmpfname );
			return $md5_check;
		}
	}

	return $tmpfname;
}

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

Из метки: Файлы

Еще из метки: upload (файловая система file загрузка)

Еще из раздела: Без рубрики

download_url Комментариев нет

Здравствуйте, !

Ваш комментарий