TranslateProject/published/201412/20141021 How to create and use Python CGI scripts.md

159 lines
7.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

如何创建和使用Python CGI脚本
===
你是否想使用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"
现在尝试请求URLhttp://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脚本的文件扩展名。使用下面的指令
<Directory "/var/www/cgi-bin">
Options +ExecCGI
AddHandler cgi-script .py
</Directory>
下面访问URLhttp://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开始。
<html>
<h1>Test Page 1</h1>
<form name="input" action="/cgi-bin/myscript-1.py" method="get">
<input type="submit" value="Submit">
</form>
</html>
当"提交"按钮被点击,/var/www/cgi-bin/myscript-1.py脚本将被调用(通过action参数指定)。通过设置方法参数为"get"来指定一个"GET"请求,服务器将会返回指定的网页。/var/www/html/page1.html在浏览器中的显示情况如下
![](https://farm4.staticflickr.com/3933/14932853623_eff2df3260_z.jpg)
/var/www/cgi-bin/myscript-1.py的内容如下
#!/usr/bin/python
print "Content-Type: text/html"
print ""
print "<html>"
print "<h2>CGI Script Output</h2>"
print "<p>This page was generated by a Python CGI script.</p>"
print "</html>"
第一行声明表示这是使用 /usr/bin/python命令运行的Python脚本。"Content-Type: text/html"打印语句是必需的这是为了让web服务器知道接受自CGI脚本的输出类型。其余的语句用来输出HTML格式的其余网页内容。
当"Submit"按钮点击,下面的网页将返回:
![](https://farm4.staticflickr.com/3933/15553035025_d70be04470_z.jpg)
这个例子的要点是你可以决定哪些信息可以被CGI脚本返回。这可能包括日志文件的内容当前登陆用户的列表或者今天的日期。在你处理时拥有所有python库的可能性是无穷无尽的。
### 例子2读取并显示用户输入的数据并将结果显示在网页上 ###
对于这个方案,我们将通过创建一个含有三个输入域和一个提交按钮的网页/var/www/html/page2.html开始。
<html>
<h1>Test Page 2</h1>
<form name="input" action="/cgi-bin/myscript-2.py" method="get">
First Name: <input type="text" name="firstName"><br>
Last Name: <input type="text" name="lastName"><br>
Position: <input type="text" name="position"><br>
<input type="submit" value="Submit">
</form>
</html>
当"Submit"按钮点击,/var/www/cgi-bin/myscript-2.py脚本将被执行(通过action参数指定)。/var/www//html/page2.html显示在web浏览器中的图片如下所示(注意,三个输入域已经被填写好了)
![](https://farm4.staticflickr.com/3935/14932853603_ffc3bd330e_z.jpg)
/var/www/cgi-bin/myscript-2.py的内容如下
#!/usr/bin/python
import cgi
form = cgi.FieldStorage()
print "Content-Type: text/html"
print ""
print "<html>"
print "<h2>CGI Script Output</h2>"
print "<p>"
print "The user entered data are:<br>"
print "<b>First Name:</b> " + form["firstName"].value + "<br>"
print "<b>Last Name:</b> " + form["lastName"].value + "<br>"
print "<b>Position:</b> " + form["position"].value + "<br>"
print "</p>"
print "</html>"
正如前面提到import cgi语句用来确保能够处理用户通过web输入表单输入的数据。web输入表单被封装在一个表单对象中叫做cgi.FieldStorage对象。一旦开始输出"Content-Type: text/html"是必需的因为web服务器需要知道接受自CGI脚本的输出格式。用户输入的数据在包含form["firstName"].valueform["lastName"].value和 form["position"].value的语句中可以得到。那些中括号中的名称和**/var/www/html/page2.html**文本输入域中定义的名称参数一致。
当网页上的"Submit"按钮被点击,下面的网页将被返回。
![](https://farm4.staticflickr.com/3949/15367402150_946474dbb0_z.jpg)
这个例子的要点就是你可以很容易地读取并显示用户在web表单上输入的数据。除了以字符串的方式处理数据你也可以用Python将用户输入的数据转化为可用于数值计算的数字。
### 结论 ###
本教程演示了如何使用Python CGI脚本创建网页并处理用户在网页表单输入的数据。查阅更多关于Apache CGI脚本的信息点击[这里][1]。查阅更多关于Python cgi模块的信息点击[这里][2]。
---
via: http://xmodulo.com/create-use-python-cgi-scripts.html
作者:[Joshua Reed][a]
译者:[su-kaiyao](https://github.com/su-kaiyao)
校对:[wxy](https://github.com/wxy)
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创翻译,[Linux中国](http://linux.cn/) 荣誉推出
[a]:http://xmodulo.com/author/joshua
[1]:http://httpd.apache.org/docs/2.2/howto/cgi.html
[2]:https://docs.python.org/2/library/cgi.html#module-cgi