## page was renamed from pylonsinstall {{{ 1、创建helloworld项目 paster create --template=pylons helloworld 2、项目目录结构 -helloworld}}} {{{ - helloworld o components o config o controllers o docs o i18n o lib o public o tests o templates o __init__.py o websetup.py - helloworld.egg-info - development.ini - setup.cfg - setup.py}}} . components目录下放置template文件，pylons使用myghty模板； config目录下放置配置文件； controllers目录下放置应用程序，是业务逻辑核心； docs目录下放置文档，可以通过setup.py pudge生成html格式的文档； i18n下放置国际化语言； lib放置多个controller之间共享的文件，或者第三方程序等等； public目录下放置HTML, image, javascript, css文件； test目录下放置于test相关的controller，文件等，使用TestGears； template目录下放置template文件，pylons默认使用myghty模板，也可以通过Buffet支持psp，kit，cheetch模板； websetup.py在paster setup.py时执行； __init__.py是初始化helloworld时使用的； {{{ 3、测试 cd helloworld paster serve --reload development.ini 这时，可以通过来访问helloworld paster serve development.ini }}} {{{ 在public目录下创建test.html文件如下： Hello World! }}} 4、debug 可以通过配置development.ini文件修改debug＝false 5、创建一个controller {{{ 首先，创建一个最基本的hello controller paster controller hello 该命令将在controller目录下创建hello.py，同时在tests目录下创建functional/test_hello.py，如下所示： paster controller hello Creating /home/guotie/py/pylons/helloworld/helloworld/controllers/hello.py Creating /home/guotie/py/pylons/helloworld/helloworld/tests/functional/test_hello.py }}} {{{ helloworld/controllers/hello.py文件代码如下： from helloworld.lib.base import *}}} {{{ class HelloController(BaseController): def index(self): m.write('hello world') }}} {{{ pylons使用强大的，灵活的route系统来配置url的route 例如，如果把映射到上，可以修改config/route.py文件，如下： map.connect(':controller/:action/:id') map.connect('', controller='hello', action='index') map.connect('*url', controller='template', action='view') 注意：必须把上面重点强调的语句放在最后一句之前。}}} 6、使用模板 {{{ 创建文件helloworld/templates/serverinfo.myt，如下所示：

Hi, here's the server environment:
<% str(request.environ) %>

}}} {{{

and here's the URL you called: <% h.url_for() %>

}}} 为了是这个模板能够工作，我们需要在前面章节创建的controller hello中，添加对应的方法： def serverinfo(self): . m.subexec('/serverinfo.myt') 访问http://localhost:5000/hello/serverinfo/ 注意： a.上面的函数serverinfo是class HelloController中的方法，因此，必须保持缩进格式；否则，访问出错，报错为： Error(NotImplementedError): Action serverinfos is not implemented b.如果serverinfo.myt不存在，则访问页面错误为HTTP 404。 7、controllers变量，template 全局变量，pylons全局变量从lib.base中导出的全局变量： . session . 存储session data的dict结构，参考myghty docs request . 当前HTTP request对象，对应于myghty中的 r 对象。这个对象包含访问request information的通用的method，如 request.method, request.headers_in, request.headers_out m . m是myghty对象，在myghty docs中详细解释。主要用于template rendering，cacheing等功能 h . h是pylons的helper函数实现点。默认情况下，pylons从web helper包中载入所有的helper函数。记住：在pylons下，我们使用namespaces组织function。 c . 在下一章节讲述 g . 在下一章节讲述 8、向Templates传递参数每个request对应于一个pylons controllers，这意味着你可能需要在不同的controller中传递参数。然而，keep track所有的变量和self的方法是很不方便的，尤其是当你想把它们传递给template时。为了建立可以在template中使用的数据，看看如何做： {{{ hello controller的hello.py： def serverinfo(self): c.value = 2 m.subexec('/serverinfo.myt') }}} {{{ serverinfo.myt如下：

The value of c.value is: <% c.value %> }}} 如果请求一个c上不存在的属性，将会返回空值而不是throw exception。如果请求不存在的变量，则会出错。注意：变量不能使用以下划线“_”开头的变量； . 全局变量c在每一次请求时重置。 9、Application global与永久对象有些场合，你可能需要一些信息对所有controller有效，而不是每次请求都reset。例如，数据库连接是在application load时进行，对所有的请求都有效。 g变量是里lib/app-gloables.py文件中Globals类的一个实例。任何在__init__()中设置的类属性都会在你的pylons应用中作为g的属性有效。在任一request中对g的属性的修改将影响其他request。你必须非常小心设置request中的全局变量。 {{{ 例如，在lib/app_globals.py文件中Globals类中，增加变量message，如下： def __init__(self, defaults, app, **extra): self.message = 'Hello' }}} {{{ 在hellworld/controllers/hello.py中的HelloController增加app_globals_test方法如下： def app_globals_test(self):}}} {{{ if g.message == 'Hello': m.write(g.message) g.message = 'Hello World!' else: m.write(g.message) g.message = 'Hello'}}} ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝ 1、应用部署 {{{ 所有pylons应用的发布都是使用.egg格式完成。egg文件是一个可执行的python包。进入项目的根目录，执行下面的命令： python setup.py bdist_egg }}} 如果一切顺利的话，将会在dist目录下创建egg文件。网管想安装pylons应用时，只需要下子egg并安装它即可。 2、非root用户安装使用“vitual pylons”的方式安装。 3、理解安装过程例如，你写了一个名为helloworld的pylons应用，现在通过一下步骤来安装： a 首先，生成config文件； {{{ 进入项目的根目录，执行下面的命令： python make-config helloword helloworld_production.ini }}} {{{ b 修改生成的ini配置文件 c set-up命令 python set-up helloworld_production.ini }}} {{{ d 部署，这里使用paster serve，也可以使用apache cgi，fastcgi，scgi等 paster serve helloworld_production.ini }}} 4、Make Config paster make-config 命令寻找 “paste_deploy_config.ini_tmpl”文件，并使用该文件作为生成 .ini文件的基础。 paste_deploy_config.ini_tmpl文件位于项目根目录下project.egg-info/目录下。文件内容类似如下： [DEFAULT] debug = true email_to = you@yourdomain.com smtp_server = localhost error_email_from = paste@exceptions.com [server:main] use = egg:Paste #http host = 0.0.0.0 port = 5000 [app:main] use = egg:helloworld cache_dir = %(here)s/cache app_instance_uuid = ${app_instance_uuid} session_key = helloworld session_secret = ${app_instance_secret} ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝配置文件 1、可以通过两种途径配置应用： * 通过应用的config目录 * 通过用户的configuration文件＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝ web-server配置 1、使用Fast-CGI Fast-CGI是连接CGI应用与web服务器之间的网关。pylons能够运行在Fast-CGI上，不管是线程模式还是进程模式。推荐使用线程模式。 {{{ 配置文件非常简单，修改如下：将配置文件 [server:main] use = egg:Paste#http 改为： [server:main] use = egg:PasteScript#flup_fcgi_thread host = 0.0.0.0 port = 6500 }}} {{{ 安装flup软件包。flup是遵守wsgi（python web server gateway interface）的软件包。可以通过easy_install： [sudo] easy_install -U flup }}} {{{ config 文件中的选项传递给flup。运行FastCGI的两种方法是：使用socket监听requests，监听port/host。 socket方式的配置如下： [server:main] use = egg:PasteScript#flup_fcgi_thread socket = /location/to/app.socket }}} port/host的方式的例子如第一个例子。 {{{ 2、Apache配置假设你使用Apache2。首先，Apache需要安装mod_fastcgi;如果apache已经安装fastcgi模块，在apache的配置文件中应该有类似于如下的配置： FastCgiIpcDir /tmp FastCgiExternalServer /some/path/to/app/myapp.fcgi -host some.host.com:6200 }}} {{{ 在apache的配置文件中，还需要有以下指令： AddHandler fastcgi-script .fcgi }}} 然后，配置虚拟host： . . ServerAdmin george@monkey.com ServerName monkey.com ServerAlias [[http://www.monkey.com/|www.monkey.com]] DocumentRoot /some/path/to/app ScriptAliasMatch ^(/.*)$ /some/path/to/app/myapp.fcgi$1 还有一些其他有用的指令，例如ErrorLog myapp.fcgi如下： . #!/usr/bin/env python # Load the WSGI application from the config file from paste.deploy import loadapp . wsgi_app = loadapp('config:/apps/myapp/myapp.ini') # Deploy it using FastCGI from flup.server.fcgi import WSGIServer . WSGIServer(wsgi_app).run() 必须将myapp.fcgi的权限设置为755。当myapp.fcgi不存在时，apache出错如下： [Thu Jun 22 16:20:09 2006] [error] [client 10.10.136.96] (2)No such file or directory: FastCGI: stat() of "/home/guotie/py/pylons/helloworld/myapp.fcgi" failed 在myapp.fcgi的权限没有设置为755时，apache出错如下： [Thu Jun 22 17:26:47 2006] [error] [client 10.10.136.96] FastCGI: invalid (dynamic) server "/home/guotie/py/pylons/helloworld/myapp.fcgi": access for server (uid 33, gid 33) not allowed: execute not allowed 出错如下： [Thu Jun 22 17:31:05 2006] [error] [client 10.10.136.96] FastCGI: incomplete headers (0 bytes) received from server "/home/guotie/py/pylons/helloworld/myapp.fcgi" [Thu Jun 22 17:32:49 2006] [warn] FastCGI: (dynamic) server "/home/guotie/py/pylons/helloworld/myapp.fcgi" has failed to remain running for 30 seconds given 3 attempts, its restart interval has been backed off to 600 seconds 原因查找中。