nimg

a high performance image storage and processing module written by nodejs

ofpay

111

JavaScript

Nimg

NImg 是基于ZImg的nodejs实现。

去掉了ZImg中 memcached的缓存功能，图片上传处理接口使用json数据格式。不兼容ZImg的文件存储。

环境要求：

操作系统：任何能安装 nodejs 的操作系统
node版本：>=v0.10
ImageMagick版本：>=6.8.7
python版本:>=2.6

##使用##

– 使用前确保node环境及ImageMagick已安装好

#下载NImg

 wget  https://github.com/ofpay/nimg/archive/master.zip -O nimg.zip

#解压

uzip nimg.zip

#安装依赖模组

cd nimg-master
npm install

#修改配置,确保图片存储及上传目录有足够的权限

vi config.js

exports.tmproot='/node/temp'; //上传临时目录，
exports.imgroot='/node/img'; //图片存储目录，
exports.errorlog='/node/log/error.log'; //程序错误日志，记录
exports.port=9000;  //http端口号
exports.appname='NImg';
exports.maxFileSize=1024*1024;//上传最大限制单位字节 1024kb 1mb
exports.maxSide=800; //最大截图边长
exports.minSide=30; //最小截图边长

//支持图像文件类型
exports.imgtypes={
        "gif": "image/gif",
        "jpeg": "image/jpeg",
        "jpg": "image/jpeg",
        "png": "image/png"
};

#启动

sh nimg.sh start

#查看控制台输出

tailf nohup.out

#关闭

sh nimg.sh stop

api

###名词解释###
userpath 用户目录，NImg支持多用户系统，使用userpath来区分用户目录

md5 根据图片信息得到md5值

t 图像类型，Nimg支持的目前有4种： jpg|jpeg|png|gif

w 图像宽度

h 图像高度

url 图像访问路径，上传时由接口返回

原图url：{userpath}/{md5}.{t} or {userpath}/{md5}-0-0.{t}
等比例缩放图url: {userpath}/{md5}-{w}-{h}.{t}
强制缩放图url: {userpath}/{md5}-{w}-{h}-f.{t}
根据高边等比例缩放url: {userpath}/{md5}-0-{h}-s.{t}
根据宽边等比例缩放url: {userpath}/{md5}-{w}-0-s.{t}

act 图像处理命令

del 删除图像,不需要参数
tleft 左旋90度
tright 右旋90度
resize 缩放，注意：此操作是对当前资源做出修改，不生成新文件
info 返回图片信息，高度，宽度，图片大小

param 命令参数

调用resize时，需要. 等比例缩放示例: 500X500 强制缩放:500X500!

act 目录处理命令

###说明###

1.图片访问地址限制：无

调用地址： http://nimg/{url}

method:get

返回：图像文件

2.上传api 限制：内网调用

调用地址： http://nimg/{userpath}/upload

可选参数：act(图像预处理),param(预处理参数)

示例：

裁图：
act=crop
param=wxh+x+y 例如：151x189+174+0

缩图：
act=resize
param=wxh[!] 例如：100x100(等比例) 200x200！（强制）

旋转：
act=rotate
param=[-]r 例如：90 (右旋90度) -50(左旋50度)

method:post

成功返回

    {
        "code": 200,
        "msg": "upload success!",
        "data": {
            "t": "gif",
            "userpath": "01",
            "md5": "d6da9ccfcf52211eba99722207ee3d9a",
            "url": "01/d6da9ccfcf52211eba99722207ee3d9a.gif"
        }
    }

失败返回

    {
      "code": 300,
      "msg": "filetype error,not supported txt"
    }

3.图像处理api 限制：内网调用

调用地址：http://nimg/{url}/manage-{act}?a={param}

method:get

成功返回

    {
      "code": 200,
      "msg": "exec ok!"
    }

失败返回

    {
      "code": 301,
      "msg": "exec fail"
    }

4.目录管理api 限制：内网调用

调用地址：http://nimg/{userpath}/{act}

调用示例：http://192.168.111.189:9000/854899/tsize

成功返回

    {

        "code": 200,
        "msg": "success!",
        "data": {
            "userpath": "854899",
            "total": 32515395
        }

    }

###api错误代码对照表###

编码	说明
200	操作成功
300	上传错误
301	处理错误
404	资源不存在