UEditor ASP.NET 后台使用说明
=====
## 背景
UEditor 在 1.4 版本之后进行了一次[前后端统一配置](../_doc/3.1 后端请求规范.md)的整理,.Net 的后台也进行了一次重写,跟之前的版本差别较大,升级的用户注意阅读本文档。
本文档介绍 UEditor ASP.NET 后台的部署、配置、源码说明。
## 1. 部署说明
### 1.1. 安装并注册 .NET Framework 4.0
代码的运行时环境是 .NET Framework 4.0,首先要确认 IIS 已经安装了 .NET 4.0 的运行时框架。方法是打开「IIS 管理器」,选择根目录下的「应用程序池」,在右侧查看是否有一个应用程序池的版本是 v4.0,如果存在,则 IIS 已经安装了所需的运行时环境,此时读者可以跳过本节。
![检查 .NET 4.0 安装情况](../_doc/images/net-publish-1.png)
如果没有找到对应的应用程序池,需要手动安装。
Windows 7 和 Windows Server 2008 R2 默认安装了 .Net Framework 4.0,如果是 Server 03 和老掉牙的 Windows XP,则需要手动安装 [.NET Framework 4.0](http://www.microsoft.com/zh-cn/download/details.aspx?id=17718)。
安装完 .NET Framework 4.0 后,还需要向 IIS 注册应用程序池,注册的方法是,使用**管理员权限**打开命令提示符(CMD),输入以下命令:
```shell
C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -i
```
安装完毕后,在 IIS 管理器刷新就能看到 4.0 的应用程序池。
### 1.2. 设置 .NET 应用程序
代码要求以应用程序的形式来运行(可以方便加入库依赖和组织代码)。需要把 `net` 目录转换为应用程序。
1. 在 IIS 中,展开到 `ueditor/net` 目录,在目录上右击,点击「转换为应用程序」。
![转换为应用程序](../_doc/images/net-publish-2.png)
2. 弹出的对话框中,点击「选择...」来指定使用的应用程序池。选择版本为 4.0 的应用程序池,然后点确定。
![选择应用程序池](../_doc/images/net-publish-3.png)
3. 设置连接凭据。点击「链接为...」按钮,在弹出的对话框中指定一个对目录具有读写权限的用户(如 administrator),然后点确定。
![设置连接凭据](../_doc/images/net-publish-4.png)
设置完毕后,可以点击「测试设置...」来测试权限是否正常。
![设置连接凭据](../_doc/images/net-publish-5.png)
### 1.3. 运行测试
在浏览器中运行 `net/controller.ashx`,如果返回 "`{"state":"action 参数为空或者 action 不被支持。"}`",则表示应用程序运行成功。
如果你确认上述步骤已经执行,但是依然有问题,请给我们[提 Issue](https://github.com/fex-team/ueditor/issues/new?labels=NET%E5%90%8E%E5%8F%B0),我们会尽快答复解决。
## 2. 配置说明
前后端配置统一之后,配置文件由后台读取,返回给前端。但是部分配置是给后台使用的。
### 2.1. 上传配置说明
关于上传的部分,后台需要关心以下模板的配置项。
```json
{
"{tpl}FieldName": "upfile",
"{tpl}PathFormat": "upload/{tpl}/{yyyy}{mm}{dd}/{time}{rand:6}",
"{tpl}UrlPrefix": "/ueditor/net/",
"{tpl}AllowFiles": [".png", ".jpg", ".jpeg", ".gif", ".bmp"],
"{tpl}MaxSize": 2048000
}
```
"{tpl}FieldName" 表示提交的表单的文件域名称。
"{tpl}PathFormat" 表示上传文件保存的路径和名称。注意,这里的路径是相对应用程序的,如果需要修改的话,请自行修改源码。
"{tpl}UrlPrefix" 表示上传文件访问的 URL 前缀。注意,这里应该给出应用程序的 URL 路径,否则上传的文件不能正确定位。
> 举个例子,如果你的 UEditor 的位置在 `http://www.mydomain.com/myapp/ueditor`,对应的本地路径是 `C:\iis_pub\www\myapp\ueditor`,那么 .NET 应用程序的位置在 `http://www.mydomain.com/myapp/ueditor/net`,对应的本地路径是 `C:\iis_pub\www\myapp\ueditor\net`。图片上传配置项应该如下:
>
> {
> "imagePathFormat": "upload/image/{yyyy}{mm}{dd}/{time}{rand:6}",
> "imageUrlPrefix": "/myapp/ueditor/net/",
> }
>
> 上传的文件会保存在 `C:\iis_pub\www\myapp\ueditor\net\upload\image\{日期}\{文件名}`
"{tpl}AllowFiles" 限制文件上传的类型,注意要有 "."。
"{tpl}MaxSize" 限制文件上传的大小。注意这里的限制是代码上的判断,应用程序本身还有一个请求报文大小限制。该限制在 web.config 文件中修改,注意要有以下的节:
```xml
<configuration>
<system.web>
<httpRuntime requestValidationMode="2.0" maxRequestLength="102400" />
</system.web>
</configuration>
```
maxRequestLength 就是请求报文大小限制,该大小应该要比设置的所有上传大小都大,否则应用程序执行之前,请求会被被拒绝。
## 3. 源码说明
可以看到 net 目录内的源码结构是这样的:
```
net
App_Code
Config.cs
Handler.cs
PathFormatter.cs
*Handler.cs
Bin
Newtonsoft.Json.dll
config.json
controller.ashx
net.sln
README.md
Web.config
```
App_Code 上的文件是应用程序的源码。
- Config.cs 负责读取配置文件
- Handler.cs 是请求处理器的基类,提供了一些基本对象的访问以及输出控制。如果需要增加处理器,应该从该基类继承
- PathFormatter.cs 解析 PathFormat,把信息填充为运行时信息。
- *Handler.cs 是各种处理器,处理各种 UEditor 需要的请求。
Bin 里面的是应用程序的依赖库,当前依赖 Newtonsoft 的 Json 库。Bin 目录和 App_Code 目录受应用程序保护,不用担心被用户访问到。
config.json 是 UEditor 后端的配置文件,上一节已经介绍了比较重要的配置项。
controller.ashx 是 UEditor 请求的入口,它把不同的 action 分发到不同的 Handler 来处理。
net.sln 是项目的解决方案文件,安装 Visual Studio 2013 或以上的机器可以打开进行项目的改造。
README.md 是本说明文件。
Web.config 是应用程序的配置文件。
没有合适的资源?快使用搜索试试~ 我知道了~
PHP卡盟源码 响应式蓝色模板.zip
共4301个文件
png:1419个
gif:764个
php:615个
1.该资源内容由用户上传,如若侵权请联系客服进行举报
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
2.虚拟产品一经售出概不退款(资源遇到问题,请及时私信上传者)
版权申诉
0 下载量 12 浏览量
2022-07-14
09:22:43
上传
评论 1
收藏 31.17MB ZIP 举报
温馨提示
安装说明: 1、上传到网站根目录 2、导入数据库文件 3、修改数据库链接文件 /jhs_cofing/conn.php (记得不要用记事本修改,否则可能会出现验证码显示不了问题,建议用Notepad ) 4、后台地址 http://您域名/admin) (前台模板数据需在后台-模板设置-响应式蓝色模板 里面设置)
资源推荐
资源详情
资源评论
收起资源包目录
PHP卡盟源码 响应式蓝色模板.zip (4301个子文件)
RELEASE-DATE-3.5.8.2 29B
buy_botton.ai 239KB
button_bg1.ai 238KB
input_go.ai 237KB
controller.ashx 3KB
ChangeLog 32KB
swekey.sample.conf 2KB
Web.config 462B
musbe-ca.crt 1KB
UploadHandler.cs 5KB
CrawlerHandler.cs 3KB
ListFileHandler.cs 3KB
PathFormater.cs 2KB
Handler.cs 1KB
Config.cs 1KB
NotSupportedHandler.cs 477B
ConfigHandler.cs 348B
H-ui.css 207KB
H-ui.min.css 149KB
vendor.css 134KB
bootstrap.min.css 122KB
boot.css 120KB
bootstrap2.min.css 107KB
bootstrap.min.css 107KB
login.css 97KB
util.css 85KB
animate.css 77KB
animate.css 74KB
wallet.css 70KB
style.css 69KB
material-design-iconic-font.min.css 69KB
style.css 69KB
layui.css 68KB
customerService.css 66KB
style.css 66KB
stylegoods.css 66KB
style1.css 65KB
layui.css 59KB
layui.css 59KB
systemcss_1.css 56KB
systemcss.css 56KB
jquery.mcustomscrollbar.css 54KB
sup1.css 48KB
ueditor.css 45KB
register.css 39KB
vipinside_1.css 36KB
vipinside.css 36KB
ueditor.min.css 34KB
matrix-style.css 33KB
jquery-ui-1.8.16.custom.css 33KB
jquery-ui-1.8.16.custom.css 33KB
aos.css 31KB
jquery-ui-1.9.2.custom.css 30KB
font-awesome.min.css 30KB
css.css 29KB
jquery-ui-1.9.2.custom.min.css 26KB
style.css 25KB
style_1.css 24KB
style.css 24KB
inner-custom.css 23KB
hcjane.css 22KB
css.css 22KB
levelstyle.css 22KB
video-js.css 22KB
default.css 21KB
style_1.css 21KB
admin.css 21KB
layer.css 20KB
font-awesome.css 20KB
image.css 19KB
default.css 18KB
layout-utf8.css 18KB
jquery-ui-1.9.2.custom.css 17KB
iconfont.css 17KB
right.css 16KB
regok.css 16KB
zch_css.css 16KB
video.css 15KB
attachment.css 15KB
jquery-ui-1.9.2.custom.min.css 15KB
iconfont.min.css 14KB
layer.css 14KB
layer.css 14KB
admin.css 14KB
layer.css 14KB
common.css 13KB
index.css 12KB
index_main.css 12KB
order_helpcom.css 12KB
common.css 12KB
webuploader.css 11KB
video-js.min.css 11KB
main.css 10KB
xadmin.css 10KB
xadmin.css 10KB
media.css 10KB
ui-dialog.css 10KB
ui-dialog_1.css 10KB
layui.mobile.css 10KB
layui.mobile.css 10KB
共 4301 条
- 1
- 2
- 3
- 4
- 5
- 6
- 44
资源评论
智慧浩海
- 粉丝: 1w+
- 资源: 5119
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功