codeigniter 的 image_lib 智能裁剪需分两步：先按 master_dim 等比缩放至目标边撑满，再居中 crop；必须显式设 maintain_ratio=false、重置配置，并用缩放后实际尺寸计算裁剪坐标，否则易变形或无效。
image_lib 是 CodeIgniter 内置的图像处理类，不依赖第三方扩展就能完成裁剪、缩放、加水印等操作。但它的“智能裁剪”不是开箱即用的——必须手动控制缩放逻辑和裁剪坐标，否则容易拉伸变形或切掉主体。
为什么直接设 width 和 height 会变形？
image_lib 的 resize() 默认按“填充式缩放”理解：只要 maintain_ratio = TRUE，它就只保证比例不变，但最终尺寸未必等于你设的 width 和 height。如果你强制要求输出 240×240，又没控制主轴（master_dim），它可能缩成 240×180 或 160×240，留下黑边或空白——这不是 bug，是设计如此。
- 不设
master_dim时，CI 会自己选主轴，行为不可控 -
master_dim = 'auto'在旧版 CI 中无效，仅支持'width'、'height'、'orig' - 缩放后若尺寸仍大于目标，必须显式调用
crop()，不能指望resize()一步到位
怎么算居中裁剪的 x_axis 或 y_axis？
缩放后的图片尺寸 ≠ 原图尺寸 × 缩放比，而是由 master_dim 决定。所以计算裁剪起点时，得先知道缩放后的实际宽高。最稳妥的方式是：缩放后用 getimagesize() 重新读一次临时文件，再算偏移；但更轻量的做法是手推公式：
- 若按高度缩放（
master_dim = 'height'）：缩放后宽度 =$width * $target_height / $height，则x_axis = floor(($scaled_width - $target_width) / 2) - 若按宽度缩放（
master_dim = 'width'）：缩放后高度 =$height * $target_width / $width，则y_axis = floor(($scaled_height - $target_height) / 2) - 别直接用原图
$width/$height套公式——那是错的，必须代入缩放后的尺寸
crop() 前必须重置配置并关闭 maintain_ratio
crop() 不接受比例约束，一旦 maintain_ratio = TRUE，它会静默忽略 x_axis 和 y_axis，甚至返回成功但无效果。这是最容易踩的坑。
- 每次调用
resize()或crop()前，都必须调用$this->image_lib->initialize($config)重新载入配置 -
crop()配置里必须显式写'maintain_ratio' => FALSE，哪怕上一步刚设过 -
new_image路径要可写，且目录存在；否则crop()失败但不报错，只返回FALSE
完整流程示例（生成 240×240 居中裁剪图）
注意：所有路径需为服务器绝对路径或相对于 FCPATH 的相对路径，且 GD 库已启用。
$this->load->library('image_lib');
<p>$source = FCPATH . 'uploads/photo.jpg';
list($orig_w, $orig_h) = getimagesize($source);</p><p>// 第一步：等比缩放，以较短边为基准撑满 240
$config['image_library'] = 'gd2';
$config['source_image'] = $source;
$config['maintain_ratio'] = TRUE;
$config['width'] = 240;
$config['height'] = 240;</p><p>if ($orig_w >= $orig_h) {
$config['master_dim'] = 'height';
} else {
$config['master_dim'] = 'width';
}</p><p>$this->image_lib->initialize($config);
if (!$this->image_lib->resize()) {
echo $this->image_lib->display_errors();
return;
}</p><p>// 第二步：计算缩放后的真实尺寸（关键！）
$scaled_size = getimagesize($source);
$scaled_w = $scaled_size[0];
$scaled_h = $scaled_size[1];</p><p>$config['maintain_ratio'] = FALSE;
$config['x_axis'] = floor(($scaled_w - 240) / 2);
$config['y_axis'] = floor(($scaled_h - 240) / 2);
$config['width'] = 240;
$config['height'] = 240;
$config['new_image'] = FCPATH . 'uploads/photo_240x240.jpg';</p><p>$this->image_lib->initialize($config);
if (!$this->image_lib->crop()) {
echo $this->image_lib->display_errors();
}
</p>
真正麻烦的不是代码行数，而是每一步都要验证中间状态：缩放后尺寸对不对、临时文件是否存在、GD 是否真在运行。漏掉一次 initialize() 或写错一个 master_dim，结果就完全跑偏。
