wp_insert_attachment( string|array $args, string|false $file = false, int $parent, bool $wp_error = false, bool $fire_after_hooks = true ): int|WP_Error

使用示例

• 示例1

  示例
  将附件插入到文章ID为37的父项：

  <?php 
  // $filename should be the path to a file in the upload directory.
  $filename = '/path/to/uploads/2013/03/filename.jpg';
  
  // The ID of the post this attachment is for.
  $parent_post_id = 37;
  
  // Check the type of file. We'll use this as the 'post_mime_type'.
  $filetype = wp_check_filetype( basename( $filename ), null );
  
  // Get the path to the upload directory.
  $wp_upload_dir = wp_upload_dir();
  
  // Prepare an array of post data for the attachment.
  $attachment = array(
  	'guid'           => $wp_upload_dir['url'] . '/' . basename( $filename ), 
  	'post_mime_type' => $filetype['type'],
  	'post_title'     => preg_replace( '/.[^.]+$/', '', basename( $filename ) ),
  	'post_content'   => '',
  	'post_status'    => 'inherit'
  );
  
  // Insert the attachment.
  $attach_id = wp_insert_attachment( $attachment, $filename, $parent_post_id );
  
  // Make sure that this file is included, as wp_generate_attachment_metadata() depends on it.
  require_once( ABSPATH . 'wp-admin/includes/image.php' );
  
  // Generate the metadata for the attachment, and update the database record.
  $attach_data = wp_generate_attachment_metadata( $attach_id, $filename );
  wp_update_attachment_metadata( $attach_id, $attach_data );
  
  set_post_thumbnail( $parent_post_id, $attach_id );
  ?>

• 示例2

  如果要插入媒体附件，标题和描述分别为‘post_excerpt’和‘post_content’。例子：

      wp_insert_attachment(
  		array(
  			'guid' => $upload['url'],
  			'post_title' => sanitize_text_field( $title ),
  			'post_excerpt' => sanitize_text_field( $caption ),
  			'post_content' => sanitize_text_field( $description ),
  			'post_mime_type' => $response_headers['content-type'],
   		),
  		$upload['file'],
  		0
  	);

• 示例3

  失败时返回int 0

• 示例4

  将图像附加到文章后，可以使用set_post_thumbnail()将其设置为文章的特色图像。

• 示例5

  用法

  <?php wp_insert_attachment( $attachment, $filename, $parent_post_id ); ?>