PHP图片压缩失效：常见原因与正确实现教程

<?php

/**
 * 压缩图片并保存到指定目标
 *
 * @param string $source      源图片路径 (通常是 $_FILES['file']['tmp_name'])
 * @param string $destination 目标保存路径
 * @param int    $quality     图片质量 (0-100, 仅对JPEG有效)
 * @return bool               成功返回 true，失败返回 false
 */
function compressImage(string $source, string $destination, int $quality): bool
{
    $info = getimagesize($source);

    if ($info === false) {
        // 无法获取图片信息，可能不是有效的图片文件
        return false;
    }

    $image = null;
    switch ($info['mime']) {
        case 'image/jpeg':
            $image = imagecreatefromjpeg($source);
            break;
        case 'image/png':
            $image = imagecreatefrompng($source);
            // PNG压缩质量通常是0-9，imagejpeg的质量参数在此不适用，
            // 但imagepng有自己的质量参数，0为无压缩，9为最大压缩。
            // 这里为了通用性，如果需要对PNG进行精细控制，需要单独处理。
            // 简单处理可以保持默认，或者使用 imagealphablending 和 imagesavealpha
            break;
        case 'image/gif':
            $image = imagecreatefromgif($source);
            break;
        // 可以根据需要添加其他格式，如 WebP
        // case 'image/webp':
        //     $image = imagecreatefromwebp($source);
        //     break;
        default:
            // 不支持的图片类型
            return false;
    }

    if ($image === null) {
        return false;
    }

    // 根据目标文件类型保存图片
    $extension = strtolower(pathinfo($destination, PATHINFO_EXTENSION));
    $result = false;
    switch ($extension) {
        case 'jpeg':
        case 'jpg':
            $result = imagejpeg($image, $destination, $quality);
            break;
        case 'png':
            // PNG 质量参数范围是 0-9，其中 0 表示不压缩，9 表示最大压缩。
            // imagejpeg 的质量参数 0-100 在这里需要转换。
            // 例如，将 60% 质量转换为 PNG 质量 (100 - quality) / 100 * 9
            $pngQuality = (int) round((100 - $quality) / 100 * 9);
            $result = imagepng($image, $destination, $pngQuality);
            break;
        case 'gif':
            $result = imagegif($image, $destination);
            break;
        // case 'webp':
        //     $result = imagewebp($image, $destination, $quality);
        //     break;
        default:
            // 不支持的目标保存格式
            imagedestroy($image);
            return false;
    }

    imagedestroy($image); // 释放内存
    return $result;
}

class PostController
{
    public function addcoverimageAction()
    {
        if ($_SERVER['REQUEST_METHOD'] == 'POST') {
            // 1. 数据安全过滤
            $_POST = filter_input_array(INPUT_POST, FILTER_SANITIZE_STRING);

            $userid = $this->route_params['userid'];
            $postid = $this->route_params['postid'];

            // 2. 文件上传检查
            if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
                // 处理文件上传错误
                // 例如：echo "文件上传失败，错误码：" . $_FILES['file']['error'];
                return;
            }

            // 3. 生成唯一文件名和目标路径
            $path_parts = pathinfo($_FILES['file']['name']);
            $extension = strtolower($path_parts['extension']); // 统一小写扩展名
            $filename = uniqid('cover_', true) . '.' . $extension; // 更安全的唯一文件名生成方式

            $directoryName = dirname(__DIR__) . "/images/$userid/listings/$postid/coverimage/";

            // 4. 检查并创建目录
            if (!is_dir($directoryName)) {
                if (!mkdir($directoryName, 0777, true)) {
                    // 目录创建失败
                    // 例如：echo "无法创建目录: $directoryName";
                    return;
                }
            }

            $destinationPath = $directoryName . $filename;

            // 5. 压缩并保存图片
            // 假设我们希望压缩到JPEG格式，即使原始是PNG，也可以转换为JPEG
            // 或者根据原始图片类型保存为相同类型
            $compressionQuality = 75; // 压缩质量，0-100

            // 建议：如果希望统一输出格式，例如全部输出为JPEG，可以在这里指定新的扩展名
            // $newFilename = uniqid('cover_', true) . '.jpg';
            // $newDestinationPath = $directoryName . $newFilename;
            // $compressionResult = compressImage($_FILES['file']['tmp_name'], $newDestinationPath, $compressionQuality);

            // 如果保持原格式压缩：
            $compressionResult = compressImage($_FILES['file']['tmp_name'], $destinationPath, $compressionQuality);

            if ($compressionResult) {
                // 压缩成功，更新数据库
                // Post::updateCoverimage($filename, $postid); // 使用 $filename 或 $newFilename
                echo "图片压缩并上传成功！";
            } else {
                // 压缩失败
                // 例如：echo "图片压缩失败！";
            }

            // ！！！注意：这里不再需要 move_uploaded_file()
            // move_uploaded_file($_FILES['file']['tmp_name'], $directoryName . $filename);
        }

        // 示例：获取帖子信息，根据实际需求调整
        // $this->post = Post::findByID($postid);
    }
}