CGI-Node 示例 - Javascript

什么是 CGI-Node？

CGI-Node 是一个基于 Node.js 的 CGI 框架，它可以帮助开发者快速实现 CGI 程序的开发。CGI (Common Gateway Interface) 是一种标准的 Web 服务器和应用程序之间通讯的协议，它可以让浏览器和 Web 服务器互相发送数据并协作处理。

如何使用 CGI-Node？

安装 CGI-Node 非常简单，只需要使用 npm 包管理器即可：

npm install cgi-node

安装完成后，就可以使用 CGI-Node 开始编写 CGI 程序，下面是一个例子：

const cgiNode = require('cgi-node');

cgiNode((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello, World!');
});

以上代码定义了一个基本的 CGI 程序，它会在客户端请求时返回一条简单的消息。

CGI-Node 的 API

下面是 CGI-Node 中最常用的几个 API：

cgiNode(handler: Function)

cgiNode 函数是 CGI-Node 的核心函数，它接收一个处理 HTTP 请求的回调函数 handler，并且返回一个 HTTP 服务器对象。当一个客户端请求发生时，这个 HTTP 服务器对象会自动调用 handler 函数进行处理。

cgiNode((req, res) => {
  // TODO 处理 HTTP 请求
});

handler(req: IncomingMessage, res: ServerResponse)

handler 函数用于处理 HTTP 请求，并向客户端返回数据。它接收两个参数：

• req：代表客户端发送的 HTTP 请求对象，可以通过它获取请求头、请求体等信息；
• res：代表服务器要返回给客户端的 HTTP 响应对象，可以通过它向客户端发送数据。

cgiNode((req, res) => {
  res.writeHead(200, { 'Content-Type': 'text/plain' });
  res.end('Hello, World!');
});

req

req 参数是一个 IncomingMessage 类型的对象，代表客户端发送的 HTTP 请求。在 req 对象中，包含了客户端请求的所有信息，比如请求方法、请求路径、请求参数、请求头、请求体等信息。

下面是一个例子，输出客户端传递过来的参数：

cgiNode((req, res) => {
  const { query } = require('url').parse(req.url, true);
  res.end(`Hello, ${query.name || 'World'}!`);
});

res

res 参数是一个 ServerResponse 类型的对象，代表服务器要返回给客户端的 HTTP 响应。在 res 对象中，可以通过 writeHead 方法来设定 HTTP 的响应头，通过 end 方法来输出响应体。

例如，下面这个例子输出一个图片：

cgiNode((req, res) => {
  const fs = require('fs');
  const path = require('path');
  const imgPath = path.join(__dirname, 'image.jpg');
  const imgData = fs.readFileSync(imgPath);
  res.writeHead(200, {
    'Content-Type': 'image/jpeg',
    'Content-Length': imgData.byteLength
  });
  res.end(imgData);
});

总结

通过本文的介绍，我们了解了 CGI-Node 的基本使用方法和 API。CGI-Node 的简单易用让开发 Web 应用变得更加容易和高效。如果您正在寻找一个快速搭建 CGI 程序的框架，那么 CGI-Node 是一个很好的选择。