cgigeneral.txt

用C些的CGI函数库

CGIGeneral函数子库文档
作者：		BetonArmEE
最新版本：	2007-04-16	v1.0

>>> 目录
1.关于
	1.1.功能概述
	1.2.兼容平台列表
	1.3.版本历史
2.知识手册
	2.1.CGI环境变量
3.使用指南
	3.1.显示所有CGI环境变量
4.参考列表
	4.1.宏列表
	4.2.函数列表

>>> 正文
1.关于

	1.1.功能概述
	
		CGIGeneral为CGI笼统函数库。
		
	1.2.支持平台列表
		
		Windows、UNIX、Linux
		
	1.3.版本历史
	
		2005-05-02	创建 第一版
		2007-04-16	创建 文档
		
2.知识手册

	2.1.CGI环境变量
		
		CGI程序与web服务器软件交互主要通过标准输入输出和环境变量。
		CGI程序可以从环境变量中获取很多重要的信息，比如对方浏览器端的IP、本程序部署映射的url、浏览器端提交数据的方法和数据组织格式。
		CGI环境变量宏是对环境变量的重命名，可以用标准c中环境变量读取函数获取你所需要的环境变量数据。
	
3.使用指南

	3.1.以下显示所有CGI环境变量
		
		CGIGeneralEntironmentInfo();
	
4.参考列表
	
	4.1.宏列表
		
		CGI_SERVER_SOFTWARE		运行脚本的 HTTP 服务器的名字/版本
		CGI_SERVER_NAME			WEB 服务器的主机名、别名或IP地址
		CGI_GATEWAY_INTERFACE	被服务器支持的 CGI 接口的版本数，其格式为 CGI/版本号
		CGI_SERVER_PROTOCOL		请求所用协议的名字/版本
		CGI_SERVER_PORT			
		CGI_REQUEST_METHOD		提供脚本被调用的方法，对于使用 HTTP/1.0 协议的脚本，仅 GET 和 POST 有意义
		CGI_PATH_INFO			显示由客户提供并附在虚拟路径尾的任何附加的路径信息。它通常被用作脚本的参数
		CGI_PATH_TRANSLATED		仅由部分服务器支持，此变量包含由虚拟路径到被执行脚本的转换(即虚拟路径到物理路径的映射)。例如，如果到你的 WEB 服务器根的绝对路径为 /apache/httpd/htdocs，一个具有 URL http://www.CGIer.net/cgi-bin/test.cgi 的脚本会将变量 PATH_TRANSLATED 设置为/apache/httpd/htdocs/cgi-bin/test.cgi
		CGI_SCRIPT_NAME			被调用脚本文件的名字，它对于自引用脚本很有用
		CGI_QUERY_STRING		由客户提供的附在URL尾并用一个问号与脚本名分开的任何附加信息
		CGI_REMOTE_HOST			已分解的发请求客户的主机名
		CGI_REMOTE_ADDR			发请求客户的 IP 地址
		CGI_AUTH_TYPE			如果服务器支持基本的认证并且如果脚本被保护，此变量提供认证类型，此信息是特定于协议和服务器的
		CGI_REMOTE_USER			如果AUTH_TYPE被设置，此变量将包含用户提供并由服务器确认的用户名
		CGI_REMOTE_IDENT		如果服务器和客户支持 RFC931，此变量将包含由远程用户的计算机提供的识别信息
		CGI_CONTENT_TYPE		如果请求中包括数据，此变量指定数据类型的类别
		CGI_CONTENT_LENGTH		如果通过 POST 方法的请求中包括数据，此变量的值为此请求中合法数据的长度
		CGI_HTTP_USER_AGENT		提供包含了版本数或其他专有数据的客户浏览器信息
		CGI_HTTP_COOKIE			客户机内的 COOKIE 内容
		
	4.2.函数列表
	
		void CGIGeneralEntironmentInfo()
		
		·CGIGeneralEntironmentInfo
		把所有CGI程序接收到环境变量值发送显示到浏览器上
		
		函数原型：
			void CGIGeneralEntironmentInfo()
		返回值：
			（无）
		
		详细描述与注意事项：
			（无）
		示例代码：
			CGIGeneralEntironmentInfo();
		相关函数：