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

ruilin215

浏览: 1143196 次
性别:
来自: 成都

最近访客更多访客>>

u012363178

Csupport

8612

huangyunhui

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (1505)

社区版块

存档分类

CGI Web 应用服务器脚本浏览器

题记：用“易语言.飞扬”（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>
<metahttp-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>CGIENVVARS:</h3>
$(cgivars)
<hr></hr>
byliigo,index:$(index)
</body>
</html>
"];

公开静态启动()
{
intcount=0;
FCGIfcgi=newFCGI;
while(fcgi.Accept()>=0)
{
文本t=s.替换全部("$(title)","CGIVARS(byliigo)");
t=t.替换("$(params)",get_params(fcgi));
t=t.替换("$(cgivars)",get_cgivars(fcgi));
t=t.替换("$(index)",count.到文本());
fcgi.Output(t.到UTF8());
count++;
}
}

staticstringget_params(FCGIfcgi)
{
strings;
foreach (fcgi.QUERY_STRING_NAMES(),文本name)
{
s+=""+name+":"+fcgi.QUERY_STRING(name)+"";
}
returns;
}

staticstringget_cgivars(FCGIfcgi)
{
strings;

s+="REQUEST_METHOD:"+fcgi.REQUEST_METHOD+"";
s+="CONTENT_TYPE:"+fcgi.CONTENT_TYPE+"";
s+="CONTENT_LENGTH:"+fcgi.CONTENT_LENGTH.到文本()+"";
if(fcgi.CONTENT_LENGTH>0)
{
binarycontent=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.到文本()+"";

returns;
}
}

下图是以上程序的执行结果（左图由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）。

分享到：

企业信息化：重新审视OA的目的 | 试用EF开发WEB应用程序(7): Query String ...

2008-04-10 20:32
浏览 855
评论(0)
查看更多

发表评论

您还没有登录,请您登录后再发表评论

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

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

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

评论

发表评论

相关推荐

最近访客 更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

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

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

评论

发表评论

相关推荐

最近访客更多访客>>