PHP API中图像文件验证、处理与打包的实践指南

<?php
// 定义允许的MIME类型
const ALLOWED_MIME_TYPES = ['image/jpeg', 'image/png', 'image/gif'];

/**
 * 验证上传文件的真实MIME类型
 * @param string $filePath 上传文件的临时路径
 * @return bool 验证结果
 */
function validateMimeType(string $filePath): bool
{
    if (!file_exists($filePath)) {
        return false;
    }

    $finfo = finfo_open(FILEINFO_MIME_TYPE); // 获取MIME类型
    if (!$finfo) {
        // 错误处理，例如日志记录
        error_log("Failed to open fileinfo database.");
        return false;
    }

    $mimeType = finfo_file($finfo, $filePath);
    finfo_close($finfo);

    if (!in_array($mimeType, ALLOWED_MIME_TYPES)) {
        return false;
    }
    return true;
}

// 在API中使用
// $uploadedFileTmpPath = $_FILES['image']['tmp_name'];
// if (!validateMimeType($uploadedFileTmpPath)) {
//     $this->throwError(REQUEST_CONTENT_TYPE_NOT_VALID, '文件MIME类型无效。');
// }
?>

<?php
// 定义允许的文件扩展名
const ALLOWED_EXTENSIONS = ['jpg', 'jpeg', 'png', 'gif'];

/**
 * 验证文件扩展名
 * @param string $fileName 原始文件名
 * @return bool 验证结果
 */
function validateFileExtension(string $fileName): bool
{
    $ext = strtolower(pathinfo($fileName, PATHINFO_EXTENSION));
    return in_array($ext, ALLOWED_EXTENSIONS);
}

// 在API中使用
// $uploadedFileName = $_FILES['image']['name'];
// if (!validateFileExtension($uploadedFileName)) {
//     $this->throwError(INVALID_FILE_EXTENSION, '文件扩展名无效。');
// }
?>

<?php
// 定义最大文件大小（例如：5MB）
const MAX_FILE_SIZE = 5 * 1024 * 1024;

/**
 * 验证文件大小
 * @param string $filePath 上传文件的临时路径
 * @return bool 验证结果
 */
function validateFileSize(string $filePath): bool
{
    if (!file_exists($filePath)) {
        return false;
    }
    return filesize($filePath) <= MAX_FILE_SIZE;
}

// 在API中使用
// $uploadedFileTmpPath = $_FILES['image']['tmp_name'];
// if (!validateFileSize($uploadedFileTmpPath)) {
//     $this->throwError(FILE_TOO_LARGE, '文件大小超出限制。');
// }
?>

<?php
// ... (定义常量和验证函数)

class Api extends Rest
{
    public function validateRequest($requestData) // $requestData 应该是 $_FILES['image']
    {
        if (!isset($requestData['tmp_name']) || !is_uploaded_file($requestData['tmp_name'])) {
            $this->throwError(NO_FILE_UPLOADED, '未上传文件或上传失败。');
        }

        $uploadedFileTmpPath = $requestData['tmp_name'];
        $uploadedFileName = $requestData['name'];

        // 1. 文件大小验证
        if (!validateFileSize($uploadedFileTmpPath)) {
            $this->throwError(FILE_TOO_LARGE, '文件大小超出限制。');
        }

        // 2. 文件扩展名验证
        if (!validateFileExtension($uploadedFileName)) {
            $this->throwError(INVALID_FILE_EXTENSION, '文件扩展名无效，只允许JPG, PNG, GIF。');
        }

        // 3. MIME类型验证 (最重要)
        if (!validateMimeType($uploadedFileTmpPath)) {
            $this->throwError(REQUEST_CONTENT_TYPE_NOT_VALID, '文件MIME类型无效，只允许JPG, PNG, GIF。');
        }

        // 如果所有验证通过，可以将文件移动到指定位置
        // move_uploaded_file($uploadedFileTmpPath, '/path/to/your/uploads/' . $uploadedFileName);
        // ...
    }

    public function executeApi()
    {
        // 验证通过后，处理图像
        $source = $this->request['image']; // 这里应是已验证并移动到安全位置的文件路径
        $resize = new Resizer();
        $resize->imageResizer($source); // 假设 Resizer 类处理图像缩放
        // ...
    }
}
?>

<?php
/**
 * 将文件打包成ZIP文件
 * @param array $filesToZip 待打包文件的完整路径数组，格式为 ['/path/to/file1.jpg' => 'filename_in_zip1.jpg', ...]
 * @param string $outputZipPath 生成的ZIP文件的完整路径
 * @return bool 成功返回true，失败返回false
 */
function createZipArchive(array $filesToZip, string $outputZipPath): bool
{
    $zip = new ZipArchive();
    if ($zip->open($outputZipPath, ZipArchive::CREATE | ZipArchive::OVERWRITE) === TRUE) {
        foreach ($filesToZip as $filePath => $fileNameInZip) {
            if (file_exists($filePath)) {
                $zip->addFile($filePath, $fileNameInZip);
            } else {
                error_log("File not found for zipping: " . $filePath);
            }
        }
        $zip->close();
        return true;
    } else {
        error_log("Failed to create ZIP archive: " . $outputZipPath);
        return false;
    }
}

// 示例用法：
// 假设你已经有了不同尺寸的图片文件路径
$resizedImages = [
    '/path/to/uploads/image_thumb.jpg',
    '/path/to/uploads/image_medium.jpg',
    '/path/to/uploads/image_large.jpg',
];

$filesToZip = [];
foreach ($resizedImages as $imagePath) {
    $filesToZip[$imagePath] = basename($imagePath); // 使用原始文件名作为ZIP内的文件名
}

$outputZipFilePath = '/path/to/temp/images_package.zip';

if (createZipArchive($filesToZip, $outputZipFilePath)) {
    // ZIP文件创建成功，可以提供下载链接或直接发送文件
    // ...
} else {
    // 处理ZIP创建失败的情况
    // ...
}
?>

<?php
/**
 * 发送ZIP文件给客户端进行下载
 * @param string $zipFilePath ZIP文件的完整路径
 * @param string $downloadFileName 提供给用户的下载文件名
 */
function downloadZipFile(string $zipFilePath, string $downloadFileName): void
{
    if (file_exists($zipFilePath)) {
        header('Content-Type: application/zip');
        header('Content-Disposition: attachment; filename="' . $downloadFileName . '"');
        header('Content-Length: ' . filesize($zipFilePath));
        header('Pragma: no-cache');
        header('Expires: 0');
        readfile($zipFilePath);
        // 下载完成后，可以选择删除临时ZIP文件
        unlink($zipFilePath);
        exit();
    } else {
        // 文件不存在，抛出错误或返回错误响应
        // $this->throwError(FILE_NOT_FOUND, '请求的文件不存在。');
    }
}

// 在API的response方法中调用
// public function response() {
//     $zipFilePath = '/path/to/temp/images_package.zip';
//     $downloadFileName = 'resized_images.zip';
//     downloadZipFile($zipFilePath, $downloadFileName);
// }
?>

<?php
// 改进的 Rest 类构造函数示例
abstract class Rest
{
    public array $requestData = []; // 更改变量名以避免与$_REQUEST混淆
    public array $errors = [];

    public function __construct()
    {
        if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
            $this->throwError(REQUEST_METHODS_NOT_VALID, '请求方法无效，只允许POST。');
        }

        // 安全地处理 $_POST 数据
        foreach ($_POST as $key => $value) {
            // 示例：对所有POST数据进行HTML实体编码和去除空白
            $this->requestData[$key] = trim(htmlspecialchars($value, ENT_QUOTES, 'UTF-8'));
        }

        // 安全地处理 $_FILES 数据
        if (isset($_FILES['image'])) {
            $this->requestData['image'] = $_FILES['image'];
        } else {
            // 如果图片是必须的，可以在这里抛出错误
            // $this->throwError(NO_FILE_UPLOADED, '图片文件缺失。');
        }

        // 调用抽象方法进行具体的请求验证
        $this->validateRequest($this->requestData);

        if (empty($this->errors)){
            $this->executeApi();
        }
        $this->response();
    }

    // ... 其他方法
}
?>