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' )

在上面的例子中，第一部分（‘/’）是一個匹配URL 的正則表達式，像/，/help/faq，/item/(\d+)，等等；第二部分（‘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):

return "Hello, world!"

當接收到一個GET 請求時，上面的GET 方法將會被web.py 調用。

好的。我們只需添加最後一行代碼，讓web.py 啓動網頁應用：

if __name__ == "__main__": web.run(urls, globals())

上面告訴web.py 如何配置URLs，以及找尋的類在文件中的全局命名空間。

整個code.py 文件的內容如下：

import web

urls = ('/', 'index')

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

class index:

def GET(self):

return "Hello world!"

if __name__ == "__main__":

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“：

if __name__ == "__main__": web.run(urls, globals(), 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設置參考如下：

server.modules = ("mod_fastcgi", "mod_rewrite")

server.document-root = "/path/to/root/"

fastcgi.server = ( "/code.py" =＞

(( "socket" =＞ "/tmp/fastcgi.socket",

"bin-path" =＞ "/path/to/root/code.py",

"max-procs" =＞ 1

))

)

url.rewrite-once = (

"^/favicon.ico$" =＞ "/static/favicon.ico",

"^/static/(.*)$" =＞ "/static/$1",

"^/(.*)$" =＞ "/code.py/$1"

)

在某些版本的lighttpd中， 需要保證fastcgi.server選項下的"check-local"屬性設置為"false", 特別是當你的 code.py 不在文檔根目錄下。

如果你得到錯誤顯示不能夠導入flup， 請在命令行下輸入 "easy_install flup" 來安裝。

從修訂版本 145開始， 如果你的代碼使用了重定向，還需要在fastcgi選項下設置bin-environment變量。 如果你的代碼重定向到http://domain.com/ 而在url欄中你會看到 http://domain.com/code.py/， 你可以通過設置這個環境變量來阻止。 這樣你的fastcgi.server設置將會如下：

fastcgi.server = ( "/code.py" =＞

((

"socket" =＞ "/tmp/fastcgi.socket",

"bin-path" =＞ "/path/to/root/code.py",

"max-procs" =＞ 1,

"bin-environment" =＞ (

"REAL_SCRIPT_NAME" =＞ ""

),

"check-local" =＞ "disable"

))

)

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():

"""

""" _wrappedstdout = sys.stdout

sys.stdout = web._oldstdout

cgitb.handler()

sys.stdout = _wrappedstdout

web.internalerror = cgidebugerror

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

添加以下到 .htaccess：

<Files code.py＞ SetHandler fastcgi-script

</Files＞

不幸的是, 不像lighttpd, Apache不能夠暗示你的web.py腳本以FastCGI 服務器的形式工作，因此你需要明確的告訴web.py。 添加以下到 code.py的 if __name__ == "__main__": 行前：

web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, addr)

將你的瀏覽器指向 http://example.com/code.py/。 不要忘記最後的斜槓，否則你將會看到 not found 消息 (因為在 urls 列表中你輸入的沒有被匹配到). 為了讓其運行的時候不需要添加 code.py， 啓用mod_rewrite 法則 (查看如下)。

Walter 還有一些額外建議.

https://www.mems-exchange.org/software/scgi/ 從 http://www.mems-exchange.org/software/files/mod_scgi/ 下載 mod_scgi 代碼 windows apache 用户： 編輯 httpd.conf：

LoadModule scgi_module Modules/mod_scgi.so

SCGIMount / 127.0.0.1:8080

重啓apache，並在命令行中如下方式啓動code.py：

python code.py 127.0.0.1:8080 scgi

打開你的瀏覽器，訪問127.0.0.1 It's ok!

.. 使用 mod_python

mod_python 運行方式如同FastCGI， 但不是那麼方便配置。

對於 Python 2.5 按照如下：

cd /usr/lib/python2.5/wsgiref

# or in windows: cd /python2.5/lib/wsgiref

wget -O modpython_gateway.py http://projects.amor.org/misc/browser/modpython_gateway.py?format=raw

# or fetch the file from that address using your browser

對於 Python <2.5 按照如下：

cd /usr/lib/python2.4/site-packages

# or in windows: cd /python2.4/lib/site-packages

svn co svn://svn.eby-sarna.com/svnroot/wsgiref/wsgiref

cd wsgiref

wget -O modpython_gateway.py http://projects.amor.org/misc/browser/modpython_gateway.py?format=raw

# or fetch the file from that address using your browser

重命名 code.py 為 codep.py 或別的名字， 添加：

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

main = app.wsgifunc()

在 .htaccess 中， 添加：

AddHandler python-program .py

PythonHandler wsgiref.modpython_gateway::handler

PythonOption wsgi.application codep::main

你應該希望添加 RewriteRule 將 / 指向 /codep.py/

確保訪問 /codep.py/ 的時候有添加最後的 /。 否則，你將會看到一條錯誤信息，比如 A server error occurred. Please contact the administrator.

.. 使用 mod_wsgi

mod_wsgi 是一個新的Apache模塊 通常優於mod_python 用於架設WSGI應用，它非常容易配置。

在 code.py 的最後添加：

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

application = app.wsgifunc()

mod_wsgi 提供 許多可行方法 來實現WSGI應用, 但一種簡單的方法是添加以下到 .htaccess：

<Files code.py＞

SetHandler wsgi-script

Options ExecCGI FollowSymLinks

</Files＞

如果在apache的 error.log 文件中出現 "ImportError: No module named web"， 在導入web之前，你可能需要在code.py中嘗試設置絕對路徑：

import sys, os

abspath = os.path.dirname(__file__)

sys.path.append(abspath)

os.chdir(abspath)

import web

同時， 你可能需要查看 WSGI應用的常見問題的 "Application Working Directory" 部分。

最終應該可以訪問 http://example.com/code.py/。

mod_rewrite 法則，Apache

如果希望 web.py 能夠通過 'http://example.com' 訪問，代替使用 'http://example.com/code.py/'， 添加以下法則到 .htaccess 文件：

<IfModule mod_rewrite.c＞

RewriteEngine on

RewriteBase /

RewriteCond %{REQUEST_URI} !^/icons

RewriteCond %{REQUEST_URI} !^/favicon.ico$

RewriteCond %{REQUEST_URI} !^(/.*)+code.py/

RewriteRule ^(.*)$ code.py/$1 [PT]

</IfModule＞

如果 code.py 在子目錄 myapp/中， 調整 RewriteBase 為 RewriteBase /myapp/。 如果還有一些靜態文件如CSS文件和圖片文件, 複製這些並改成你需要的地址。