WP_REST_Attachments_Controller::finalize_item( WP_REST_Request $request ): WP_REST_Response|WP_Error

3247	public function finalize_item( WP_REST_Request $request ) {3248		$attachment_id = (int) $request['id'];3249 3250		$post = $this->get_post( $attachment_id );3251		if ( is_wp_error( $post ) ) {3252			return $post;3253		}3254 3255		/**3256		 * Sub-size metadata collected from sideload responses. Confirm every3257		 * file name was produced by a prior sideload for this attachment before3258		 * storing it, so a client cannot make finalize record (and later read or3259		 * delete) another attachment's files.3260		 *3261		 * @var list<Image_Sub_Size> $sub_sizes3262		 */3263		$sub_sizes  = $request['sub_sizes'] ?? array();3264		$provenance = $this->validate_sub_size_provenance( $attachment_id, $sub_sizes );3265		if ( is_wp_error( $provenance ) ) {3266			return $provenance;3267		}3268 3269		$metadata = wp_get_attachment_metadata( $attachment_id );3270		if ( ! is_array( $metadata ) ) {3271			$metadata = array();3272		}3273 3274		// Apply all sub-size metadata collected from sideload responses.3275		foreach ( $sub_sizes as $sub_size ) {3276			$image_size = $sub_size['image_size'];3277 3278			// When multiple size names share identical dimensions the client3279			// sends a single sub-size entry with an array of names. Register the3280			// same file under each name.3281			if ( is_array( $image_size ) ) {3282				/*3283				 * Arrays carry regular sizes only, as the sideload endpoint3284				 * enforces. Each special size names a single file handled by one3285				 * of the branches below, so grouping one under a shared file3286				 * would write it to the wrong place; reject rather than guess.3287				 */3288				if ( array_intersect( $image_size, self::get_special_image_sizes() ) ) {3289					return new WP_Error(3290						'rest_invalid_sub_size_name',3291						__( 'A grouped sub-size entry may only name regular image sizes.' ),3292						array( 'status' => 400 )3293					);3294				}3295 3296				// As below: `file` is not required by the schema, and a size3297				// entry that names no file is not worth recording.3298				if ( empty( $sub_size['file'] ) ) {3299					continue;3300				}3301 3302				$metadata['sizes'] = $metadata['sizes'] ?? array();3303 3304				foreach ( $image_size as $name ) {3305					$metadata['sizes'][ $name ] = array(3306						'width'     => $sub_size['width'] ?? 0,3307						'height'    => $sub_size['height'] ?? 0,3308						'file'      => $sub_size['file'],3309						'mime-type' => $sub_size['mime_type'] ?? '',3310						'filesize'  => $sub_size['filesize'] ?? 0,3311					);3312				}3313				continue;3314			}3315 3316			if ( 'original' === $image_size || 'scaled' === $image_size ) {3317				// Skip malformed entries so a bad payload cannot blank out the3318				// main file metadata.3319				if ( empty( $sub_size['file'] ) ) {3320					continue;3321				}3322 3323				/*3324				 * Record the supplied full-size image (from sideload_item()) as3325				 * the main file, keeping the current attached file as3326				 * `original_image`. A 'scaled' image is downsized and an
When	Instructions	Calls it makes
`is_wp_error()`	12	`->get_post(), is_wp_error()`
always	24–25	`->get_post(), is_wp_error(), ->validate_sub_size_provenance(), is_wp_error()`
`!is_wp_error() && !$sub_sizes && is_array($image_size) && array_intersect()`	52–54	`->get_post(), is_wp_error(), ->validate_sub_size_provenance(), is_wp_error(), wp_get_attachment_metadata(), ::get_special_image_sizes(), array_intersect(), __()`
`!is_wp_error()`	73–81	`->get_post(), is_wp_error(), ->validate_sub_size_provenance(), is_wp_error(), wp_get_attachment_metadata(), apply_filters(), wp_update_attachment_metadata(), ->get_sideloaded_file_names(), array_unique(), rest_get_route_for_post(), width(), ->prepare_item_for_response()`
PHP	Compiled	Executed	Branches	Notes
8.6-dev	255	12–81	46
8.5	255	12–81	46
8.4	255	12–81	46	3 fewer instructions than PHP 8.3
8.3	258	12–81	46
8.2	258	12–81	46
8.1	258	12–81	46
7.4	258	12–81	46