PHPExcel 是一個功能相當完整的 PHP Excel 文檔處理類庫。當你需要輸出格式複雜的表格時,它是個不錯的選擇。除了寫入數據,它還能反向讀取——包括嵌入在工作表裡的圖片。
提取圖片主要會用到三個類:
· PHPExcel_Worksheet —— 代表一張工作表,透過 getDrawingCollection() 取得該表中的所有繪圖對象。
· PHPExcel_Worksheet_BaseDrawing —— 基礎繪圖對象,提供坐標與文件名的訪問方法。
· PHPExcel_Worksheet_MemoryDrawing —— 記憶體中的繪圖,需要透過渲染函數輸出為圖像數據。
<?php
require_once './Classes/PHPExcel.php';
$objPHPExcel = new PHPExcel();
$objReader = PHPExcel_IOFactory::createReader('Excel5'); // 加載 2003 格式
$objPHPExcel = $objReader->load("goods_list.xls"); // 載入文件
foreach ($objPHPExcel->getSheet(0)->getDrawingCollection() as $k => $drawing) {
$codata = $drawing->getCoordinates(); // 得到單元格坐標,例如 G2
$filename = $drawing->getIndexedFilename(); // 圖片文件名
ob_start();
call_user_func(
$drawing->getRenderingFunction(), // 渲染函數名
$drawing->getImageResource() // 圖片資源句柄
);
$imageContents = ob_get_contents();
// 以「坐標_文件名.jpg」為名保存到本地
file_put_contents('pic/' . $codata . '_' . $filename . '.jpg', $imageContents);
ob_end_clean();
}
?>
為什麼用 Excel5 而非 Excel2007。PHPExcel_IOFactory::createReader('Excel5') 指定的是 BIFF 格式的讀取器,對應 .xls 文件。若讀取的是 .xlsx,應改用 'Excel2007'。
為什麼要啟用輸出緩衝。渲染函數(通常是 imagejpeg、imagepng 這類 GD 庫函數)的工作方式是直接把二進位圖像數據寫入輸出流,而不是返回字符串。因此必須用 ob_start() 攔截輸出,再用 ob_get_contents() 取出,最後 ob_end_clean() 清空緩衝區,避免這些二進位內容污染頁面的 HTML 輸出。
命名為什麼要加坐標前綴。同一張表裡可能有多張圖片,文件名未必唯一。用 getCoordinates() 拿到的單元格位置(如 G2)做前綴,既能避免覆蓋,也保留了「圖片原本放在哪裡」的信息。
記得先建目錄。file_put_contents 不會自動創建上級目錄,若 pic/ 不存在會失敗,實務上應先判斷並 mkdir。
· 圖片格式判斷。示例一律存成 .jpg,但原圖可能是 PNG(帶透明通道)或 GIF。轉存成 JPEG 會丟失透明度並可能出現黑底。建議依實際 MIME 決定擴展名,或統一轉為 PNG 保存。
· 版本限制。該示例作者當時只能讀取 Excel 2003 格式,2007 及以上尚不支持。後續 PHPExcel 版本改進了這部分能力,但更推薦直接遷移到繼承者 PhpSpreadsheet—— PHPExcel 早已停止維護。
· 記憶體消耗。 PHPExcel / PhpSpreadsheet 在處理大文件時內存佔用相當可觀。若只是為了取出圖片,考慮直接解包 .xlsx(本質上是 zip),從 xl/media/ 目錄拿圖,再用 xl/drawings/ 下的 XML 對照錨點坐標,會快得多。
· 路徑安全。文件名來自文檔內容,若直接拼接進路徑存在目錄穿越風險(例如文件名含 ../)。保存前應做 basename() 過濾。