转自:web.py 0.3 新手指南开始 (仅为自己查看方便而转载。。。)
你知道Python同时你希望制作一个网站。 那么web.py正好提供了一种简单的方法。
如果你希望读完整个指南, 你需要安装Python, web.py, flup, psycopg2, 和Postgres (或者等价的数据库和Python驱动)。 详细,可以查看 webpy.org.
如果你已经有了一个web.py项目,请看看升级 页面的相关信息。
准备开始。
URL 处理
任何网站最重要的部分就是它的URL结构。你的URL并不仅仅只是访问者所能看到并且能发给朋友的。它还规定了你网站运行的心智模型。在一些类似del.icio.us的流行网站 , URL甚至是UI的一部分。 web.py使这类强大的URL成为可能。
在开始你的web.py程序之前,打开一个文本文件(文件名为code.py)输入:
import web
这条语句会导入web.py模块。
现在我们需要把我们的URL结构告诉web.py。让我从下面这个简单的例子开始:
urls = (
'/', 'index'
)
第一部分是匹配URL的正则表达式,像/
、/help/faq
、/item/(\d+)
等(\d+
将匹配数字)。圆括号表示捕捉对应的数据以便后面使用。第二部分是接受请求的类名称,像index
、view
、welcomes.hello
(welcomes
模块的hello
类),或者get_\1
。\1
会被正则表达式捕捉到的内容替换,剩下来捕捉的的内容将被传递到你的函数中去。
这行表示我们要URL/
(首页)被一个叫index
的类处理。
现在我们需要创建一个列举这些url的application。
app = web.application(urls, globals())
这会告诉web.py去创建一个基于我们刚提交的URL列表的application。这个application会在这个文件的全局命名空间中查找对应类。
GET和POST: 区别
现在我们需要来写index
类。虽然大多数人只会看看,并不会注意你的浏览器在使用用于与万维网通信的HTTP语言。具体的细节并不重要,但是要理解web访问者请求web服务器去根据URL(像/
、/foo?f=1
)执行一个合适的函数(像GET
、POST
)的基本思想。
GET
是我们都熟悉的。它用于请求网页文本。当你在浏览器输入harvard.edu
,它会直接访问Harvard的web服务器,去GET /
。 第二个最有名的是POST
,它经常被用在提交form,比如请求买什么东西。每当提交一个去做什么事情(像使用信用卡处理一笔交易)的请求时,你可以使用POST
。这是关键,因为GET
的URL可以被搜索引擎索引,并通过搜索引擎访问。虽然大部分页面你希望被索引,但是少数类似订单处理的页面你是不希望被索引的 (想象一下Google尝试去购买你网站上的所有东西)。
在我们web.py的代码中,我们将这两个方法明确区分:
class index:
def GET(self):
return "Hello, world!"
当有人用GET
请求/
时,这个GET
函数随时会被web.py调用。
好了,限制我们只需要最后一句就写完了。这行会告诉web.py开始提供web页面:
if __name__ == "__main__": app.run()
这会告诉web.py为我们启动上面我们写的应用。
现在注意,即使我已经在这里说了很多,但我们真正有5行这些代码。这就是你需要编写的一个完整的web.py应用。 为了更方便的使用,你的完整代码应该像下面这样:
import web
urls = (
'/', 'index'
)
class index:
def GET(self):
return "Hello, world!"
if __name__ == "__main__":
app = web.application(urls, globals())
app.run()
启动服务
如果你在命令行下面,请输入:: $ python code.py http://0.0.0.0:8080/
现在你的web.py应用正运行在你电脑上的一个真正的web服务器上。 访问那个URL,然后你应该看到”Hello, world!” (你可以通过把IP地址/端口加在”code.py”的后面,来控制web.py在哪里启动服务器。你也可以让它运行在fastcgi
或scgi
服务器上)。
注意: 如果你不能或者不想使用默认端口,你可以使用这样的命令来指定端口号:
$ python code.py 1234
模板
在 Python 中写 HTML 不是聪明的选择,相反在 HTML 中写 Python 则有趣的多。幸运的是,web.py
让这件事情做得简单而又漂亮。
注意: 老版本的 web.py
使用 Cheetah 模板系统,你可以也欢迎使用其他模板系统,但它可能不会被长久支持。
给模板新建一个目录(命名为 templates
),在该目录下新建一个以 .html
结尾的文件,内容如下:
<em>Hello</em>, world!
你也可以在模板中使用 web.py
模板支持代码:
$def with (name)
$if name:
I just wanted to say <em>hello</em> to $name.
$else:
<em>Hello</em>, world!
如上,该模板看起来就像 python 文件一样,除了顶部的 def with
(表示从模板将从这后面取值)和总是位于代码段之前的$
。当前,template.py
首先请求模板文件的首行 $def
。当然,你要注意 web.py
将会转义任何任何用到的变量,所以当你将 name
的值设为是一段 HTML 时,它会被转义显示成纯文本。如果要关闭该选项,可以写成 $:name
来代替 $name
。
回看再看 code.py
。在第一行之下添加:
render = web.template.render('templates/')
这会告诉web.py到你的模板目录中去查找模板。然后把 index.GET
改成: 告诉 web.py
在你的模板目录下查找模板文件。修改 index.GET
:
name = 'Bob'
return render.index(name)
(’index’ 是模板的名字,’name’ 是传入模板的一个参数)
访问站点它将显示 hello Bob。
但是如果我们想让用户自行输入他的名字,么办?如下:
i = web.input(name=None)
return render.index(i.name)
访问 /
将显示 hello world,访问 /?name=Joe
将显示 hello Joe。
URL 的后面的 ?
看起来不好看?修改下 URL 配置:
'/(.*)', 'index'
然后修改下 index.GET
:
def GET(self, name):
return render.index(name)
现在访问 /Joe
看看,它会显示 hello Joe。
如果学习更多关于 web.py 的模板处理,请访问 web.py 模板.
表单
web.py的form模块能够帮助你生成HTML表单;获取用户的输入,并在处理或添加到数据库之前对其进行内容的验证。 如果你要学习更多关于form模块的使用,请查看帮助文档或者Form类库的链接
数据库操作
注意: 在你开始使用数据库之前,确保你已经安装了合适的数据库访问库。比如对于MySQL数据库,使用 MySQLdb ,对于Postgres数据库使用psycopg2。
首先你需要创建一个数据库对象。
db = web.database(dbn='postgres', user='username', pw='password', db='dbname')
(根据需要修改这里 – 尤其是username
、 password
、 dbname
– 。 MySQL用户还需要把 dbn
定义改为 mysql
。)
这就是所有你需要做的 – web.py将会自动处理与数据库的连接和断开。
使用的的数据库引擎管理工具,在你的库中创建一个简单的表:
CREATE TABLE todo (
id serial primary key,
title text,
created timestamp default now(),
done boolean default 'f' );
然后初始化行:
INSERT INTO todo (title) VALUES ('Learn web.py');
我们回来继续编辑 code.py
,把 index.GET
改成下面的样子,替换整个函数:
def GET(self):
todos = db.select('todo')
return render.index(todos)
然后把URL列表改回来,只保留 /
:
'/', 'index',
像这样编辑并替换 index.html
的全部内容:
$def with (todos)
<ul>
$for todo in todos:
<li id="t$todo.id">$todo.title</li>
</ul>
再访问你的网站,然后你可以看到你的todo item: “Learn web.py”。恭喜你!你已经完整地写好了一个可以从数据库读取数据的程序。现在让我们同样再写一个可以把数据写入数据库的程序。
在 index.html
尾部添加:
<form method="post" action="add">
<p><input type="text" name="title" /> <input type="submit" value="Add" /></p>
</form>
然后把你的URL列表改为:
'/', 'index',
'/add', 'add'
(你必须要非常小心那些逗号。如果你省略他们,Python会把所有字符串连接起来,变成 '/index/addadd'
)
现在添加另一个类:
class add:
def POST(self):
i = web.input()
n = db.insert('todo', title=i.title)
raise web.seeother('/')
(注意现在我们正在使用 POST
)
web.input
可以让你访问用户通过form提交的任何数据。
注意: 如果要访问多个相同名字的字段,请使用list的格式(比如:一串name=”name”的多选框):
post_data=web.input(name=[])
db.insert
把数据插入数据表 todo
,然后把新的行号返回给你。 seeother
把用户重定向到指定的URL。
一些快速补充说明: db.update
与 db.insert
差不多,除了它返回的行号是直接从sql语句里面提取的(WHERE ID=2
)。
web.input
、 db.query
已经其他web.py中的函数返回”Storage objects”,这些东西就像字典,你除了可以 d['foo']
之外,你还可以 d.foo
。这可以让代码更加干净。
你可以在the documentation找到这方面具体的细节以及所有web.py的函数说明。
开发
web.py 还有一些帮助我们debug的工具。当它在内建的服务器中运行时,它会一debug模式启动程序。在debug模式中,任何代码、模板的修改,都会让服务器重新加载它们,然后还会输出有用的错误消息。
只有在生产环境中debug模式是关闭的。如果你想禁用debug模式,你可以在创建程序/模板前添加像这样的行。
web.config.debug = False
我们的指南就到这里了。如果要做更多很酷的东西,你可以先查看一下文档。