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
###名词解释### 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 目录处理命令
- tsize 获取目录下所有文件大小字节数
###说明###
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 | 资源不存在 |
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent