PHP图像处理：如何正确压缩并上传图片，避免文件覆盖

// Compress image
function compressImage($source, $destination, $quality)
{
    $info = getimagesize($source);
    if ($info['mime'] == 'image/jpeg') $image = imagecreatefromjpeg($source);
    elseif ($info['mime'] == 'image/png') $image = imagecreatefrompng($source);
    imagejpeg($image, $destination, $quality); // 1. 压缩并保存图片到 $destination
}

compressImage($_FILES['file']['tmp_name'], $directoryName . $filename, 60); // 调用压缩函数

// Upload image
move_uploaded_file($_FILES['file']['tmp_name'], $directoryName . $filename); // 2. 移动原始未压缩文件到 $destination

<?php

// 错误报告设置，开发阶段建议开启
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

class PostController
{
    // 假设这些变量在实际应用中会通过路由或用户会话获取
    // 示例数据，实际项目中应从安全来源获取
    private $route_params = ['userid' => 123, 'postid' => 456];

    /**
     * 处理封面图片上传和压缩
     */
    public function addcoverimageAction()
    {
        if ($_SERVER['REQUEST_METHOD'] == 'POST') {
            // 1. 获取并清理用户ID和帖子ID
            // 对于$_POST数据，可以使用filter_input_array进行清理，但这里主要处理文件
            $userid = $this->route_params['userid'];
            $postid = $this->route_params['postid'];

            // 2. 文件上传基本检查
            if (!isset($_FILES['file']) || $_FILES['file']['error'] !== UPLOAD_ERR_OK) {
                // 处理上传错误，例如文件过大、部分上传、没有文件被上传等
                $errorMessages = [
                    UPLOAD_ERR_INI_SIZE   => '上传的文件超过了 php.ini 中 upload_max_filesize 选项限制的值。',
                    UPLOAD_ERR_FORM_SIZE  => '上传文件的大小超过了 HTML 表单中 MAX_FILE_SIZE 选项指定的值。',
                    UPLOAD_ERR_PARTIAL    => '文件只有部分被上传。',
                    UPLOAD_ERR_NO_FILE    => '没有文件被上传。',
                    UPLOAD_ERR_NO_TMP_DIR => '找不到临时文件夹。',
                    UPLOAD_ERR_CANT_WRITE => '文件写入失败。',
                    UPLOAD_ERR_EXTENSION  => 'PHP 扩展停止了文件上传。',
                ];
                $errorMessage = $errorMessages[$_FILES['file']['error']] ?? '未知文件上传错误。';
                error_log("文件上传失败，错误码：" . $_FILES['file']['error'] . " - " . $errorMessage);
                exit("文件上传失败：" . $errorMessage);
            }

            $fileTmpPath = $_FILES['file']['tmp_name']; // 临时文件路径
            $fileName = $_FILES['file']['name'];       // 原始文件名
            $fileExtension = strtolower(pathinfo($fileName, PATHINFO_EXTENSION)); // 文件扩展名

            // 3. 验证文件类型（安全关键步骤）
            // 仅允许图片类型，避免上传恶意文件
            $allowedExtensions = ['jpg', 'jpeg', 'png'];
            $allowedMimeTypes = ['image/jpeg', 'image/png'];

            $imageInfo = getimagesize($fileTmpPath); // 获取图像的真实信息
            if ($imageInfo === false) {
                exit("上传的不是有效的图片文件。");
            }
            $mimeType = $imageInfo['mime'];

            if (!in_array($fileExtension, $allowedExtensions) || !in_array($mimeType, $allowedMimeTypes)) {
                exit("不允许的文件类型。只允许 JPG, JPEG, PNG 格式的图片。");
            }

            // 4. 生成唯一文件名，防止文件名冲突和安全问题
            $newFileName = uniqid('cover_') . '_' . time() . '.' . $fileExtension;

            // 5. 定义目标目录
            $baseUploadDir = dirname(__DIR__) . "/images/$userid/listings/$postid/coverimage/";

            // 6. 检查并创建目录（使用更安全的权限0755）
            if (!is_dir($baseUploadDir)) {
                if (!mkdir($baseUploadDir, 0755, true)) { // 推荐使用0755权限
                    error_log("无法创建上传目录: " . $baseUploadDir);
                    exit("服务器无法创建上传目录。请联系管理员。");
                }
            }

            $destinationPath = $baseUploadDir . $newFileName; // 最终保存路径

            // 7. 图像压缩函数
            // 此函数现在更健壮，支持JPEG和PNG，并处理不同质量参数映射
            function compressImage(string $source, string $destination, int $quality = 75): bool
            {
                $info = getimagesize($source);
                if ($info === false) {
                    error_log("compressImage: 无法获取图像信息: " . $source);
                    return false;
                }

                $mime = $info['mime'];
                $image = null;
                $result = false;

                switch ($mime) {
                    case 'image/jpeg':
                        $image = imagecreatefromjpeg($source);
                        if ($image) {
                            $result = imagejpeg($image, $destination, $quality);
                        }
                        break;
                    case 'image/png':
                        $image = imagecreatefrompng($source);
                        if ($image) {
                            // 对于PNG，quality参数范围是0-9，0表示无压缩，9表示最大压缩。
                            // 这里将JPEG的1-100质量映射到PNG的0-9。
                            // 例如，quality=75 (JPEG标准) 映射到 (100-75)/10 = 2.5 -> 3 (PNG质量)
                            $pngQuality = round((100 - $quality) / 10);
                            $result = imagepng($image, $destination, max(0, min(9, $pngQuality)));
                        }
                        break;
                    // 如果需要支持GIF、WebP等，可在此处添加case
                    // case 'image/gif':
                    //     $image = imagecreatefromgif($source);
                    //     if ($image) {
                    //         $result = imagegif($image, $destination);
                    //     }
                    //     break;
                    default:
                        error_log("compressImage: 不支持的图像MIME类型: " . $mime);
                        return false;
                }

                if ($image === null) {
                    error_log("compressImage: 无法创建图像资源或不支持的MIME类型: " . $source);
                    return false;
                }

                imagedestroy($image); // 释放图像资源内存
                return $result;
            }

            // 8. 执行图像压缩和保存
            // 压缩质量设置为60
            if (compressImage($fileTmpPath, $destinationPath, 60)) {
                // 压缩成功，文件已保存到 $destinationPath
                // 此时不需要再调用 move_uploaded_file，因为 compressImage 已经完成了保存
                echo "图片压缩并上传成功！文件名: " . $newFileName;

                // 9.