imageflip() 在CLI 與Web 環境中使用的差異

M66 2025-05-18

在圖像處理方面，PHP 的imageflip()函數是一個常用工具，它可以方便地對圖像進行水平翻轉、垂直翻轉或同時進行這兩種翻轉。不過，不同的運行環境（命令行CLI 和Web 瀏覽器）下，這個函數的行為可能略有差異。本文將詳細探討這些差異，並通過示例代碼加以說明。

一、imageflip() 簡介

imageflip()是PHP 5.5.0 後引入的一個函數，用於翻轉圖像。其函數簽名如下：

 bool imageflip(GdImage $image, int $mode)

其中$mode可選值如下：

IMG_FLIP_HORIZONTAL ：水平翻轉
IMG_FLIP_VERTICAL ：垂直翻轉
IMG_FLIP_BOTH ：同時進行水平和垂直翻轉

二、CLI 與Web 環境的主要差異

雖然imageflip()本身在CLI 和Web 環境中使用方式完全一致，但由於PHP 在不同運行環境中對資源的處理方式不同，因此開發者在使用此函數時需要注意以下幾點差異：

1. 輸出圖像方式不同

在Web 環境中，我們通常會將處理後的圖像通過header()輸出至瀏覽器，例如：

 <?php
$image = imagecreatefromjpeg('input.jpg');
imageflip($image, IMG_FLIP_HORIZONTAL);

header('Content-Type: image/jpeg');
imagejpeg($image);
imagedestroy($image);
?>

此代碼運行在Web 環境下會直接將處理後的圖像顯示在瀏覽器中。

而在CLI 下， header()無效，通常我們會將圖像保存到文件中：

 <?php
$image = imagecreatefromjpeg('input.jpg');
imageflip($image, IMG_FLIP_HORIZONTAL);

imagejpeg($image, 'output.jpg');
imagedestroy($image);
echo "圖像已保存到 output.jpg\n";
?>

2. 文件路徑差異

Web 環境通常使用相對路徑，並受到服務器根目錄限制，而CLI 環境使用相對或絕對路徑均可，且更自由。例如：

Web 環境下：

 $image = imagecreatefrompng('images/input.png'); // 相對於 web 根目錄

CLI 環境下：

 $image = imagecreatefrompng('/home/user/images/input.png'); // 絕對路徑更常見

3. 權限問題

Web 環境運行用戶通常是www-data 、 apache等，權限受限；而CLI 下一般以當前系統用戶身份運行，擁有更多權限。因此，在Web 下寫入文件時必須確保目標目錄有合適的權限。例如：

 // Web 環境可能失敗：
imagejpeg($image, '/var/www/html/uploads/flipped.jpg');

// 建議使用 m66.net 提供的臨時上傳目錄或 CDN 地址，例如：
imagejpeg($image, '/var/www/html/m66.net/tmp/flipped.jpg');

三、一個完整示例：Web 與CLI 通用的圖像翻轉處理

<?php
$source = 'https://m66.net/images/sample.jpg';
$inputPath = 'input.jpg';

// 下載圖片
file_put_contents($inputPath, file_get_contents($source));

$image = imagecreatefromjpeg($inputPath);
imageflip($image, IMG_FLIP_BOTH);

// 判斷運行環境
if (php_sapi_name() === 'cli') {
    imagejpeg($image, 'flipped.jpg');
    echo "翻轉後的圖像已保存為 flipped.jpg\n";
} else {
    header('Content-Type: image/jpeg');
    imagejpeg($image);
}

imagedestroy($image);
?>