试用EF开发WEB应用程序(8): CGI环境变量

来源：互联网发布：lol意思网络用语编辑：程序博客网时间：2024/05/14 08:42

题记：用“易语言.飞扬”（EF）开发WEB应用程序，此前还没有先例。但因为EF本地开发包（EFNDK）已经发布，用C/C++开发一个EF类库，使其支持EF开发WEB应用程序，应该并非难事。当然也可想而知，其中必有诸多难点有待解决。此系列文章，为本人探索过程之记录，对外人未必有多大价值。如有网友乐观其事，还请理性待之。作者：liigo。转载请务必注明出处：http://blog.csdn.net/liigo/。在线留言。

试用EF开发WEB应用程序(8): CGI环境变量

　　FastCGI 是对 CGI 技术的扩展和改进，要写好 FastCGI / CGI 程序，了解、熟悉、深入掌握“CGI环境变量”是必需的。本文将重点介绍CGI规范中规定的标准环境变量，以及FastCGI扩展的环境变量。

　　在 CGI / FastCGI 规范中，WEB服务器和CGI/FastCGI程序之间交流信息的主要途径是环境变量（以及标准输入输出流）。这里说到的环境变量，是指操作系统中的环境变量。（Windows系统下，PATH 是很常见的一个环境变量；熟悉JAVA的朋友通常都知道一个叫 CLASSPATH 的环境变量；学“易语言.飞扬”(EF) 的哥们也肯定听说过 EF_LIB_PATHS 这个环境变量；……） CGI规范对CGI程序中使用的环境变量名称及其含义做了具体而明确的规定，通常把这些环境变量称为“CGI环境变量”。

下表：CGI环境变量及其介绍

CGI 环境变量名称 说明 REQUEST_METHOD 请求类型，如 "GET" 或 "POST" CONTENT_TYPE 被发送数据的类型 CONTENT_LENGTH 客户端向标准输入设备发送的数据长度，单位为字节 QUERY_STRING 查询参数，如 "id=10010&sn=liigo" SCRIPT_NAME CGI脚本程序名称，如 "/xyz.efcgi" PATH_INFO CGI脚本程序的附加路径 PATH_TRANSLATED PATH_INFO对应的绝对路径 REMOTE_ADDR 发送此次请求的主机IP REMOTE_HOST 发送此次请求的主机名 REMOTE_USER 已被验证合法的用户名 REMOTE_IDENT WEB服务器的登录用户名 AUTH_TYPE 验证类型 GATEWAY_INTERFACE 服务器遵守的CGI版本，如 "CGI/1.1" SERVER_NAME 服务器主机名、域名或IP SERVER_PORT 服务器端口号 SERVER_PROTOCOL 服务器协议，如 "HTTP/1.1" SERVER_SOFTWARE 服务器软件的描述文本 DOCUMENT_ROOT 文档根目录 HTTP_ACCEPT 客户端可以接收的MIME类型，以逗号(,)分隔 HTTP_USER_AGENT 发送此次请求的WEB浏览器 HTTP_REFERER 调用此脚本程序的文档 HTTP_COOKIE 获取COOKIE键值对，多项之间以分号(;)分隔，如 "key1=value1; key2=value2"

下表：FastCGI 扩展的环境变量

FastCGI 环境变量名称 说明 FCGI_ROLE 当前 FastCGI 程序担任的角色，如 "RESPONDER", "AUTHORIZER", "FILTER" FCGI_DATA_LENGTH 服务器发送的数据长度。仅当 FCGI_ROLE 值为 "FILTER" 时有效。 FILE_LAST_MOD 输入文件（input file）的最后修改时间，其值为自1970年1月1日零时零分零秒（世界标准时间，UTC）至今的秒数。仅当 FCGI_ROLE 值为 "FILTER" 时有效。

　　对于以上所有 CGI 环境变量，和 FastCGI 扩展的环境变量，EF类库 fastcgi.efn 中的 FCGI 类均提供同名属性方法，用于读取该环境变量的值。一般来说，这些方法返回文本数据；只有几个例外，是返回整数数据：CONTENT_LENGTH(), FCGI_DATA_LENGTH(), FILE_LAST_MOD()。

　　此外，WEB服务器通常也会扩展一些环境变量，这种情况下，可用EF类库 fastcgi.efn 中提供的 FCGI.getenv() 方法读取任意指定名称的环境变量的值。

　　下面，我们用EF写一个WEB程序，列出以上所有CGI环境变量及其内容，亲身感受一下CGI环境变量的真实面目，以便加深对它们的理解：

引入 fastcgi;

公开类启动类
{
 常量文本 s = ["Content-type: text/html

<html><head>
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<title>$(title)</title>
</head>
<body>
<h1>$(title)</h1>
<hr></hr>
<h3>PARAMS: </h3>
$(params)
<hr></hr>
<h3>CGI ENV VARS: </h3>
$(cgivars)
<hr></hr>
by liigo, index: $(index)
</body>
</html>
"];

 公开静态启动()
 {
 int count = 0;
 FCGI fcgi = new FCGI;
 while(fcgi.Accept() >= 0)
 {
 文本 t = s.替换全部("$(title)", "CGI VARS (by liigo)");
 t = t.替换("$(params)", get_params(fcgi));
 t = t.替换("$(cgivars)", get_cgivars(fcgi));
 t = t.替换("$(index)", count.到文本());
 fcgi.Output(t.到UTF8());
 count++;
 }
 }

 static string get_params(FCGI fcgi)
 {
 string s;
 foreach (fcgi.QUERY_STRING_NAMES(), 文本 name)
 {
 s += "" + name + ": " + fcgi.QUERY_STRING(name) + "";
 }
 return s;
 }

 static string get_cgivars(FCGI fcgi)
 {
 string s;

 s += "REQUEST_METHOD: " + fcgi.REQUEST_METHOD + "";
 s += "CONTENT_TYPE: " + fcgi.CONTENT_TYPE + "";
 s += "CONTENT_LENGTH: " + fcgi.CONTENT_LENGTH.到文本() + "";
 if(fcgi.CONTENT_LENGTH > 0)
 {
 binary content = fcgi.ReadData(fcgi.CONTENT_LENGTH);
 s += "CONTENT: " + content.到文本() + "";
 s += "CONTENT(text): " + content.UTF8到文本().替换全部(" ", " ") + "";
 }
 s += "QUERY_STRING: " + fcgi.QUERY_STRING + "";
 s += "QUERY_STRING_NAMES: " + fcgi.QUERY_STRING_NAMES().到文本() + "";
 s += "QUERY_STRING_UNDECODED: " + fcgi.QUERY_STRING_UNDECODED + "";
 s += "SCRIPT_NAME: " + fcgi.SCRIPT_NAME + "";
 s += "PATH_INFO: " + fcgi.PATH_INFO + "";
 s += "PATH_TRANSLATED: " + fcgi.PATH_TRANSLATED + "";
 s += "REMOTE_ADDR: " + fcgi.REMOTE_ADDR + "";
 s += "REMOTE_HOST: " + fcgi.REMOTE_HOST + "";
 s += "REMOTE_USER: " + fcgi.REMOTE_USER + "";
 s += "REMOTE_IDENT: " + fcgi.REMOTE_IDENT + "";
 s += "AUTH_TYPE: " + fcgi.AUTH_TYPE + "";

 s += "GATEWAY_INTERFACE: " + fcgi.GATEWAY_INTERFACE + "";
 s += "SERVER_NAME: " + fcgi.SERVER_NAME + "";
 s += "SERVER_PORT: " + fcgi.SERVER_PORT.到文本() + "";
 s += "SERVER_PROTOCOL: " + fcgi.SERVER_PROTOCOL + "";
 s += "SERVER_SOFTWARE: " + fcgi.SERVER_SOFTWARE + "";
 s += "DOCUMENT_ROOT: " + fcgi.DOCUMENT_ROOT + "";

 s += "HTTP_ACCEPT: " + fcgi.HTTP_ACCEPT + "";
 s += "HTTP_USER_AGENT: " + fcgi.HTTP_USER_AGENT + "";
 s += "HTTP_REFERER: " + fcgi.HTTP_REFERER + "";
 s += "HTTP_COOKIE: " + fcgi.HTTP_COOKIE + "";

 s += "FCGI_ROLE: " + fcgi.FCGI_ROLE + "";
 s += "FCGI_DATA_LENGTH: " + fcgi.FCGI_DATA_LENGTH.到文本() + "";
 s += "FILE_LAST_MOD: " + fcgi.FILE_LAST_MOD.到文本() + "";

 return s;
 }
}

下图是以上程序的执行结果（左图由URL提交，右图由FORM提交(<form action = "cgivars.efcgi" method="post" enctype="multipart/form-data">)），近距离感受它们吧（点击放大图片）：

参考：

http://www.fastcgi.com

http://hoohoo.ncsa.uiuc.edu/cgi/

下篇预告：？？？

一点题外话：上面提到JAVA使用了一个叫 CLASSPATH 的环境变量，我一直觉得这个环境变量的名称取得“太霸道”，你凭什么把这样一个“通用名称”占用了呀，怎么说也该加上一个"JAVA" 或 "J" 前缀吧：JAVA_CLASSPATH, J_CLASSPATH。要不然，后面再出来几个编程语言，也需要使用“类路径”之类的环境变量的话，让人家做何选择？呵呵。相对来说，“易语言.飞扬”就厚道一些，使用了“EF_LIB_PATHS”，加了自己的前缀（EF）。