WordPress 编程上传多尺寸图片方法

本文将介绍如何在 WordPress 中通过编程方式上传一张图片，并自动生成多个不同尺寸的图片。我们将探讨如何利用 WordPress 提供的函数和钩子，实现图片上传和尺寸生成的功能，从而优化网站的图片管理流程。

上传图片并生成不同尺寸

WordPress 提供了强大的媒体库管理功能，我们可以利用这些功能来实现图片上传和尺寸生成。以下是一种实现方式：

1. 处理图片上传

首先，你需要创建一个表单，允许用户上传图片。在处理表单提交时，使用 wp_handle_upload() 函数来处理上传的文件。

require_once( ABSPATH . 'wp-admin/includes/image.php' );
require_once( ABSPATH . 'wp-admin/includes/file.php' );
require_once( ABSPATH . 'wp-admin/includes/media.php' );

if ( $_SERVER['REQUEST_METHOD'] == 'POST' ) {
  $uploaded_file = $_FILES['your_image_field'];
  $upload_overrides = array( 'test_form' => false );

  $movefile = wp_handle_upload( $uploaded_file, $upload_overrides );

  if ( $movefile && ! isset( $movefile['error'] ) ) {
    echo "File is valid, and was successfully uploaded.\n";
    var_dump( $movefile);

    $filename = $movefile['file'];
    $wp_filetype = wp_check_filetype( basename( $filename ), null );
    $attachment = array(
        'post_mime_type' => $wp_filetype['type'],
        'post_title' => preg_replace('/\.[^.]+$/', '', basename( $filename )),
        'post_content' => '',
        'post_status' => 'inherit'
    );

    $attach_id = wp_insert_attachment( $attachment, $filename);
    require_once(ABSPATH . 'wp-admin/includes/image.php');
    $attach_data = wp_generate_attachment_metadata( $attach_id, $filename );
    wp_update_attachment_metadata( $attach_id,  $attach_data );

    // $attach_id 现在包含了附件的 ID，你可以将其存储在数据库中或用于其他用途
    echo "Attachment ID: " . $attach_id;


  } else {
    /**
     * Error generated. Possible error values:
     * 'file' - filename was empty.
     * 'upload_error' - PHP upload error.
     * 'http_error' - HTTP error.
     */
    echo "Possible errors: ";
    echo $movefile['error'];
  }
}

代码解释:

• require_once(): 引入必要的 WordPress 文件，用于处理图片上传和生成元数据。
• $_FILES['your_image_field']: 获取上传的文件信息，your_image_field 需要替换为你表单中文件上传字段的 name 属性。
• wp_handle_upload(): 处理上传的文件，将其移动到 WordPress 上传目录。
• wp_check_filetype(): 检查文件类型。
• wp_insert_attachment(): 将上传的文件作为附件插入到 WordPress 数据库。
• wp_generate_attachment_metadata(): 生成附件的元数据，包括不同尺寸的图片。
• wp_update_attachment_metadata(): 更新附件的元数据。

2. 生成不同尺寸的图片

wp_generate_attachment_metadata() 函数会自动根据 WordPress 中定义的图片尺寸生成不同版本的图片。这些尺寸可以在 WordPress 后台的“媒体” -> “设置”中进行配置，也可以通过 add_image_size() 函数在主题的 functions.php 文件中添加自定义尺寸。

add_image_size( 'my-custom-size', 200, 200, true ); // 添加一个名为 'my-custom-size' 的自定义尺寸，裁剪为 200x200

代码解释:

• add_image_size( $name, $width, $height, $crop ): 注册一个新的图片尺寸。
  • $name: 尺寸的名称。
  • $width: 宽度。
  • $height: 高度。
  • $crop: 是否裁剪图片。如果为 true，则裁剪图片以适应指定的尺寸。

3. 获取不同尺寸的图片

使用 wp_get_attachment_image() 函数可以获取指定尺寸的图片 URL。

$image_id = get_post_thumbnail_id( $post_id ); // 获取文章特色图像的 ID
$image_url = wp_get_attachment_image_src( $image_id, 'my-custom-size' ); // 获取 'my-custom-size' 尺寸的图片 URL

echo '';

代码解释:

• wp_get_attachment_image_src( $attachment_id, $size ): 获取指定附件的图片 URL。
  • $attachment_id: 附件的 ID。
  • $size: 图片尺寸的名称（例如，'thumbnail'、'medium'、'large'、'full' 或自定义尺寸）。

注意事项:

• 确保你的服务器配置允许上传大文件。
• 在使用 wp_handle_upload() 函数之前，需要引入必要的文件。
• 自定义图片尺寸需要在上传图片之前注册，否则不会生成对应尺寸的图片。
• 在生产环境中，需要对上传的文件进行安全验证，防止恶意文件上传。
• 使用 wp_get_attachment_image() 函数时，确保传入正确的附件 ID 和尺寸名称。

总结:

通过以上步骤，你可以在 WordPress 中通过编程方式上传一张图片，并自动生成多个不同尺寸的图片。这可以帮助你优化网站的图片管理流程，并提高网站的性能。请根据你的实际需求调整代码，并进行充分的测试。