如何在 WordPress 中以编程方式上传多尺寸图片-php教程-PHP中文网

如何在 WordPress 中以编程方式上传多尺寸图片

花韻仙語

发布： 2025-11-02 11:06:35

原创

716人浏览过

如何在 wordpress 中以编程方式上传多尺寸图片

本文旨在提供一种在 WordPress 前端以编程方式上传图片并生成多个尺寸版本的解决方案。我们将探讨如何利用 WordPress 的内置函数和机制，高效地处理图片上传和尺寸生成，从而优化网站性能和用户体验。

利用 WordPress API 上传图片并生成多尺寸版本

WordPress 提供了强大的 API 来处理图片上传和管理。核心思路是先上传原始图片，然后利用 WordPress 的内置功能自动生成不同尺寸的版本。

1. 图片上传

首先，你需要处理前端上传的图片文件。这通常涉及到 HTML 表单和 PHP 脚本。

<form id="upload-form" enctype="multipart/form-data" method="post">
  <input type="file" name="uploaded_image" id="uploaded_image">
  <input type="submit" value="上传图片">
</form>

登录后复制

然后，在你的 PHP 代码中，处理上传的文件：

<?php
if ($_SERVER['REQUEST_METHOD'] == 'POST') {
    if (isset($_FILES['uploaded_image']) && $_FILES['uploaded_image']['error'] == 0) {
        $file = $_FILES['uploaded_image'];

        // 检查文件类型和大小 (可选，但强烈建议)
        $allowed_types = array('image/jpeg', 'image/png', 'image/gif');
        $max_size = 5 * 1024 * 1024; // 5MB

        if (!in_array($file['type'], $allowed_types)) {
            echo '错误：仅允许上传 JPEG, PNG, 和 GIF 图片。';
            exit;
        }

        if ($file['size'] > $max_size) {
            echo '错误：图片大小不能超过 5MB。';
            exit;
        }

        // 使用 WordPress 函数上传图片
        require_once(ABSPATH . 'wp-admin/includes/image.php');
        require_once(ABSPATH . 'wp-admin/includes/file.php');
        require_once(ABSPATH . 'wp-admin/includes/media.php');

        $attachment_id = media_handle_upload('uploaded_image', 0); // 0 表示不关联到任何文章

        if (is_wp_error($attachment_id)) {
            echo '错误：上传失败。' . $attachment_id->get_error_message();
            exit;
        } else {
            // 上传成功
            $attachment_url = wp_get_attachment_url($attachment_id);
            echo '图片上传成功！URL: ' . $attachment_url;

            //  可选: 保存附件 ID 到数据库，例如用户元数据
            // update_user_meta( get_current_user_id(), 'profile_image_id', $attachment_id );
        }
    } else {
        echo '错误：请选择要上传的图片。';
    }
}
?>

登录后复制

2. 生成多尺寸版本

WordPress 会自动生成一些预定义的图片尺寸（thumbnail, medium, large）。你也可以自定义尺寸。

自定义图片尺寸：

在你的 functions.php 文件中添加以下代码：

Cutout老照片上色
Cutout.Pro推出的黑白图片上色

20

查看详情
```
add_action( 'after_setup_theme', 'my_theme_setup' );
function my_theme_setup() {
    add_image_size( 'my-custom-size', 300, 200, true ); // 300px 宽, 200px 高, 裁剪
    add_image_size( 'my-other-size', 600, 400, false ); // 600px 宽, 400px 高, 不裁剪，保持比例
}
```
登录后复制
add_image_size() 函数接受四个参数：
- $name: 尺寸名称（唯一标识符）。
- $width: 宽度。
- $height: 高度。
- $crop: 是否裁剪。true 表示裁剪到指定尺寸，false 表示保持比例，可能会小于指定尺寸。
上传图片后，WordPress 会自动生成这些自定义尺寸的版本。

获取不同尺寸的图片：

使用 wp_get_attachment_image() 函数获取不同尺寸的图片。

$attachment_id = get_user_meta( get_current_user_id(), 'profile_image_id', true ); // 假设附件 ID 存储在用户元数据中

if ( $attachment_id ) {
    // 获取 thumbnail 尺寸的图片
    $thumbnail_image = wp_get_attachment_image( $attachment_id, 'thumbnail' );
    echo 'Thumbnail: ' . $thumbnail_image;

    // 获取自定义尺寸的图片
    $custom_image = wp_get_attachment_image( $attachment_id, 'my-custom-size' );
    echo 'Custom Size: ' . $custom_image;

    // 获取完整尺寸的图片
    $full_image = wp_get_attachment_image( $attachment_id, 'full' );
    echo 'Full Size: ' . $full_image;
}

登录后复制

3. 注意事项