KDB/q技术问询：如何在HTTP端口显示静态HTML而非变量函数列表？

嘿，这个需求我之前折腾过，其实q的HTTP服务自带了钩子函数，让我们能自定义请求处理逻辑，轻松替换掉默认的变量/函数列表页面。具体操作步骤如下：

1. 准备静态HTML文件（可选） #

先写好你要展示的静态HTML内容，比如创建一个index.html文件，示例内容：

<!DOCTYPE html>
<html>
<head>
    <title>我的q HTTP自定义页面</title>
</head>
<body>
    <h1>欢迎访问自定义静态页</h1>
    <p>这已经替代了默认的变量与函数列表~</p>
</body>
</html>

把这个文件放在q的工作目录下，或者记好它的绝对路径。

2. 自定义HTTP GET请求处理函数 #

q的.z.ph是处理HTTP GET请求的核心钩子函数，我们可以重写它来返回静态HTML内容。

示例1：仅根路径返回静态页，其他路径保留默认行为 #

如果只想让访问根路径http://localhost:8080/时显示静态页，其他路径仍保留默认的变量/函数列表展示，可以这么写：

// 先启动HTTP服务（端口设为8080，按需修改）
\p 8080

// 重写.z.ph处理函数
.z.ph:{[path]
    // 判断是否为根路径请求
    if[path="/";
        // 读取本地静态HTML文件（如果是绝对路径，比如`:C:/q/static/index.html`）
        htmlContent: read0 `:index.html;
        // 返回HTTP响应：先设置Content-Type为text/html，再返回HTML内容
        ("text/html"; enlist "\r\n"), htmlContent;
    ];
    // 其他路径调用默认处理函数.z.ph0，保留原有功能
    .z.ph0 path;
}

示例2：所有路径都返回静态页 #

如果想让所有HTTP请求都显示你的静态页，直接去掉分支判断即可：

\p 8080

.z.ph:{[path]
    // 读取并返回HTML内容
    ("text/html"; enlist "\r\n"), read0 `:index.html;
}

示例3：硬编码HTML内容（无需外部文件） #

如果不想单独维护HTML文件，也可以把内容直接写在函数里：

\p 8080

.z.ph:{[path]
    html: "<!DOCTYPE html><html><head><title>自定义页</title></head><body><h1>Hello from q!</h1></body></html>";
    ("text/html"; enlist "\r\n"), enlist html;
}

3. 验证效果 #

写完函数后，打开浏览器访问http://localhost:8080（对应你设置的端口），就能看到你的静态HTML页面，而不是默认的变量与函数列表了。

注意事项 #

• 确保q进程有读取HTML文件的权限，使用绝对路径时要注意格式：Windows用:C:/xxx/xxx.html，Linux/macOS用:/home/user/xxx.html。
• 如果端口被占用，换个未被使用的端口即可（比如\p 8081）。
• 如果需要远程访问，要确保服务器防火墙开放了对应的端口。

内容的提问来源于stack exchange，提问作者user9471643