python cgi 程序demo
http://www.yiibai.com/python/python_cgi_programming.html
什么是CGI ?
公共网关接口或CGI，Web服务器和一个自定义的脚本之间交换信息是是一组定义的标准..
CGI规范在由NCSA和NCSA定义的CGI保持如下:
公共网关接口或CGI，如HTTP服务器信息服务器的标准接口是外部网关方案.
当前版本CGI/1.1和CGI/1.2.
网页浏览
理解CGI的概念，让我们看看会发生什么，当我们点击一个超链接到浏览特定网页或URL.
您的浏览器触点的HTTP Web服务器，即需求的URL ie.文件名.
Web服务器解析URL，如果发现该文件，然后发送回浏览器，否则发送错误消息表明您已经请求一个错误的文件.
Web浏览器从Web服务器的响应，并显示收到的文件或错误消息.
但是，它可能设立的HTTP服务器，因此，只要在某个目录中的文件被请求文件送回，而是作为一个程序执行，任何方案产出发送您的浏览器来显示。这个函数被调用的通用网关接口或CGI程序称为CGI脚本。这些CGI程序可以是一个Python脚本，Perl脚本，shell脚本，C或C+ +程序等.
CGI架构图
Web服务器的支持与配置
进行CGI编程之前，确保您的Web服务器，支持CGI，它被配置为CGI程序处理。所有的HTTP服务器执行CGI程序都保存在一个预先配置的目录。这个目录被称为CGI目录，并按照惯例，它被命名为/ var/www/cgi-bin目录。约定CGI文件.cgi扩展名，但你可以保持你的Python扩展的文件.py.
默认情况下，Linux服务器配置只运行在cgi-bin目录中的/var/www脚本。如果你想指定的任何其他运行CGI脚本的目录，内容在httpd.conf文件中的下列行:
AllowOverride None Options ExecCGI Order allow,deny Allow from allOptions All
在这里，我假设你有Web服务器，并成功运行，你可以运行任何其他CGI程序像Perl或shell等.
第一个CGI 程序
下面是一个简单的链接，链接到CGI脚本名为hello.py。此文件被保存在/var/www/cgi-bin目录，它有以下内容。运行CGI程序之前，确保你有CHAGE模式使用 UNIX命令chmod命令 755 hello.py，使文件的可执行文件.
#!/usr/bin/python print "Content-type:text/html\r\n\r\n" print '' print '' print 'Hello Word - First CGI Program' print '' print '' print '
Hello Word! This is my first CGI program
' print '' print ''如果你点击hello.py然后，这将产生以下输出:
Hello Word! This is my first CGI program |
这个的hello.py脚本是一个简单的Python脚本，这是写在stdout文件，即它的输出浏览器的屏幕。有一个重要的和额外的功能，这是第一行要打印的内容类型：文本/html\R\N\R\N。此行被发送回浏览器，并指定内容类型的浏览器屏幕上显示。现在，你必须理解CGI的基本概念，可以使用Python写了许多复杂的CGI程序。这个脚本可以与任何其他扩展系统交换，如RDBMS的信息.
HTTP 头
该行的内容类型：文本/html\R\N\R\n是理解的内容被发送到浏览器的HTTP头的一部分。所有的HTTP报头，将在下列表格
HTTP Field Name: Field Content For Example Content-type: text/html\r\n\r\n
还有其他一些重要的HTTP头，你会经常使用的CGI编程.
| Header | Description |
|---|---|
| Content-type: | A MIME string defining the format of the file being returned. Example is Content-type:text/html |
| Expires: Date | The date the information becomes invalid. This should be used by the browser to decide when a page needs to be refreshed. A valid date string should be in the format 01 Jan 1998 12:00:00 GMT. |
| Location: URL | The URL that should be returned instead of the URL requested. You can use this filed to redirect a request to any file. |
| Last-modified: Date | The date of last modification of the resource. |
| Content-length: N | The length, in bytes, of the data being returned. The browser uses this value to report the estimated download time for a file. |
| Set-Cookie: String | Set the cookie passed through the string |
CGI环境变量
所有的CGI程序，将有机会获得以下环境变量。编写任何CGI程序，这些变量发挥了重要作用.
| Variable Name | Description |
| CONTENT_TYPE | The data type of the content. Used when the client is sending attached content to the server. For example file upload etc. |
| CONTENT_LENGTH | The length of the query information. It's available only for POST requests |
| HTTP_COOKIE | Return the set cookies in the form of key & value pair. |
| HTTP_USER_AGENT | The User-Agent request-header field contains information about the user agent originating the request. Its name of the web browser. |
| PATH_INFO | The path for the CGI script. |
| QUERY_STRING | The URL-encoded information that is sent with GET method request. |
| REMOTE_ADDR | The IP address of the remote host making the request. This can be useful for logging or for authentication purpose. |
| REMOTE_HOST | The fully qualified name of the host making the request. If this information is not available then REMOTE_ADDR can be used to get IR address. |
| REQUEST_METHOD | The method used to make the request. The most common methods are GET and POST. |
| SCRIPT_FILENAME | The full path to the CGI script. |
| SCRIPT_NAME | The name of the CGI script. |
| SERVER_NAME | The server's hostname or IP Address |
| SERVER_SOFTWARE | The name and version of the software the server is running. |
这里是小的CGI程序列出所有的CGI变量。
#!/usr/bin/python import os print "Content-type: text/html\r\n\r\n"; print "Environment<\br>"; for param in os.environ.keys(): print "%20s: %s<\br>" % (param,os.environ[param])
GET和POST 方法
你所遇到的许多情况下，当您需要从您的浏览器，Web服务器，并最终给你的CGI程序传递一些信息。最常用的浏览器使用两种方法将此信息传递到Web服务器。这些方法是GET方法和POST方法.
使用GET方法传递信息:
GET方法发送编码的用户信息添加到页面请求。分隔页和编码信息？字符作为如下:
http://www.test.com/cgi-bin/hello.py?key1=value1&key2=value2
GET方法是defualt从浏览器向Web服务器的方法来传递信息，它会产生一个很长的字符串出现在浏览器的位置：框。切勿使用GET方法，如果你有密码或其他敏感信息传递给服务器。 GET方法尺寸limtation：只有1024个字符，可以在请求字符串.
此信息通过使用QUERY_STRING的头，将通过QUERY_STRING环境变量在你的CGI程序访问
你可以通过简单的连接键和值对非常久远的任何URL的信息，或您可以使用HTML标签来传递信息，使用GET方法.
简单 URL 例子 : Get 方法
这里是一个简单的URL使用GET方法，这将通过两个值hello_get.py方案.
下面是hello_get.py的脚本来处理给定的输入网页浏览器。我们要使用CGI模块，这使得它很容易访问传递的信息:
#!/usr/bin/python
# Import modules for CGI handling
import cgi, cgitb
# Create instance of FieldStorage
form = cgi.FieldStorage()
# Get data from fields
first_name = form.getvalue('first_name')
last_name = form.getvalue('last_name')
print "Content-type:text/html\r\n\r\n"
print ""
print ""
print "Hello - Second CGI Program"
print ""
print ""
print "
Hello %s %s
" % (first_name, last_name) print "" print ""This would generate following result:
Hello ZARA ALI |
简单的FORM 例子：GET方法
下面是一个简单的例子，通过这两个值，使用HTML表单和提交按钮。我们将使用相同的CGI脚本hello_get.py的处理此输入.
First Name:Last Name:
这里是上述形式的实际输出，输入第一个和最后一个名称，然后点击提交按钮来查看结果.
First Name:
Last Name:
使用POST方法传递信息:
更可靠的信息传递给CGI程序的一般方法是POST方法。这包装完全相同的方式为GET方法的信息，而是它作为一个文本字符串发送后？在URL中发送它作为一个单独的消息。此消息来自标准输入的形式到CGI脚本.
下面是同hello_get.py脚本处理的GET以及POST方法.
#!/usr/bin/python
# Import modules for CGI handling
import cgi, cgitb
# Create instance of FieldStorage
form = cgi.FieldStorage()
# Get data from fields
first_name = form.getvalue('first_name')
last_name = form.getvalue('last_name')
print "Content-type:text/html\r\n\r\n"
print ""
print ""
print "Hello - Second CGI Program"
print ""
print ""
print "
Hello %s %s
" % (first_name, last_name) print "" print ""让我们再次看同以上相同的例子，其中通过两个值，使用HTML表单和提交按钮。我们将使用相同的CGI脚本hello_get.py的处理此输入.
First Name:Last Name:
这里是上述形式的实际输出，输入第一个和最后一个名称，然后点击提交按钮来查看结果.
First Name:
Last Name:
传递复选框(checkbox)数据给CGI程序
复选框用于多个选项被选中时，.
这里有两个复选框的形式例如HTML代码
Maths Physics
这段代码的结果是下面的形式
Maths Physics下面是checkbox.cgi脚本来处理给定的输入网页浏览器“复选框按钮.
#!/usr/bin/python
# Import modules for CGI handling
import cgi, cgitb
# Create instance of FieldStorage
form = cgi.FieldStorage()
# Get data from fields
if form.getvalue('maths'):
math_flag = "ON"
else:
math_flag = "OFF"
if form.getvalue('physics'):
physics_flag = "ON"
else:
physics_flag = "OFF"
print "Content-type:text/html\r\n\r\n"
print ""
print ""
print "Checkbox - Third CGI Program"
print ""
print ""
print "
CheckBox Maths is : %s
" % math_flag print "CheckBox Physics is : %s
" % physics_flag print "" print ""单选按钮数据传递给CGI程序
单选按钮被选中时，只有一个选项是必需的.
这里是两个单选按钮的形式例如HTML代码:
MathsPhysics
这段代码的结果是下面的形式
Maths Physics Physics下面是radiobutton.py脚本来处理单选按钮的网页浏览器输入.
#!/usr/bin/python
# Import modules for CGI handling
import cgi, cgitb
# Create instance of FieldStorage
form = cgi.FieldStorage()
# Get data from fields
if form.getvalue(" subject'):="" subject="form.getvalue('subject')" else:="" print="" "content-type:text="" html\r\n\r\n"="" ""="" "radio="" -="" fourth="" cgi="" program"="" "Selected Subject is %s" % subject
print ""
print ""
="">
文本区域数据传递到CGI程序
TEXTAREA元素时使用多行文字要传递给CGI程序.
这里是一个textarea框的形式例如HTML代码:
Type your text here...
下面是textarea.cgi的脚本来处理给定的输入网页浏览器.
#!/usr/bin/python
# Import modules for CGI handling
import cgi, cgitb
# Create instance of FieldStorage
form = cgi.FieldStorage()
# Get data from fields
if form.getvalue('textcontent'):
text_content = form.getvalue('textcontent')
else:
text_content = "Not entered"
print "Content-type:text/html\r\n\r\n"
print ""
print "";
print "Text Area - Fifth CGI Program"
print ""
print ""
print "
Entered Text Content is %s
" % text_content print ""通过下拉框数据到CGI程序
下拉框是用来当我们有很多可供选择，但只有一个或两个将被选中.
这里是一个下拉框的例子表单的HTML代码
MathsPhysics
这段代码的结果是下面的形式
下面是dropdown.py脚本来处理给定的输入网页浏览器.
#!/usr/bin/python
# Import modules for CGI handling
import cgi, cgitb
# Create instance of FieldStorage
form = cgi.FieldStorage()
# Get data from fields
if form.getvalue('dropdown'):
subject = form.getvalue('dropdown')
else:
subject = "Not entered"
print "Content-type:text/html\r\n\r\n"
print ""
print ""
print "Dropdown Box - Sixth CGI Program"
print ""
print ""
print "
Selected Subject is %s
" % subject print "" print ""使用CGI中的Cookies
HTTP协议是无状态的协议。但是，对于一个商业网站，它需要保持不同的页面之间的会话信息。例如，一个用户注册完成后，许多网页结束。但如何保持用户会话信息的所有网页.
在许多情况下，使用Cookie的记忆和跟踪首选项，购买，佣金，其他更好的游客体验或网站统计所需的信息是最有效的方法.
它如何工作？
你的服务器发送一些数据到访问者的浏览器Cookie的形式。浏览器可以接受的cookie。如果是这样，它是作为一个访问者的硬盘驱动器上的纯文本记录存储。现在，当游客到达另一个网站上的网页，cookie是用于检索。一旦检索，您的服务器知道/记得存储.
Cookie是一个纯文本的数据5可变长度字段记录:
Expires : cookie将到期日期。如果是空白，访问者退出浏览器时，cookie将到期.
Domain : 您的网站域名.
Path : 目录或网页设置cookie的路径。这可能是空白的，如果你想从任何目录或页面的cookie检索.
Secure : 目录或网页设置cookie的路径。这可能是空白的，如果你想从任何目录或页面的cookie检索.
Name=Value : Cookies是键和值对的形式设置和retrviewed.
设置Cookies
这是很容易发送到浏览器的cookies。这些cookie将被发送HTTP头之前的内容类型提交。假设你要设置用户名和密码的cookie。因此Cookie的设置将做如下
#!/usr/bin/python print "Set-Cookie:UserID=XYZ;\r\n" print "Set-Cookie:Password=XYZ123;\r\n" print "Set-Cookie:Expires=Tuesday, 31-Dec-2007 23:12:40 GMT";\r\n" print "Set-Cookie:Domain=www.yiibai.com;\r\n" print "Set-Cookie:Path=/perl;\n" print "Content-type:text/html\r\n\r\n" ...........Rest of the HTML Content....
从这个例子中，你必须了解如何设置Cookie。我们使用设置CookieHTTP的头设置Cookie.
在这里，它是可选的设置Cookie的属性，如过期，域和路径。值得注意的是，Cookie的之前发送行头 "Content-type:text/html\r\n\r\n.
找回Cookie
这是非常方便地检索所有的设置Cookie。 Cookie是存储在CGI环境变量HTTP_COOKIE的，他们将有以下的形式.
key1=value1;key2=value2;key3=value3....
下面是一个如何获取Cookie的例子.
#!/usr/bin/python
# Import modules for CGI handling
from os import environ
import cgi, cgitb
if environ.has_key('HTTP_COOKIE'):
for cookie in map(strip, split(environ['HTTP_COOKIE'], ';')):
(key, value ) = split(cookie, '=');
if key == "UserID":
user_id = value
if key == "Password":
password = value
print "User ID = %s" % user_id
print "Password = %s" % password
这将产生以下结果由上面的脚本设置的cookie:
User ID = XYZ Password = XYZ123
文件上传的例子:
上传文件的HTML表单必须有enctype属性设置了multipart / form-数据。与该文件类型的输入标记将创建一个“浏览”按钮.
File:
这段代码的结果是下面的形式:
注: 上面的例子已被禁用，故意人上传的文件保存在我们的服务器上。但你可以尝试上面的代码与您的服务器.
这里是处理文件上传的的脚本save_file.py:
#!/usr/bin/python
import cgi, os
import cgitb; cgitb.enable()
form = cgi.FieldStorage()
# Get filename here.
fileitem = form['filename']
# Test if the file was uploaded
if fileitem.filename:
# strip leading path from file name to avoid
# directory traversal attacks
fn = os.path.basename(fileitem.filename)
open('/tmp/' + fn, 'wb').write(fileitem.file.read())
message = 'The file "' + fn + '" was uploaded successfully'
else:
message = 'No file was uploaded'
print """\
Content-Type: text/html\n
%s
""" % (message,)Note:如果你是以上脚本运行在Unix / Linux，那么你会采取如下替换文件分隔，否则您的Windows上述open（）语句应该正常工作.
fn = os.path.basename(fileitem.filename.replace("\\", "/" ))
如何提高“文件下载”对话框 ?
有时你想给其中一个用户点击一个链接，它会弹出“文件下载”对话框的用户，而不是显示实际内容的选项。这是很容易的，将通过HTTP头achived。
这个HTTP头会从上一节中提到的头是不同的.
例如，如果你想从一个给定的链接文件名文件下载，那么它的语法如下.
#!/usr/bin/python
# HTTP Header
print "Content-Type:application/octet-stream; name=\"FileName\"\r\n";
print "Content-Disposition: attachment; filename=\"FileName\"\r\n\n";
# Actual File Content will go hear.
fo = open("foo.txt", "rb")
str = fo.read();
print str
# Close opend file
fo.close()