CodeIgniter的Image Manipulation類允許您執(zhí)行以下操作：

• 圖像大小調(diào)整

• 縮略圖創(chuàng)建

• 圖像裁剪

• 圖像旋轉(zhuǎn)

• 圖像水印

所有三個(gè)主要的圖像庫都支持：GD / GD2，NetPBM和ImageMagick

注意

水印只能使用GD / GD2庫。另外，即使支持其他庫，為了使腳本計(jì)算圖像屬性，GD也是必需的。但是，圖像處理將在您指定的庫中執(zhí)行。

• 初始化類

• 處理圖像

• 處理方法

• 優(yōu)先

• 在配置文件中設(shè)置首選項(xiàng)

• 圖像水印

• 文本首選項(xiàng)

• 覆蓋首選項(xiàng)

• 兩種類型的水印

• 為圖像加水印

• 水印首選項(xiàng)

• 類參考

初始化類

像CodeIgniter中的大多數(shù)其他類一樣，image類在您的控制器中使用$ this-> load-> library函數(shù)進(jìn)行初始化：

$this->load->library('image_lib');

一旦library被加載，它將準(zhǔn)備好使用。您將用來調(diào)用所有函數(shù)的圖像庫對象是：$this->image_lib

處理圖像

無論您想要執(zhí)行的處理類型（調(diào)整大小，裁剪，旋轉(zhuǎn)還是加水?。?，一般過程都是相同的。您將設(shè)置與您打算執(zhí)行的操作相對應(yīng)的某些首選項(xiàng)，然后調(diào)用四種可用處理函數(shù)之一。例如，要?jiǎng)?chuàng)建圖像縮略圖，您需要執(zhí)行以下操作：

$config['image_library'] = 'gd2';$config['source_image'] = '/path/to/image/mypic.jpg';$config['create_thumb'] = TRUE;$config['maintain_ratio'] = TRUE;$config['width']         = 75;$config['height']       = 50;$this->load->library('image_lib', $config);$this->image_lib->resize();

上面的代碼告訴image_resize函數(shù)查找位于source_image文件夾中的名為mypic.jpg的圖像，然后使用GD2 image_library創(chuàng)建一個(gè)75×50像素的縮略圖。由于啟用了maintain_ratio選項(xiàng)，拇指將盡可能接近目標(biāo)寬度和高度，同時(shí)保留原始高寬比。縮略圖將被稱為mypic_thumb.jpg，并位于與source_image相同的級別。

注意

為了允許圖像類進(jìn)行任何處理，包含圖像文件的文件夾必須具有寫入權(quán)限。

注意

對于某些操作，圖像處理可能需要大量的服務(wù)器內(nèi)存。如果您在處理圖像時(shí)遇到內(nèi)存不足錯(cuò)誤，則可能需要限制它們的最大尺寸，和/或調(diào)整PHP內(nèi)存限制。

處理方法

有四種可用的處理方法：

• $這個(gè) - > image_lib->調(diào)整（）

• $這個(gè) - > image_lib->作物（）

• $這個(gè) - > image_lib->旋轉(zhuǎn)（）

• $這個(gè) - > image_lib->水?。ǎ?/p>

這些方法在成功時(shí)返回布爾值TRUE，在失敗時(shí)返回FALSE。如果失敗，您可以使用此功能檢索錯(cuò)誤消息：

echo $this->image_lib->display_errors();

一個(gè)好的做法是有條件地使用處理函數(shù)，在失敗時(shí)顯示錯(cuò)誤，如下所示：

if ( ! $this->image_lib->resize()){
        echo $this->image_lib->display_errors();}

注意

您可以選擇指定要應(yīng)用于錯(cuò)誤的HTML格式，方法是在函數(shù)中提交開始/結(jié)束標(biāo)記，如下所示：

$this->image_lib->display_errors('<p>', '</p>');

Preferences

下面介紹的首選項(xiàng)可讓您調(diào)整圖像處理以滿足您的需求。

請注意，并非所有首選項(xiàng)都可用于每個(gè)功能。例如，x / y軸首選項(xiàng)僅適用于圖像裁剪。同樣，寬度和高度偏好對裁剪沒有影響?！翱捎眯浴绷兄甘灸男┕δ苤С纸o定的偏好。

可用性圖例：

• R  - 圖像大小調(diào)整

• C  - 圖像裁剪

• X  - 圖像旋轉(zhuǎn)

• W  - 圖像水印

在配置文件中設(shè)置首選項(xiàng)

如果您不想使用上述方法設(shè)置首選項(xiàng)，則可以將它們放入配置文件中。只需創(chuàng)建一個(gè)名為image_lib.php的新文件，在該文件中添加$ config數(shù)組。然后將該文件保存在config / image_lib.php中，并自動(dòng)使用它。如果將$this->image_lib->initialize()首選項(xiàng)保存在配置文件中，則不需要使用該方法。

圖像水印

水印功能需要GD / GD2庫。

兩種類型的水印

您可以使用兩種類型的水?。?/p>

• 文本：將使用文本生成水印消息，或者使用您指定的True Type字體，或使用GD庫支持的原生文本輸出。如果使用True Type版本，則必須使用True Type支持編譯GD安裝（大部分是，但不是全部）。

• 重疊：水印消息將通過在源圖像上疊加包含水印的圖像（通常是透明的PNG或GIF）來生成。

為圖像加水印

與其他方法（調(diào)整大小，裁剪和旋轉(zhuǎn)）一樣，水印的一般處理過程包括設(shè)置與您打算執(zhí)行的操作相對應(yīng)的首選項(xiàng)，然后調(diào)用水印功能。這里是一個(gè)例子：

$config['source_image'] = '/path/to/image/mypic.jpg';$config['wm_text'] = 'Copyright 2006 - John Doe';$config['wm_type'] = 'text';$config['wm_font_path'] = './system/fonts/texb.ttf';$config['wm_font_size'] = '16';$config['wm_font_color'] = 'ffffff';$config['wm_vrt_alignment'] = 'bottom';$config['wm_hor_alignment'] = 'center';$config['wm_padding'] = '20';$this->image_lib->initialize($config);$this->image_lib->watermark();

上面的例子將使用一個(gè)16像素的True Type字體來創(chuàng)建文本“Copyright 2006  -  John Doe”。水印將位于圖像的底部/中心，距離圖像底部20個(gè)像素。

注意

為了允許圖像類進(jìn)行任何處理，圖像文件必須具有“寫入”文件權(quán)限。例如，777。

水印首選項(xiàng)

此表顯示可用于這兩種類型的水?。ㄎ谋净蚋采w）

文本首選項(xiàng)

此表顯示了可用于文本類型水印的首選項(xiàng)。

覆蓋首選項(xiàng)

此表顯示了可用于覆蓋類型水印的首選項(xiàng)。

類參考

class CI_Image_libinitialize([$props = array()])

• $ props（array） - 圖像處理首選項(xiàng)

Returns:  TRUE on success, FALSE in case of invalid settings

Return type:  bool

Initializes the class for processing an image.

resize()

• 如果只指定了新的圖像名稱，它將被放置在與原始文件相同的文件夾中

• 如果僅指定了路徑，則新圖像將放置在與原始圖像名稱相同的目的地中。

• 如果指定了路徑和圖像名稱，則它將放置在其自己的目的地，并給出新名稱。

調(diào)整原始圖像的大小

如果使用上面列出的兩個(gè)首選項(xiàng)（create_thumb和new_image），則調(diào)整大小方法將改為將原始圖像作為處理目標(biāo)。

crop()

rotate()

1. 90  - 逆時(shí)針旋轉(zhuǎn)90度。

2. 180  - 逆時(shí)針旋轉(zhuǎn)180度。

3. 270  - 逆時(shí)針旋轉(zhuǎn)270度。

4. hor  - 水平翻轉(zhuǎn)圖像。

5. vrt  - 垂直翻轉(zhuǎn)圖像。

以下是顯示如何旋轉(zhuǎn)圖像的示例：

$config'image_library' = 'netpbm'; $config'library_path' = '/usr/bin/'; $config'source_image' = '/path/to/image/mypic.jpg'; $config'rotation_angle' = 'hor';  $this->image_lib->initialize($config);  if ( ! $this->image_lib->rotate()) {         echo $this->image_lib->display_errors(); }

watermark()

clear()

display_errors([$open = '<p>[, $close = '</p>']])

• $ open（string） - 錯(cuò)誤信息開啟標(biāo)簽

• $ close（string） - 錯(cuò)誤信息關(guān)閉標(biāo)簽

Returns:  Error messages

Return type:  string

Returns all detected errors formatted as a string.

echo $this->image_lib->display_errors();