你是否想使用python语言创建一个网页,或者处理用户从web表单输入的数据?这些任务可以通过python cgi(公用网关接口)脚本以及一个apache web服务器实现。当用户请求一个指定url或者和网页交互(比如点击””提交”按钮)的时候,cgi脚本就会被web服务器启用。cgi脚本调用执行完毕后,它的输出结果就会被web服务器用来创建显示给用户的网页。
配置apache web服务器,让其能运行cgi脚本
在这个教程里,我们假设apache web服务器已经安装好,并已运行。这篇教程使用的apache web服务器(版本2.2.15,用于centos发行版6.5)运行在本地主机(127.0.0.1),并且监听80端口,如下面的apache指令指定一样:
代码如下:
servername 127.0.0.1:80
listen 80
下面举例中的html文件存放在web服务器上的/var/www/html目录下,并通过documentroot指令指定(指定网页文件所在目录):
代码如下:
documentroot “/var/www/html”
现在尝试请求url:http://localhost/page1.html
这将返回web服务器中下面文件的内容:
代码如下:
/var/www/html/page1.html
为了启用cgi脚本,我们必须指定cgi脚本在web服务器上的位置,需要用到scriptalias指令:
代码如下:
scriptalias /cgi-bin/ “/var/www/cgi-bin/”
以上指令表明cgi脚本保存在web服务器的/var/www/cgi-bin目录,请求url里包含/cgi-bin/的将会搜索这个目录下的cgi脚本。
我们必须还要明确cgi脚本在/var/www/cgi-bin目录下有执行权限,还要指定cgi脚本的文件扩展名。使用下面的指令:
options +execcgi
addhandler cgi-script .py
下面访问url:http://localhost/cgi-bin/myscript-1.py
这将会调用web服务器中下面所示脚本:
代码如下:
/var/www/cgi-bin/myscript-1.py
创建一个cgi脚本
在创建一个python cgi脚本之前,你需要确认你已经安装了python(这通常是默认安装的,但是安装版本可能会有所不同)。本篇教程使用的脚本是使用python版本2.6.6编写的。你可以通过下面任意一命令(-v和–version参数将显示所安装python的版本号)检查python的版本。
$ python -v
$ python –version
如果你的python cgi脚本要用来处理用户输入的数据(从一个web输入表单),那么你将需要导入python cgi模块。这个模块可以处理用户通过web输入表单输入的数据。你可以在你的脚本中通过下面的语句导入该脚本:
import cgi
你也必须修改python cgi脚本的执行权限,以防止web服务器不能调用。可以通过下面的命令增加执行权限:
# chmod o+x myscript-1.py
python cgi例子
涉及到python cgi脚本的两个方案将会在下面讲述:
使用python脚本创建一个网页
读取并显示用户输入的数据,并且在网页上显示结果
注意:python cgi模块在方案2中是必需的,因为这涉及到用户从web表单输入数据。
例子1 :使用python脚本创建一个网页
对于这个方案,我们将通过创建包含一个单一提交按钮的网页/var/www/html/page1.html开始。
test page 1
当”提交”按钮被点击,/var/www/cgi-bin/myscript-1.py脚本将被调用(通过action参数指定)。通过设置方法参数为”get”来指定一个”get”请求,服务器将会返回指定的网页。/var/www/html/page1.html在浏览器中的显示情况如下:
/var/www/cgi-bin/myscript-1.py的内容如下:
#!/usr/bin/python
print “content-type: text/html”
print “”
print “”
print “cgi script output”
print “
this page was generated by a python cgi script.
”
print “”
第一行声明表示这是使用 /usr/bin/python命令运行的python脚本。”content-type: text/html”打印语句是必需的,这是为了让web服务器知道接受自cgi脚本的输出类型。其余的语句用来输出html格式的其余网页内容。
当”submit”按钮点击,下面的网页将返回:
这个例子的要点是你可以决定哪些信息可以被cgi脚本返回。这可能包括日志文件的内容,当前登陆用户的列表,或者今天的日期。在你处理时拥有所有python库的可能性是无穷无尽的。
例子2:读取并显示用户输入的数据,并将结果显示在网页上
对于这个方案,我们将通过创建一个含有三个输入域和一个提交按钮的网页/var/www/html/page2.html开始。
test page 2
first name:
last name:
position:
当”submit”按钮点击,/var/www/cgi-bin/myscript-2.py脚本将被执行(通过action参数指定)。/var/www//html/page2.html显示在web浏览器中的图片如下所示(注意,三个输入域已经被填写好了):
/var/www/cgi-bin/myscript-2.py的内容如下:
#!/usr/bin/python
import cgi
form = cgi.fieldstorage()
print “content-type: text/html”
print “”
print “”
print “cgi script output”
print “
”
print “the user entered data are:”
print “first name: ” + form[“firstname”].value + “”
print “last name: ” + form[“lastname”].value + “”
print “position: ” + form[“position”].value + “”
print “
”
print “”
正如前面提到,import cgi语句用来确保能够处理用户通过web输入表单输入的数据。web输入表单被封装在一个表单对象中,叫做cgi.fieldstorage对象。一旦开始输出,”content-type: text/html”是必需的,因为web服务器需要知道接受自cgi脚本的输出格式。用户输入的数据在包含form[“firstname”].value,form[“lastname”].value,和 form[“position”].value的语句中可以得到。那些中括号中的名称和/var/www/html/page2.html文本输入域中定义的名称参数一致。
当网页上的”submit”按钮被点击,下面的网页将被返回。
这个例子的要点就是你可以很容易地读取并显示用户在web表单上输入的数据。除了以字符串的方式处理数据,你也可以用python将用户输入的数据转化为可用于数值计算的数字。