MovieLog_Server/lib/helpers.php

<?php
// ============================================
// 文件: lib/helpers.php
// 说明: 通用工具函数（输出转义、文件名、颜色、上传文件读写、图片 URL）
// ============================================

// 允许上传的图片扩展名
function allowedImageExts() {
    return ['jpg', 'jpeg', 'png', 'gif', 'webp'];
}

// 安全输出
function h($str) {
    return htmlspecialchars($str, ENT_QUOTES, 'UTF-8');
}

// 生成唯一文件名
function uniqueFilename($original) {
    $ext = strtolower(pathinfo($original, PATHINFO_EXTENSION));
    if (!in_array($ext, allowedImageExts())) {
        $ext = 'jpg';
    }
    return date('YmdHis') . '_' . uniqid() . '.' . $ext;
}

// 校验并归一化十六进制颜色，非法值回退为灰色
function normalizeHexColor($color, $fallback = '#888888') {
    $color = trim((string)$color);
    return preg_match('/^#[a-fA-F0-9]{6}$/', $color) ? $color : $fallback;
}

// 删除项目内已存在的上传文件（文件不存在时静默跳过）
function deleteStoredFile($relative_path) {
    if (!empty($relative_path)) {
        $full = ROOT_DIR . '/' . $relative_path;
        if (file_exists($full)) {
            return unlink($full);
        }
    }
    return false;
}

// 处理单个图片上传字段，成功返回相对路径，失败返回 null
function uploadImageFile($field, $target_dir, $relative_prefix) {
    if (!isset($_FILES[$field]) || $_FILES[$field]['error'] !== UPLOAD_ERR_OK) {
        return null;
    }
    $ext = strtolower(pathinfo($_FILES[$field]['name'], PATHINFO_EXTENSION));
    if (!in_array($ext, allowedImageExts())) {
        return null;
    }
    $filename = uniqueFilename($_FILES[$field]['name']);
    if (!move_uploaded_file($_FILES[$field]['tmp_name'], $target_dir . $filename)) {
        return null;
    }
    return $relative_prefix . $filename;
}

// 处理多张图片上传字段（如 photos[] / new_photos[]），写入 movie_photos 表
function uploadMultiplePhotos($field, $movie_id) {
    if (!isset($_FILES[$field]) || !is_array($_FILES[$field]['tmp_name'])) {
        return;
    }
    $db = getDB();
    $files = $_FILES[$field];
    for ($i = 0; $i < count($files['tmp_name']); $i++) {
        if ($files['error'][$i] !== UPLOAD_ERR_OK) {
            continue;
        }
        $ext = strtolower(pathinfo($files['name'][$i], PATHINFO_EXTENSION));
        if (!in_array($ext, allowedImageExts())) {
            continue;
        }
        $filename = uniqueFilename($files['name'][$i]);
        if (!move_uploaded_file($files['tmp_name'][$i], PHOTO_DIR . $filename)) {
            continue;
        }
        $stmt = $db->prepare("INSERT INTO movie_photos (movie_id, photo_path) VALUES (?, ?)");
        $stmt->execute([$movie_id, 'uploads/photos/' . $filename]);
    }
}

// 海报 URL
function posterUrl($path) {
    if ($path && file_exists(ROOT_DIR . '/' . $path)) {
        return '/' . $path;
    }
    return '/assets/placeholder-poster.jpg';
}

// ===== 头像处理 =====
function getAvatarUrl($avatar_path, $name = '') {
    if ($avatar_path && file_exists(ROOT_DIR . '/' . $avatar_path)) {
        return '/' . $avatar_path;
    }
    if (!empty($name)) {
        $letter = mb_substr($name, 0, 1, 'UTF-8');
        $colors = ['#e74c3c','#e67e22','#f1c40f','#2ecc71','#3498db','#9b59b6','#1abc9c','#e84393','#00b894','#0984e3'];
        $color = $colors[abs(crc32($name)) % count($colors)];
        return "data:image/svg+xml," . urlencode("<svg xmlns='http://www.w3.org/2000/svg' width='40' height='40' viewBox='0 0 40 40'><rect width='40' height='40' fill='{$color}'/><text x='20' y='28' text-anchor='middle' font-size='20' fill='#fff' font-family='sans-serif' font-weight='bold'>{$letter}</text></svg>");
    }
    return '/assets/default-avatar.png';
}

// ===== 保存 Base64 图片 =====
function saveBase64Image($base64_data, $save_dir, $prefix = 'avatar') {
    if (strpos($base64_data, 'base64,') !== false) {
        $base64_data = substr($base64_data, strpos($base64_data, 'base64,') + 7);
    }
    $binary = base64_decode($base64_data);
    if ($binary === false) return false;

    $finfo = finfo_open(FILEINFO_MIME_TYPE);
    $mime = finfo_buffer($finfo, $binary);
    finfo_close($finfo);

    $ext_map = [
        'image/jpeg' => 'jpg',
        'image/png'  => 'png',
        'image/gif'  => 'gif',
        'image/webp' => 'webp'
    ];
    if (!isset($ext_map[$mime])) return false;
    $ext = $ext_map[$mime];

    $filename = date('YmdHis') . '_' . uniqid() . '_' . $prefix . '.' . $ext;
    $filepath = $save_dir . $filename;
    if (file_put_contents($filepath, $binary) === false) return false;

    return str_replace(ROOT_DIR . '/', '', $filepath);
}