Ueditor官方文档之上传路径配置
文档说明
支持版本：支持 UEditor 1.4.2+ 的版本
1.4.2+ 以后路径配置主要相关的配置项是 PathFormat 和 UrlPrefix 的配置项。
这两个配置项主要针对如下功能：
- 图片上传：imagePathFormat、imageUrlPrefix
- 涂鸦上传：scrawlPathFormat、scrawlUrlPrefix
- 截屏上传：snapscreenPathFormat、snapscreenUrlPrefix
- 附件上传：filePathFormat、fileUrlPrefix
- 视频上传：videoPathFormat、videoUrlPrefix
当前文档的例子是以 图片上传 为例介绍，其他配置方法类同。
imagePathFormat 介绍
作用：指定文件上传路径和返回路径，支持格式化
1.4.2+ 路径配置项无论是否以 "/" 开头，都是相对于 网站根目录 的路径。
例如，假设网站根目录是："D://apache/www/"，以下是 imagePathFormat 的配置值以及对应的存放目录。
"/upload/{filename}" --> "D://apache/www/upload/"
"upload/{filename}" --> "D://apache/www/upload/"
"./upload/{filename}" --> "D://apache/www/upload/"
"../upload/{filename}" --> "D://apache/upload/"
1 指定文件保存目录
上传路径可以使用根路径和相对路径，推荐使用根路径的配置。
1.1 使用 "/" 开头的根路径
imagePathFormat 参数推荐使用 "/" 开头的配置，这样的值指相对于网站根目录的位置。
例子：网站根目录是 "D://apache/www/"，imagePathFormat 参数设置为 "/upload/image/{filename}"，那么上传位置在 "D://apache/www/upload/image/" 目录下。
1.2 使用非 "/" 开头的相对路径
imagePathFormat 参数使用非 "/" 开头的相对路径时，上传位置也是相对于网站根目录（asp、.net例外，相对于应用程序的目录）。
例子1：网站根目录是 "D://apache/www/"，imagePathFormat 参数设置为 "ueditor/php/upload/{filename}"，那么上传位置在 "D://apache/www/ueditor/php/upload/" 目录下。
例子2：网站根目录是 "D://apache/www/"，imagePathFormat 参数设置为 "../upload/{filename}"，那么上传位置在 "D://apache/upload/" 目录下。
2 控制插入到编辑器的路径
2.1 后台返回路径
后台执行上传结束后，返回路径是按照 imagePathFormat 配置项替换后的字符串，原样输出到前端。
例子1：上传文件名为 123.jpg，imagePathFormat 参数设置为 "/ueditor/php/upload/{filename}"，那么返回路径是 "/ueditor/php/upload/123.jpg"。
例子2：上传文件名为 123.jpg，imagePathFormat 参数设置为 "../upload/{filename}"，那么返回路径是 "../upload/123.jpg"。
2.2 通过 imageUrlPrefix 配置项给返回路径添加前缀
有一些情况下仅仅靠返回路径是不能得到正常的图片链接，需要通过配置 imageUrlPrefix 给插入图片的路径添加前缀。
有两种情况下需要配置 imageUrlPrefix：
-
asp和.net下，应用程序目录不是网站根目录，需要给路径添加前缀。
-
在跨域上传的情况下，就需要配置imageUrlPrefix前缀。假设页面在 a.com 域下，文件上传到 b.com 域下，这样要配置 imageUrlPrefix 为 "http://b.com" 才能得到正常路径。
3 格式化上传路径和文件名
由于上传文件名容易冲突，编辑器提供了配置上传文件路径和文件名格式的方法，可以在 config.json 配置 imagePathFormat 项，后台上传文件会按照配置的格式命名。
3.1 格式化字符串的参数
{filename} //会替换成文件名 [要注意中文文件乱码问题] {rand:6} //会替换成随机数,后面的数字是随机数的位数 {time} //会替换成时间戳 {yyyy} //会替换成四位年份 {yy} //会替换成两位年份 {mm} //会替换成两位月份 {dd} //会替换成两位日期 {hh} //会替换成两位小时 {ii} //会替换成两位分钟 {ss} //会替换成两位秒
3.4 文件名冲突
当按照模板命名文件，依旧出现冲突，会直接覆盖同名文件，所以建议 imagePathFormat 使用时间戳和随机数来较少冲突。
3.5 非法字符
后台会过滤模板上的非法字符，非法字符列表如下，会替换成空：
\ : * ? " < > |
4 完整的使用例子
4.1 例子一
网站根目录是："D://apache/www/" 配置项 imagePathFormat 的值为：
imagePathFormat = "/ueditor/php/upload/image/{yyyy}-{mm}-{dd}_{rand:6}_{filename}"上传的文件名可能是这样：
"2014-06-13_712623_照片.jpg"存放的路径是：
D://apache/www/ueditor/php/upload/image
4.1 例子二
假设例子的情景如下：
网站根目录是："D://apache/www/"
上传文件名称是："123.jpg"
上传日期是：2014年06月13日
配置项 imagePathFormat 和 imageUrlPrefix 的值为：
imagePathFormat: "/ueditor/php/upload/image/{yyyy}{mm}{dd}/{time}{rand:6}",
imageUrlPrefix: "http://a.com"
那么上传结果可能是这样：
上传文件命名为 "1402637667260888888.jpg"
文件上传到 "D://apache/www/ueditor/php/upload/image/20140613/" 目录下
后端返回给前端的图片链接是:
"/ueditor/php/upload/image/20140613/402637667260888888.jpg"
插入到编辑器的图片链接是:
"http://a.com/ueditor/php/upload/image/20140613/402637667260888888.jpg"