WP_Upgrader::download_package( string $package, bool $check_signatures = false, array $hook_extra = array() ): string|WP_Error

307	public function download_package( $package, $check_signatures = false, $hook_extra = array() ) {308		/**309		 * Filters whether to download a package for a WordPress core, plugin, theme, or translation upgrade.310		 *311		 * Return a non-false value to short-circuit the download and return that value instead.312		 *313		 * @since 3.7.0314		 * @since 5.5.0 Added the `$hook_extra` parameter.315		 *316		 * @param false|string|WP_Error $reply      Whether to short-circuit the download, the path to the downloaded package,317		 *                                          or a WP_Error object. Default false.318		 * @param string                $package    The package URI. May be a remote URL or local file path.319		 * @param WP_Upgrader           $upgrader   The WP_Upgrader instance.320		 * @param array                 $hook_extra Extra arguments passed to hooked filters.321		 */322		$reply = apply_filters( 'upgrader_pre_download', false, $package, $this, $hook_extra );323		if ( false !== $reply ) {324			return $reply;325		}326 327		if ( ! preg_match( '!^(http|https|ftp)://!i', $package ) && file_exists( $package ) ) { // Local file or remote?328			return $package; // Must be a local file.329		}330 331		if ( empty( $package ) ) {332			return new WP_Error( 'no_package', $this->strings['no_package'] );333		}334 335		$this->skin->feedback( 'downloading_package', $package );336 337		$download_file = download_url( $package, 300, $check_signatures );338 339		if ( is_wp_error( $download_file ) && ! $download_file->get_error_data( 'softfail-filename' ) ) {340			return new WP_Error( 'download_failed', $this->strings['download_failed'], $download_file->get_error_message() );341		}342 343		return $download_file;344	}