# easyasp

**Repository Path**: jamdong/easyasp

## Basic Information

- **Project Name**: easyasp
- **Description**: 简单好用的ASP类库，采用VbScript脚本编写。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://www.easyasp.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 53
- **Created**: 2016-07-21
- **Last Updated**: 2026-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyASP v3.0

作者 : coldstone (coldstone[at]qq.com)
官网 : <http://www.easyasp.cn>
GIT : <https://git.coding.net/coldstone/easyasp.git>

> git 镜像：
> GitHub : <https://github.com/coldstone/easyasp.git>
> osChina : <http://git.oschina.net/coldstone/easyasp>

Licenses : EasyASP 遵循 [Apache licenses v2](http://zh.wikipedia.org/zh-cn/Apache%E8%AE%B8%E5%8F%AF%E8%AF%81) 版权协议

## 项目简介

EasyASP 是一个简单方便的用来快速开发 ASP 程序的类库。EasyASP 包含完善的全参数化查询多数据库操作、Json 数据生成与解析、无组件压缩解压、各种字符串及日期处理函数、动态数组处理、文件系统处理、远程文件及 XML 文档处理、内存缓存和文件缓存处理、模板引擎等等丰富的功能。而为了解决 ASP 调试不方便的问题，EasyASP 推出了独创的控制台调试功能以及丰富的异常信息显示，能让你开发 ASP 程序时最大程度的从错误调试的纷繁中解放出来。EasyASP 目前提供下载的是 VBScript 版本。

## 技术栈

| 项目 | 说明 |
| --- | --- |
| 语言 | Classic ASP（VBScript），`CODEPAGE=65001`，全站 UTF-8 编码 |
| 运行环境 | Windows + IIS（或 IIS Express），需启用 ASP 功能 |
| 数据库 | 内置支持 Access / MS SQL Server / MySQL（通过 ADO 全参数化查询），可扩展至其他符合工业标准的数据库 |
| 依赖组件 | 仅依赖系统自带组件（`Scripting.FileSystemObject`、`MSXML`、ADO 等），压缩解压、上传等均为无组件纯 VBScript 实现；部分插件可选依赖第三方组件（如 AspJpeg、JMail） |

## 目录结构与模块划分

```text
EasyASP/
├── easyasp/                 # 类库本体
│   ├── easp.asp             # 入口文件，定义 EasyASP 主类并加载全部核心模块
│   ├── easp.config.asp      # 全局配置文件（数据库、控制台、缓存、上传等配置项）
│   ├── core/                # 核心模块（随 easp.asp 自动加载）
│   ├── plugin/              # 插件目录（按需手动 include）
│   ├── console/             # 控制台调试前端页面
│   └── lang/                # 语言包（zh.asp 中文）
├── poordemo/                # 各模块使用示例（按模块分目录）
├── LICENSE                  # Apache License v2
└── README.md
```

### 核心模块（`easyasp/core/`）

| 模块 | 文件 | 功能 |
| --- | --- | --- |
| `Easp.Str` | easp.str.asp / easp.stringbuilder.asp / easp.stringobject.asp | 字符串处理、正则、格式化、高性能 StringBuilder |
| `Easp.Str(...).Test` | easp.validation.asp | 链式表单验证，内置 30+ 验证规则 |
| `Easp.Db` | easp.db.asp | 多数据库全参数化增删改查、分页、事务、存储过程 |
| `Easp.Json` | easp.json.asp | 原生 VBScript 的 Json 解析与生成 |
| `Easp.List` | easp.list.asp | 超级数组（动态数组 / Hash 表 / 排序 / 筛选） |
| `Easp.Date` | easp.date.asp | 日期时间处理与格式化 |
| `Easp.Var` | easp.var.asp | 变量类型判断与转换 |
| `Easp.Fso` | easp.fso.asp | 文件系统操作 |
| `Easp.Http` | easp.http.asp | 远程文件抓取、编码识别、Ajax 跨域代理 |
| `Easp.Xml` | easp.xml.asp | 本地/远程 XML 解析，仿 jQuery 选择器 |
| `Easp.Tpl` | easp.tpl.asp | 模板引擎，支持自定义标签与无限级 include |
| `Easp.Cache` | easp.cache.asp | 内存缓存与文件缓存，可直接缓存记录集 |
| `Easp.Encrypt` | easp.encrypt.asp | 对称加密解密，可自定义密钥 |
| `Easp.Tar` | easp.tar.asp | 无组件压缩解压（支持中文文件名） |
| `Easp.Upload` | easp.upload.asp | 内建艾恩无组件上传（MoLibUpload） |
| `Easp.Console` | easp.console.asp | 控制台调试，变量跟踪、SQL 监控 |
| `Easp.Error` | easp.error.asp | 异常信息展示与跳转 |
| `Easp.Log` | easp.log.asp | 文件日志，支持按天/小时/分钟滚动 |

### 插件（`easyasp/plugin/`）

内置 md5 / md5utf8、base64、aes、汉字转拼音（hanzi / pyo / pr）、邮件（mail / jmail）、微信（wx）、阿里大鱼短信（alidayu）、IP 归属地（ipinfo）、AspJpeg 图像处理、Bootstrap 辅助（bs）、跟踪调试（trace）等插件，另附插件开发示例 `easp.pluginsample.asp`。插件系统支持第三方扩展。

### 示例（`poordemo/`）

按模块分目录提供可直接运行的示例代码，如 `easp.db`（数据库）、`easp.json`、`easp.tpl`（模板）、`easp.upload`（上传）、`easp.rewrite`（伪静态）等，是学习各模块用法的最佳入口。

## 运行说明

### 环境准备

1. 操作系统：Windows（Windows Server 或 Windows 桌面版均可）。
2. 安装 IIS 并启用 ASP 功能：
   - 控制面板 → 程序和功能 → 启用或关闭 Windows 功能；
   - 勾选 `Internet Information Services → 万维网服务 → 应用程序开发功能 → ASP`。
3. （可选）在 IIS 的 ASP 设置中开启「将错误发送到浏览器」，便于开发调试。
4. 如需使用 Access 数据库，32/64 位应用程序池需与对应的 Access 驱动匹配（可在应用程序池中启用「启用 32 位应用程序」）。

### 部署（无需安装依赖）

EasyASP 为纯 VBScript 类库，无需编译、无需安装任何第三方组件：

1. 将本仓库整个目录复制到网站根目录下，保证 `easyasp/` 位于站点根（默认 `Easp.BasePath = "/easyasp/"`；如放在其他位置，请在 `easp.config.asp` 中修改 `Easp.BasePath`）。
2. 在 IIS 中新建站点（或虚拟目录）指向该目录。
3. 在你的 ASP 页面顶部引入入口文件即可使用：

```asp
<!--#include virtual="/easyasp/easp.asp" -->
<%
Easp.Print "Hello EasyASP!"
%>
```

### 启动与验证

1. 启动 IIS 站点后，浏览器访问示例页面验证是否部署成功，例如：
   - `http://localhost/poordemo/easp.str/index.asp` （字符串模块示例）
   - `http://localhost/poordemo/easp.json/create.asp` （Json 生成示例）
   - `http://localhost/poordemo/easp.db/` （数据库示例，需先配置数据库连接）
2. 页面正常输出且无错误提示即表示环境就绪。

### 配置项说明

所有配置集中在 `easyasp/easp.config.asp` 中，按需取消注释并修改，常用配置项如下：

| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| `Easp.BasePath` | `/easyasp/` | `easp.asp` 在网站中的路径，以 `/` 开头 |
| `Easp.PluginPath` | `/easyasp/plugin` | 插件文件存放路径 |
| `Easp.Debug` | `True` | 开发者调试模式，生产环境建议关闭 |
| `Easp.Db.SetConn type, db, auth` | — | 默认数据库连接，如 `Easp.Db.SetConn "ACCESS", "/data.mdb", ""` 或 `Easp.Db.SetConn "MSSQL", "data", "sa:pass@(local)"` |
| `Easp.Db.SetConnection name, ...` | — | 配置第二个及更多数据库连接 |
| `Easp.Db.PageParam` / `PageSize` | `page` / `25` | 分页 URL 参数名与每页数量 |
| `Easp.Encrypt.Key` | 空 | 加密解密密钥 |
| `Easp.Console.Enable` | `True` | 是否开启控制台调试 |
| `Easp.Console.Token` | 空 | 控制台访问令牌，设置后前端 token 一致才输出调试信息 |
| `Easp.Console.ShowSql` / `ShowSqlTime` | `True` | 控制台是否显示 SQL 语句及执行时间 |
| `Easp.Error.Title` / `Redirect` / `Delay` | — | 异常信息标题、是否自动跳转及等待秒数 |
| `Easp.Cache.SavePath` / `Expires` | `/_cache` / `5` | 文件缓存保存路径与默认过期时间（分钟，0 为永不过期） |
| `Easp.Tpl.FilePath` / `TagMask` | `/view/` / `{*}` | 模板文件目录与标签标识符 |
| `Easp.Upload.SavePath` / `AllowFileTypes` | `/UploadFiles` / 常见类型 | 上传保存目录与允许的扩展名 |
| `Easp.Log.Enable` / `SavePath` / `FileRolling` | `False` / `/../` / `day` | 日志开关、保存路径与滚动频率（day/hour/minute） |

其余 Fso、Http、Json、List、Str 等模块配置项详见 `easp.config.asp` 内注释。

## EasyASP 的部分功能特点

* [ASP] 大量丰富的字符串处理、正则处理、日期时间、数值格式化及其它通用函数。
* [ASP] 实现高性能的字符串构造类 StringBuilder 。
* [ASP] 强大的表单验证功能，采用链式操作，内置超过30种验证规则，可灵活验证各种类型数据，支持多种方式自定义。
* [ASP] 简单快捷的 Cookies 和 Application 读写。
* [ASP] 支持伪静态（伪Rewrite），且对已开发的程序无影响。
* [ASP] 实现ASP文件的动态载入，并支持无限级的ASP原生include。
* [ASP] 实现高效的对称加密解密，可自定义密钥，且加密后字符串全部为可打印字符。
* [ASP] 独创的插件系统，内置md5、汉字转拼音、翻译、分词等插件，并有丰富的第三方插件提供下载。
* [JSON] 原生 VBScript 实现高效率的 Json 数据解析与生成。
* [JSON] 记录集、集合、N维数组、Easp List 对象和几乎所有ASP内置对象都能直接输出为 Json 格式数据。
* [数据库] 默认支持 Access / MS SQL Server / MySQL Server 数据库，并可以扩展至支持其他任何符合工业标准的数据库。
* [数据库] 能方便的实现一个或多个数据库的读、增、删、改等控制操作，可嵌套标签式的参数操作易用到令人发指。
* [数据库] 提供高效的批量插入、删除、更新，并带有事务处理支持。
* [数据库] 数据库查询使用全参数化，EasyASP 的优秀设计让你大部分情况下不用考虑数据字段的类型，也完全避免了SQL注入的风险。
* [数据库] 简捷的存储过程调用方式，可以很方便的操作输入参数、输出参数、返回一个或多个记录集、返回值、受影响的行数。
* [数据库] 自带简单高效的分页功能，拥有功能丰富的可完全自定义风格配置及调用，内置 `bootstrap` 分页样式。
* [数据库] 自动判断数据库类型及版本号，并能根据数据库的不同类型不同版本自动优化SQL查询语句。
* [数据库] 记录集可以很方便的转换为Json格式数据。
* [控制台] 独创的控制台支持任意 ASP 变量的调试与跟踪。
* [控制台] 控制台支持 SQL 语句及执行时间实时监控。
* [控制台] 控制台支持设置 token 阻止未授权的访问。
* [压缩解压] 纯ASP(VBScript)世面上唯一支持中文文件名的无组件压缩解压。
* [远程文件] 支持自动识别远程文件编码，支持按标签或按正则表达式截取片段，支持批量保存远程图片至本地服务器。
* [远程文件] 能方便的实现 Ajax 跨域代理。
* [超级数组] 支持动态数组及Hash表，支持数组排序、筛选、循环处理及数组间运算。
* [模板引擎] 支持自定义模板标签，支持模板文件无限级include，标签支持无限级循环区块。
* [XML] 支持本地及远程 XML 文档解析，实现仿 jQuery 选择器，节点操作无压力。
* [XML] 提供调用 WebService 的示例。
* [缓存] 支持内存缓存和文件缓存，支持直接缓存记录集。
* [上传] 获授权内建艾恩无组件上传(`MoLibUpload`)——ASP上传界终结者。
* [工具] 提供专用伪静态规则测试工具。
* [工具] 提供 Dreamweaver / EverEdit / EditPlus 等编辑器的代码高亮及代码智能提示插件。
* [工具] 拥有高人气的文档社区，并有大量优秀的文档编辑提供丰富的带示例的API文档支持。
* ……

## 交流与反馈

* Bug 提交或功能建议请到 [Coding 讨论区](https://coding.net/u/coldstone/p/easyasp/topic/all) 或官网论坛 [EasyASP问题反馈](http://bbs.easyasp.cn/forum-issue-1.html) 板块。
* EaspASP 官方交流QQ群：`26435555`， 加群验证请输入 `easyasp`，无验证信息不加。