download_url()

使用WordPress HTTP类将URL下载到本地临时文件。

原型

download_url( string $url, int $timeout = 300 )

描述

请注意，调用函数必须取消链接（）文件。

参数

$url (string) (Required) 要下载的文件的URL

$timeout (int) (Optional) 请求下载文件的超时默认为300秒

返回值

(mixed)  

源文件

路径：wp-admin/includes/file.php

<?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;
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/download_url/