jonahfu/vbscript repository overview

HTTP 层 (axum)
    ↓
ASP 引擎层 (segmenter + engine + include)
    ↓
VBScript Runtime (interpreter + value)
    ↓
Parser / AST (手写 Lexer + Pratt 表达式解析器 + 递归下降语句解析器)

src/
├── main.rs                     # 入口
├── lib.rs                      # 库入口
│
├── ast/                        # 抽象语法树（纯数据结构）
│   ├── expr.rs                 # 表达式
│   ├── op.rs                   # 运算符定义
│   ├── program.rs              # 程序
│   └── stmt.rs                 # 语句
│
├── parser/                     # 语法解析层
│   ├── lexer/                  # 词法分析器（手写）
│   │   ├── mod.rs              # Lexer 核心
│   │   ├── token.rs            # Token 定义
│   │   └── number.rs           # 数字解析（十六进制/八进制）
│   ├── keyword.rs              # 关键字定义
│   ├── error.rs                # 解析错误
│   ├── parser.rs               # 解析器入口
│   ├── expr/                   # 表达式解析（Pratt 算法）
│   │   ├── pratt.rs            # Pratt 解析器核心
│   │   ├── prefix.rs           # 前缀表达式
│   │   ├── infix.rs            # 中缀表达式
│   │   └── postfix.rs          # 后缀表达式
│   └── stmt/                   # 语句解析（递归下降）
│       ├── core.rs             # 核心解析逻辑
│       ├── assign_stmt.rs      # 赋值语句
│       ├── decl_stmt.rs        # 声明语句（Dim/Const/ReDim）
│       ├── if_stmt.rs          # If 条件语句
│       ├── loop_stmt.rs        # 循环语句（For/While/Do/For Each）
│       ├── proc_stmt.rs        # 函数/过程/Class
│       ├── select_stmt.rs      # Select Case 语句
│       └── with_stmt.rs        # With 语句
│
├── runtime/                    # 解释执行层
│   ├── interpreter/            # 解释器调度
│   ├── context.rs              # 执行上下文
│   ├── scope.rs                # 变量作用域
│   ├── class.rs                # Class 运行时支持
│   ├── error.rs                # 运行时错误
│   ├── value/                  # 值类型系统
│   ├── objects/                # ASP 内建对象
│   │   ├── response.rs         # Response 对象
│   │   ├── request.rs          # Request 对象
│   │   ├── server.rs           # Server 对象
│   │   ├── session.rs          # Session 对象
│   │   ├── session_manager.rs  # Session 管理
│   │   ├── session_store.rs    # Session 存储
│   │   ├── dictionary.rs       # Scripting.Dictionary
│   │   ├── filesystemobject.rs # Scripting.FileSystemObject
│   │   ├── xmlhttp.rs          # MSXML2.XMLHTTP
│   │   └── factory.rs          # 对象工厂
│   └── builtins/               # 内置函数
│       ├── token.rs            # 函数 Token ID
│       ├── registry.rs         # 函数注册表
│       └── executors.rs        # 函数执行器
│
├── asp/                        # ASP 引擎层
│   ├── engine/                 # 引擎子模块
│   ├── segmenter.rs            # 代码分段器
│   └── include.rs              # Include 指令处理
│
└── http/                       # HTTP 服务层
    ├── router.rs               # 路由配置
    ├── handler.rs              # 请求处理
    ├── state.rs                # 应用状态
    ├── path_resolver.rs        # 路径解析（安全防护）
    ├── request_context.rs      # HTTP 请求上下文
    └── error_page.rs           # 错误页面

// 1. HTTP 请求到达 handler.rs
// 2. 加载 ASP 文件，处理 include 指令
let asp_content = include_processor.resolve_includes(file_path)?;

// 3. 分段器将 ASP 文件分割为 HTML 段和代码段
let segments = segmenter.segment(&asp_content);

// 4. 对每个代码段执行：Lexer → Parser → Interpreter
for segment in segments {
    match segment {
        Segment::Html(html) => output.push_str(html),
        Segment::Code(code) => {
            let tokens = lexer.tokenize(&code)?;
            let program = parser.parse_program(tokens)?;
            interpreter.execute(&program)?;
        }
    }
}

// 5. 返回 HTML 响应

# 拉取镜像
docker pull jonahfu/vbscript:latest

# 运行容器
docker run -d \
  --name vbscript \
  -p 8080:8080 \
  -v $(pwd)/www:/app/www \
  jonahfu/vbscript:latest

version: '3.8'

services:
  vbscript:
    image: jonahfu/vbscript:latest
    container_name: vbscript
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      # 挂载 ASP 源码目录
      - ./www:/app/www
      # 挂载 Session 持久化目录（可选）
      - ./runtime/sessions:/app/runtime/sessions
    environment:
      # ========== 基础 HTTP 服务配置 ==========
      # 是否显示目录列表
      - DIRECTORY_LISTING=false
      # Web 根目录路径（容器内路径）
      - HOME_DIR=/app/www
      # 默认索引文件
      - INDEX_FILE=index.asp,index.html
      # 索引文件功能开关
      - INDEX_FILE_ENABLE=true
      # 服务端口号
      - PORT=8080
      # 是否支持父路径访问（安全风险）
      - ALLOW_PARENT_PATH=false
      # ASP 文件扩展名
      - ASP_EXT=asp,asa

      # ========== 调试与错误处理配置 ==========
      # 是否启用调试模式
      - DEBUG=false
      # 是否显示详细错误信息（生产环境建议关闭）
      - DETAILED_ERROR=false
      # 自定义错误页面（相对于 HOME_DIR）
      # - ERROR_PAGE=error.html

      # ========== Session 会话管理配置 ==========
      # Session 存储模式 (memory/json/redis)
      # memory - 纯内存存储，重启后丢失
      # json - JSON文件持久化存储
      # redis - Redis存储（预留）
      - SESSION_STORAGE=memory
      # Session 超时时间（分钟）
      - SESSION_TIMEOUT=20
      # Session 存储目录（仅 json 模式）
      - SESSION_DIR=/app/runtime/sessions
      # Redis 连接配置（预留，仅 redis 模式）
      # - REDIS_URL=redis://redis:6379
      # - REDIS_KEY_PREFIX=vbscript:session:

      # ========== 日期时间格式配置 ==========
      # 格式说明：yyyy=年 mm=月 dd=日 hh=时 nn=分 ss=秒
      - NOW_FORMAT=yyyy/mm/dd hh:nn:ss
      - DATE_FORMAT=yyyy/mm/dd
      - TIME_FORMAT=hh:nn:ss

      # ========== CreateObject 安全配置 ==========
      # CreateObject 功能开关
      - CREATE_OBJECT_ENABLE=true
      # Server.CreateObject 白名单
      - CREATE_OBJECT_WHITELIST=Scripting.Dictionary,Scripting.FileSystemObject,MSXML2.XMLHTTP

  # 可选：Redis 服务（用于 Session 持久化，redis 驱动还未支持，后续会支持）
  # redis:
  #   image: redis:7-alpine
  #   container_name: vbscript-redis
  #   restart: unless-stopped
  #   volumes:
  #     - redis_data:/data

# volumes:
#   redis_data:

# 启动
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止
docker-compose down

# ==================== 基础配置 ====================

# 是否显示目录列表 (true/false)
DIRECTORY_LISTING=false

# Web 根目录路径
HOME_DIR=./www

# 默认索引文件（支持多个，逗号分隔）
INDEX_FILE=index.asp,index.html

# 索引文件功能开关 (true/false)
INDEX_FILE_ENABLE=true

# 服务端口号
PORT=8080

# 是否支持父路径访问 (../) (true/false)
# 警告：启用此选项可能存在安全风险
ALLOW_PARENT_PATH=false

# ASP 文件扩展名（逗号分隔）
ASP_EXT=asp,asa

# ==================== 调试配置 ====================

# 是否启用调试模式 (true/false)
DEBUG=false

# 是否显示详细错误信息 (true/false)
# 生产环境建议关闭
DETAILED_ERROR=false

# 自定义错误页面（相对于 home_dir）
# ERROR_PAGE=error.html

# ==================== Session 配置 ====================

# Session 存储模式 (memory/json/redis)
# memory - 纯内存存储，重启后丢失
# json - JSON文件持久化存储（默认）
# redis - Redis存储（预留接口）
SESSION_STORAGE=memory

# Session 超时时间（分钟）
SESSION_TIMEOUT=20

# Session 存储目录（仅 json 模式使用）
SESSION_DIR=./runtime/sessions

# Redis 连接地址（预留，仅 redis 模式使用）
# REDIS_URL=redis://127.0.0.1:6379
# REDIS_KEY_PREFIX=vbscript:session:

# ==================== 日期时间格式配置 ====================
# 参考：https://learn.microsoft.com/zh-tw/office/vba/language/reference/user-interface-help/format-function-visual-basic-for-applications
#
# 格式说明：
#   yyyy = 四位年份 (2024)
#   yy = 两位年份 (24)
#   mm = 月份，带前导零 (01-12)
#   m = 月份，不带前导零 (1-12)
#   dd = 日期，带前导零 (01-31)
#   d = 日期，不带前导零 (1-31)
#   hh = 小时，带前导零 (00-23)
#   h = 小时，不带前导零 (0-23)
#   nn = 分钟，带前导零 (00-59)
#   n = 分钟，不带前导零 (0-59)
#   ss = 秒，带前导零 (00-59)
#   s = 秒，不带前导零 (0-59)
NOW_FORMAT=yyyy/mm/dd hh:nn:ss
DATE_FORMAT=yyyy/mm/dd
TIME_FORMAT=hh:nn:ss

# ==================== CreateObject 配置 ====================

# CreateObject 功能开关 (true/false)
CREATE_OBJECT_ENABLE=true

# Server.CreateObject 白名单（逗号分隔）
# 出于安全考虑，只允许创建以下对象：
# - Scripting.Dictionary: 字典对象，用于键值对存储
# - Scripting.FileSystemObject: 文件系统对象，用于文件和文件夹操作
# - MSXML2.XMLHTTP: HTTP 请求对象，用于发起 HTTP 请求
# 注意：不支持的 COM 对象（如 ADODB.Connection）将被拒绝
CREATE_OBJECT_WHITELIST=Scripting.Dictionary,Scripting.FileSystemObject,MSXML2.XMLHTTP

# 开发模式
cargo run

# Release 模式
cargo run --release

# 带调试日志
DEBUG=true cargo run

🚀 VBScript ASP Server starting at http://127.0.0.1:8080
📁 Home directory: ./www
📄 Index file: index.asp
📋 Directory listing: true