wp_handle_sideload( array $file, array|false $overrides = false, string|null $time = null ): array

Description

Parameters

$filearray

Reference to a single element of $_FILES. Call the function once for each uploaded file. See _wp_handle_upload() for accepted values.

$overridesarray|falseoptional

An associative array of names => values to override default variables. Default false. See _wp_handle_upload() for accepted values.Default: false

$timestring|nulloptional

Time formatted in 'yyyy/mm'. Default null.Default: null

Return

array

See _wp_handle_upload() for return value.

Uses · 1

• _wp_handle_upload()Handles PHP uploads in WordPress.

Used by · 2

• WP_REST_Attachments_Controller::upload_from_data()Handles an upload via raw POST data.
• media_handle_sideload()Handles a side-loaded file in the same way as an uploaded file is handled by media_handle_upload().

Source

View on Trac ↗View on GitHub ↗

1135function wp_handle_sideload( &$file, $overrides = false, $time = null ) {1136	/*1137	 *  $_POST['action'] must be set and its value must equal $overrides['action']1138	 *  or this:1139	 */1140	$action = $overrides['action'] ?? 'wp_handle_sideload';1141	return _wp_handle_upload( $file, $overrides, $time, $action );1142}

History

Introduced in 2.6.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-admin/includes/file.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.