CodeIgniter的Image Manipulation类允许您执行以下操作：

• 图像大小调整

• 缩略图创建

• 图像裁剪

• 图像旋转

• 图像水印

所有三个主要的图像库都支持：GD / GD2，NetPBM和ImageMagick

注意

水印只能使用GD / GD2库。另外，即使支持其他库，为了使脚本计算图像属性，GD也是必需的。但是，图像处理将在您指定的库中执行。

• 初始化类

• 处理图像

• 处理方法

• 优先

• 在配置文件中设置首选项

• 图像水印

• 文本首选项

• 覆盖首选项

• 两种类型的水印

• 为图像加水印

• 水印首选项

• 类参考

初始化类

像CodeIgniter中的大多数其他类一样，image类在您的控制器中使用$ this-> load-> library函数进行初始化：

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

一旦library被加载，它将准备好使用。您将用来调用所有函数的图像库对象是：$this->image_lib

处理图像

无论您想要执行的处理类型（调整大小，裁剪，旋转还是加水印），一般过程都是相同的。您将设置与您打算执行的操作相对应的某些首选项，然后调用四种可用处理函数之一。例如，要创建图像缩略图，您需要执行以下操作：

$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函数查找位于source_image文件夹中的名为mypic.jpg的图像，然后使用GD2 image_library创建一个75×50像素的缩略图。由于启用了maintain_ratio选项，拇指将尽可能接近目标宽度和高度，同时保留原始高宽比。缩略图将被称为mypic_thumb.jpg，并位于与source_image相同的级别。

注意

为了允许图像类进行任何处理，包含图像文件的文件夹必须具有写入权限。

注意

对于某些操作，图像处理可能需要大量的服务器内存。如果您在处理图像时遇到内存不足错误，则可能需要限制它们的最大尺寸，和/或调整PHP内存限制。

处理方法

有四种可用的处理方法：

• $这个 - > image_lib->调整（）

• $这个 - > image_lib->作物（）

• $这个 - > image_lib->旋转（）

• $这个 - > image_lib->水印（）

这些方法在成功时返回布尔值TRUE，在失败时返回FALSE。如果失败，您可以使用此功能检索错误消息：

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

一个好的做法是有条件地使用处理函数，在失败时显示错误，如下所示：

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

注意

您可以选择指定要应用于错误的HTML格式，方法是在函数中提交开始/结束标记，如下所示：

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

Preferences

下面介绍的首选项可让您调整图像处理以满足您的需求。

请注意，并非所有首选项都可用于每个功能。例如，x / y轴首选项仅适用于图像裁剪。同样，宽度和高度偏好对裁剪没有影响。“可用性”列指示哪些功能支持给定的偏好。

可用性图例：

• R  - 图像大小调整

• C  - 图像裁剪

• X  - 图像旋转

• W  - 图像水印

在配置文件中设置首选项

如果您不想使用上述方法设置首选项，则可以将它们放入配置文件中。只需创建一个名为image_lib.php的新文件，在该文件中添加$ config数组。然后将该文件保存在config / image_lib.php中，并自动使用它。如果将$this->image_lib->initialize()首选项保存在配置文件中，则不需要使用该方法。

图像水印

水印功能需要GD / GD2库。

两种类型的水印

您可以使用两种类型的水印：

• 文本：将使用文本生成水印消息，或者使用您指定的True Type字体，或使用GD库支持的原生文本输出。如果使用True Type版本，则必须使用True Type支持编译GD安装（大部分是，但不是全部）。

• 重叠：水印消息将通过在源图像上叠加包含水印的图像（通常是透明的PNG或GIF）来生成。

为图像加水印

与其他方法（调整大小，裁剪和旋转）一样，水印的一般处理过程包括设置与您打算执行的操作相对应的首选项，然后调用水印功能。这里是一个例子：

$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();

上面的例子将使用一个16像素的True Type字体来创建文本“Copyright 2006  -  John Doe”。水印将位于图像的底部/中心，距离图像底部20个像素。

注意

为了允许图像类进行任何处理，图像文件必须具有“写入”文件权限。例如，777。

水印首选项

此表显示可用于这两种类型的水印（文本或覆盖）

文本首选项

此表显示了可用于文本类型水印的首选项。

覆盖首选项

此表显示了可用于覆盖类型水印的首选项。

类参考

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

• $ props（array） - 图像处理首选项

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

Return type:  bool

Initializes the class for processing an image.

resize()

• 如果只指定了新的图像名称，它将被放置在与原始文件相同的文件夹中

• 如果仅指定了路径，则新图像将放置在与原始图像名称相同的目的地中。

• 如果指定了路径和图像名称，则它将放置在其自己的目的地，并给出新名称。

调整原始图像的大小

如果使用上面列出的两个首选项（create_thumb和new_image），则调整大小方法将改为将原始图像作为处理目标。

crop()

rotate()

1. 90  - 逆时针旋转90度。

2. 180  - 逆时针旋转180度。

3. 270  - 逆时针旋转270度。

4. hor  - 水平翻转图像。

5. vrt  - 垂直翻转图像。

以下是显示如何旋转图像的示例：

$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） - 错误信息开启标签

• $ close（string） - 错误信息关闭标签

Returns:  Error messages

Return type:  string

Returns all detected errors formatted as a string.

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