web.py 是一个轻量级Python web框架，它简单而且功能强大。web.py是一个开源项目。该框架由已故美国作家、Reddit联合创始人、RSS规格合作创造者、著名计算机黑客Aaron Swartz开发。web.py已被很多家大型网站所使用。

解压并拷贝 web 文件夹到你的应用程序目录下。 或者，为了让所有的应用程序都可以使用，运行：

python setup.py install

注意: 在某些类unix系统上你可能需要切换到root用户或者运行：

sudo python setup.py install

查看 推荐设置.

另外一个选择是使用Easy Install. Easy Install 使用如下：

easy_install web.py

或者 PIP

sudo pip install web.py

安装完毕之后，就可以正式开始web.py 之旅…

对于一个站点来说，URL 的组织是最重要的一个部分，因为这是用户看得到的部分，而且直接影响到站点是如何工作的，在著名的站点如：del.icio.us ，其URLs 甚至是网页界面的一部分。而web.py 以简单的方式就能够构造出一个强大的URLs。

在每个web.py 应用，必须先import web 模块：

import web

我们须要告诉web.py URL 如何组织，让我们以一个简单例子开始：

urls = (

'/', 'index' )

我们需要编写index 类。当大部人浏览网页的时候，他们都没有注意到，浏览器是通过HTTP 跟World Wide Web 通信的。通信的细节不太重要，但要明白一点，用户是通过URLs（例如 / 或者 /foo?f=1）来请求web 服务器完成一定请求的（例如 GET 或者POST）。

GET 是最普遍的方法，用来请求一个页面。当我们在浏览器里输入“harvard.edu” 的时候，实际上它是向Web 服务器请求GET ”/“。另一个常见的方法是POST，常用于提交特定类型的表单，例如利用信用卡付费和处理一个订单。注意，GET URLs 能够被搜索引擎索引得到（想像一下Google 尝试购买你网站上的所用物品）。

在我们的web.py 代码中。我们清晰区分这两种方法：

class index:

def GET(self):

当接收到一个GET 请求时，上面的GET 方法将会被web.py 调用。

好的。我们只需添加最后一行代码，让web.py 启动网页应用：

上面告诉web.py 如何配置URLs，以及找寻的类在文件中的全局命名空间。

整个code.py 文件的内容如下：

import web

urls = ('/', 'index')

app = web.application(urls, globals())

class index:

def GET(self):

app.run()

注意到没有，虽然我说了很多东西，但实际上web 应用的代码就只得上面的几行，而且这是一个完整的web.py 应用。在你的命令行下输入：

$ python code.py

Launching server: http://0.0.0.0:8080/

你的web.py 应用已经启动了服务器。通过浏览器访问http://localhost:8080/ 的话，会见到”Hello, world！“。在启动服务器的时候，你可以在python code.py 后面添加IP 地址/端口 来控制web.py 启动的服务器。例如：python code.py 8888。

web.py 本身也提供调试的工具。在最后的“if name …” 代码前面添加：

web.webapi.internalerror = web.debugerror

并在最后的“if name …” 添加”web.reloader“：

上面的代码会使你在调试的阶段得到更多有用的信息。web.reloader 其实是一个中间件，当你在运行时修改了code.py 文件后，web.reloader 会重新加载code.py 文件，让你在浏览器上立刻可以看到变化。如何有多何变化的话，还是需要重新启动服务器。web.py 也提供web.profiler ,可以输出有用的信息，有关每个页面的每个函数调用的次数，这用助于你改善代码。

web.py 的确相当的小巧，应当归属于轻量级的web 框架。但这并不影响web.py 的强大，而且使用起来很简单、很直接。在实际应用上，web.py 更多的是学术上的价值，因为你可以看到更多web 应用的底层，这在当今“抽象得很好”的web 框架上是学不到的 ， 如果想了解更多web.py，可以访问web.py 的官方文档。

web.py 内置了web服务器。可以按照 tutorial 学习如何写一个Web应用。 写完后，将你的代码放到 code.py 并如下面的方法来启动服务器：

python code.py

打开你的浏览器输入 http://localhost:8080/ 查看页面。 若要制定另外的端口，使用 python code.py 1234。

所运行 web.py 程序的web服务器是挺不错的， 但绝大多数网站还是需要更加专业一些的web服务器。web.py 实现了 WSGI 并能在任何兼容它的服务器上运行。 WSGI 是一个web服务器与应用程序之间的通用API, 就如Java 的 Servlet 接口。 你需要安装 flup (download here) 使web.py 支持with CGI， FastCGI 或 SCGI， flup提供了这些API的WSGI接口。

对于所有的CGI变量， 添加以下到你的 code.py:

#!/usr/bin/env python

并运行 chmod +x code.py 添加可执行属性。

LightTPD

在产品中通过FastCGI结合lighttpd是web.py使用的一种推荐方法。 reddit.com 通过该方法来处理百万次的点击。

lighttpd config设置参考如下：

))

)

url.rewrite-once = (

)

从修订版本 145开始， 如果你的代码使用了重定向，还需要在fastcgi选项下设置bin-environment变量。 如果你的代码重定向到http://domain.com/ 而在url栏中你会看到 http://domain.com/code.py/， 你可以通过设置这个环境变量来阻止。 这样你的fastcgi.server设置将会如下：

((

),

))

)

Apache

使用 CGI

添加以下到 httpd.conf 或 apache2.conf。

Alias /foo/static/ /path/to/static

ScriptAlias /foo/ /path/to/code.py

.. 使用 CGI .htaccess

CGI很容易配置， 但不适合高性能网站。 添加以下到你的 .htaccess：

Options +ExecCGI

AddHandler cgi-script .py

将你的浏览器指向 http://example.com/code.py/。 不要忘记最后的斜杠，否则你将会看到 not found 消息 (因为在 urls 列表中你输入的没有被匹配到). 为了让其运行的时候不需要添加 code.py， 启用mod_rewrite 法则 (查看如下)。

注意: web.py 的实现破坏了 cgitb 模块，因为它截取了 stdout。 可以通过以下的方法来解决该问题：

import cgitb; cgitb.enable()

import sys

# ... import web etc here...

def cgidebugerror():

sys.stdout = web._oldstdout

cgitb.handler()

sys.stdout = _wrappedstdout

web.internalerror = cgidebugerror

FastCGI很容易配置，运行方式如同mod_python。

添加以下到 .htaccess：