codeigniter图片上传与缩放需严格使用绝对路径（如fcpath.'uploads/'）、确保写权限，image_lib必须基于上传后的full_path操作，resize后crop，gd处理png需手动开启alpha支持。
CodeIgniter 上传图片时 upload_path 权限和路径写法必须严格匹配
上传失败最常见的原因是路径不可写或路径拼接错误。CodeIgniter 的 upload_path 必须是服务器上的绝对路径（不是 URL），且 PHP 进程有写权限。比如你设成 ./uploads/，实际可能解析为 CLI 当前目录而非 Web 根目录；正确写法应是 FCPATH . 'uploads/'（FCPATH 是 CodeIgniter 定义的常量，指向 index.php 所在目录）。
常见错误现象：Unable to write file to disk 或上传后返回空数组。
- 确认目录存在：
mkdir -p uploads并chmod 755 uploads（Linux）或确保 IIS/PHP-FPM 用户有写权限（Windows） - 不要用
base_url() . '/uploads/'—— 这是 URL，upload_path只接受服务器文件系统路径 - 路径末尾必须带斜杠：
FCPATH . 'uploads/'，不带会报错 - 如果用子目录（如
uploads/avatar/），需提前创建好完整路径，CodeIgniter 不会自动递归建目录
用 image_lib 缩放图片前必须先上传成功并获取真实文件路径
image_lib 不接受 URL 或临时文件名，只处理磁盘上已存在的图片。所以不能在 do_upload() 之前就初始化缩放配置，也不能传 $_FILES['userfile']['tmp_name'] 给它 —— 它需要的是 upload_path + file_name 拼出的完整路径。
典型误操作：上传配置里开了 encrypt_name，但缩放时还硬写死原文件名，导致找不到源图。
- 上传成功后，从
$this->upload->data()中取full_path字段，直接传给image_lib的source_image - 若要生成多个尺寸，建议先上传原图，再用
full_path作为源，分别配置new_image指向不同目标路径 -
width和height至少填一个；若两个都填，CodeIgniter 默认等比缩放（除非设maintain_ratio = FALSE） - 缩放失败时检查
$this->image_lib->display_errors()，常见报错：Source image does not exist（路径错）、Unable to open source image（GD 扩展未启用或不支持该格式）
resize 和 crop 的执行顺序与参数陷阱
CodeIgniter 的 image_lib 不支持链式调用，resize() 和 crop() 必须分两次初始化、两次执行。而且 crop 的坐标和尺寸是相对于当前图像（即 resize 后的图像），不是原始图。
例如：原图 2000×1500，想缩到 400×300 再居中裁切 300×300 正方形 —— 如果先 crop 再 resize，结果完全不对。
- 务必先
resize到目标宽高上限，再crop；否则crop参数容易越界 -
crop的x_axis/y_axis是左上角起点，不是中心点；居中裁切需手动算：x = (resized_width - crop_width) / 2 - 如果
maintain_ratio = TRUE且只设width = 300，缩放后高度可能是 225，此时若 crop 300×300 就会失败（高度不够） - 缩放后图像尺寸可通过
$this->image_lib->get_image_properties($path)获取，用于动态计算 crop 坐标
GD 库限制和 PNG 透明通道丢失问题
CodeIgniter 默认用 GD 处理图像，但 GD 对 PNG 的 alpha 通道支持不稳定：缩放或裁切后常变成黑底。这不是框架 bug，而是 GD 在保存 PNG 时默认关闭了透明保留。
解决方法必须显式开启，且顺序不能错：先 imagealphablending 关闭混合，再 imagesavealpha 开启保存 alpha。
- 仅靠 CodeIgniter 配置无法修复，需在
image_lib执行前插入原生 GD 操作（通过create_thumb或自定义函数） - 更稳妥的做法：改用 ImageMagick（需服务器安装并启用
imagick扩展），在配置中设library_path = '/usr/bin/'并image_library = 'imagemagick' - 测试是否支持：运行
php -m | grep gd确认 GD 加载；用gd_info()查看png_support是否为 true - JPEG 质量控制用
quality参数（1–100），但对 PNG 无效；PNG 无质量概念，只有压缩级别（CodeIgniter 不暴露该参数）
真正麻烦的是多尺寸+透明 PNG 场景——这时候要么自己封装 GD 调用，要么换库。别指望 image_lib 自动搞定。
