萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 獲取圖片完整信息函數 getImageInfo() 封裝與優化

函數功能

封裝 getimagesize() 和 filesize(),返回圖片寬度、高度、類型(中文標識)、文件大小(KB)的關聯數組。

優化後代碼

<?php
/**
 * 獲取圖片詳細信息
 * @param string $imgPath 圖片文件絕對路徑
 * @return array|false 信息數組或 false (失敗)
 */
function getImageInfo($imgPath) {
    // 1. 文件存在性與可讀性檢查
    if (!is_file($imgPath) || !is_readable($imgPath)) {
        trigger_error("圖片文件不存在或不可讀: $imgPath", E_USER_WARNING);
        return false;
    }

    // 2. 獲取圖片尺寸與類型
    $imgInfo = @getimagesize($imgPath);
    if ($imgInfo === false) {
        trigger_error("無法解析圖片信息 (非圖片或損壞): $imgPath", E_USER_WARNING);
        return false;
    }

    // 3. 映射類型常量到中文
    $typeMap = [
        IMAGETYPE_GIF  => 'GIF圖像',
        IMAGETYPE_JPEG => 'JPEG圖像',
        IMAGETYPE_PNG  => 'PNG圖像',
        IMAGETYPE_WEBP => 'WEBP圖像',
        IMAGETYPE_BMP  => 'BMP圖像',
        // 可擴展更多類型...
    ];
    $imgType = $typeMap[$imgInfo[2]] ?? '未知類型(' . $imgInfo[2] . ')';

    // 4. 文件大小 (KB,向上取整)
    $sizeKb = ceil(filesize($imgPath) / 1024) . ' KB';

    // 5. 返回結構化數組
    return [
        'width'  => $imgInfo[0],
        'height' => $imgInfo[1],
        'type'   => $imgType,
        'mime'   => $imgInfo['mime'] ?? '', // getimagesize 返回數組包含 mime
        'size'   => $sizeKb,
        'path'   => $imgPath,
    ];
}

// 使用示例
$info = getImageInfo('/var/www/html/uploads/photo.jpg');
if ($info) {
    echo "寬度: {$info['width']}px<br>";
    echo "高度: {$info['height']}px<br>";
    echo "類型: {$info['type']}<br>";
    echo "MIME: {$info['mime']}<br>";
    echo "大小: {$info['size']}<br>";
} else {
    echo "獲取失敗";
}
?>

改進點說明

  1. 參數校驗:先判斷文件是否存在、可讀,避免後續函數報警告。
  2. 使用常量:用 IMAGETYPE_* 常量替代魔術數字 (1,2,3),可讀性強、擴展性好。
  3. 錯誤處理:使用 trigger_error 記錄警告,不中斷主流程,返回 false 供調用者判斷。
  4. 返回結構統一:包含寬高、類型、MIME、大小、路徑,方便前端直接使用。
  5. 單位規範:文件大小統一換算為 KB 並標註單位。
  6. 兼容性:支持 PHP 5.3+,新增 WEBP、BMP 等現代格式映射。

擴展建議

  • 增加 exif_read_data() 獲取 EXIF 信息(拍攝時間、相機型號、GPS 等)。
  • 增加圖片方向自動修正(根據 EXIF Orientation 旋轉)。
  • 對大文件使用流式讀取避免內存溢出(getimagesize 內部已優化)。
  • 集成到上傳組件中,上傳即時分析、生成縮略圖、提取主色調等。

結語

封裝原生函數、統一返回結構、完善錯誤處理,是編寫高質量工具函數的關鍵習慣。getImageInfo() 是處理圖片上傳、展示、處理流程的基礎組件。

copyright © 萬盛學電腦網 all rights reserved