WP_REST_Attachments_Controller

27class WP_REST_Attachments_Controller extends WP_REST_Posts_Controller {28 29	/**30	 * Whether the controller supports batching.31	 *32	 * @since 5.9.033	 * @var false34	 */35	protected $allow_batch = false;36 37	/**38	 * Image size token for the source-format original preserved alongside a39	 * client-generated derivative (e.g. the HEIC file kept next to its JPEG).40	 *41	 * Used both in the `/sideload` route schema and when dispatching the42	 * sideloaded file to its metadata key, so the two never drift apart.43	 *44	 * @since 7.1.045	 * @var string46	 */47	const IMAGE_SIZE_SOURCE_ORIGINAL = 'source_original';48 49	/**50	 * Metadata key holding the basename of the source-format original.51	 *52	 * Deliberately specific so it never collides with the generic `original`53	 * or `original_image` keys other flows write to.54	 *55	 * @since 7.1.056	 * @var string57	 */58	const META_KEY_SOURCE_IMAGE = 'source_image';59 60	/**61	 * Post meta key recording the file names produced by the sideload endpoint.62	 *63	 * Each successful sideload appends the file name(s) it created for an64	 * attachment under this key. The finalize endpoint reads them back to65	 * confirm every stored sub-size was actually produced here, rather than66	 * trusting a client-supplied name that could point at another attachment's67	 * files. Stored as one row per value (via {@see add_post_meta()}) so concurrent68	 * sideloads never read-modify-write a shared value.69	 *70	 * @since 7.1.071	 * @var string72	 */73	const META_KEY_SIDELOAD_FILE_NAME = '_wp_sideloaded_file';74 75	/**76	 * Registers the routes for attachments.77	 *78	 * @since 5.3.079	 *80	 * @see register_rest_route()81	 */82	public function register_routes() {83		parent::register_routes();84		register_rest_route(85			$this->namespace,86			'/' . $this->rest_base . '/(?P<id>[\d]+)/post-process',87			array(88				'methods'             => WP_REST_Server::CREATABLE,89				'callback'            => array( $this, 'post_process_item' ),90				'permission_callback' => array( $this, 'post_process_item_permissions_check' ),91				'args'                => array(92					'id'     => array(93						'description' => __( 'Unique identifier for the attachment.' ),94						'type'        => 'integer',95					),96					'action' => array(97						'type'     => 'string',98						'enum'     => array( 'create-image-subsizes' ),99						'required' => true,100					),101				),102			)103		);104		register_rest_route(105			$this->namespace,106			'/' . $this->rest_base . '/(?P<id>[\d]+)/edit',