转自http://blog.csdn.net/xbl1986/article/details/6242634

karrigell是一个用python写的web框架，我目前认为它就是个服务器就好了。

去sourceforge.net上面搜索karrigell然后下载最新版，它的法国官网我老是访问不上去。

目前我下载的最新版是3.1.1的，有linux版本的，有windows版本的。

不管是哪个版本的，都要保证系统上有Python环境，最差2.5的吧。


有四个可以运行的文件，都是.py结尾的，在解压出来的根目录。windows下面是.exe结尾的，双击会出来cmd窗口。

1. Karrigell.py 多线程

2. Karrigell_mutiprocess.py 多进程

3. Karrigell_async.py 同步，使用非阻塞套接字

4. Karrigell_monoprocess.py 单进程，使用阻塞套接字

大多数情况下使用前两个文件，已经够用了。后面两个结构性能低，用在低内存的情况下。


说道web服务器，apache太有名了。karrigell也集成了apache进去：

模式        描述        优点            缺点

CGI模式     请求被GCI   兼容所有的      CGI的开销降低了性能

           脚本处理    web主机

                       不会阻塞长时间

                       运行请求(每个

                       请求在不同的

                       进程里)


WSGI模式    使用WSGI    良好的性能      需要mod_wsgi模块

           标准，依赖  WSGI是事实上    有些主机上没有

           mod_wsgi    的框架继承标准


mod_python  在apache服  良好的性能      需要安装mod_python模块

模式        务器上嵌入  没有CGI开销     标准主机上没有

           一个python

           解释器


Proxy模式   运行在后台  良好的性能      要求在服务器上

           的集成web   回话对象可以在  有权限运行一个

           服务，apache 内存中管理     长时间运行的程序

           发送所有请求

           给它，然后

           它返回结果

           给客户端


让karrigell运行在apache后面，需要修改一些apache的配置，比如http.conf，.htaccess文件等。

目前我们纯运行karrigell，因此先不考虑这两个融合的事情。


URL解决方案

对于静态文件

放在根目录下的可以直接读取，根目录下的子目录下的文件会加上子目录的路径

别名

对于放在根目录外的文件通过修改配置文件中的别名来访问

缺省文件扩展

如果文件扩展没有指定，服务器将会寻找html,htm,py,pih,hip,ks等扩展。如果找到了就使用；如果找到了不止一个，会引发一个异常；如果没有找到，也会引发一个异常。

目录

如果在url匹配的目录下没有被指定的文件，服务器会寻找index.html, index.htm, index.py, index.pih, index.hip, index.ks。如果找到一个，就使用这个文件，如果找到多于一个，就引发一个异常。如果找不到，那么行为则依赖于配置文件中的all_directory_listing选项，是否要显示文件目录，或者返回一个错误信息。


目录们

karrigell以组织好的目录进行发布。在你安装包的时候这些目录就缺省了，但是你可以改变这些值，在配置文件中。

下面描述一下默认的目录结构


1.

karrigell.py

server_config.py

default_host_conf.py

hosts


位于服务器目录


在顶层目录，是管理服务器的脚本

karrigell.py和其他的脚本用来启动服务器

server_config.py定义了服务器选项

default_host_conf.py是主机的默认配置选项

hosts是一个文本文件，里面有主机名和它们的配置文件所在地


2.

+karrigell

   +core

   +package

   +...


位于karrigell目录

是karrigell框架脚本

core是karrigell核心脚本

package可以在用户定义脚本中导入的模块


3.

+data

   +www

       +sessions

       conf.py


位于data目录

存储服务器默认主机的所有信息，默认主机的信息存在子目录www中

conf.py这个主机的配置信息

sessions一个存储会话信息的目录

日志文件，用户数据也存在这个子目录里


4.

+www

   index.pih

   ...


默认主机的根目录

这是默认主机的根目录：当请求http://localhost时所寻找的目录

这个目录包含脚本index.py,用来提供页面服务

注意这个根目录是www，和data目录下的存储它信息的目录一个名字


5.

+common

   +admin

   +demo

   +doc

   +...


位于common目录

这个目录中的脚本可以用于其它的主机，比如认证服务器

尽管他们没有位于一个主机指定的根目录，他们可以通过

http://localhost/admin来请求，通过在这个主机的conf.py

配置文件中定义别名。    


定制

如果你想定制一个目录，来存放服务器或者主机信息，这里给出需要做的：

1.改变脚本server_config.py的目录，启动服务器，加一个参数，在命令行中

python Karrigell.py [ServerConfigDirectory]

2.改变hosts的目录，修改server_config.py中的host_conf_dir的值

3.对于默认主机改变data目录的位置，修改这个主机配置文件中的data_dir的值


虚拟主机

服务器支持虚拟主机功能，能够在同一个服务器上对不同的主机名进行服务。

例如，一个服务器可以服务www.foo.com和www.bar.com,这些主机名字被解释到

服务器的IP。每一个主机都有一个自己的文件路径，配置文件，存储会话数据和用户等。


为了添加一个主机，你必须首先确保主机名能够解析到服务器的IP。这个映射可以在系统主机文件中完成。


为了解释接下来要做什么，让我们从最后开始：看看这个新主机的目录结构

 Karrigell.py

 server_config.py

 default_host_conf.py

 hosts.py

+ karrigell

 + core

 + package

 + ...

+ data

 + www

     + sessions

     conf.py

 + foo

     + sessions

     conf.py

+ www

   index.pih

   ...

+ foo

   default.html

   myscript.py

   ...

+ common

 + admin

 + demo

 + doc

 + ...

 你需要遵循的步骤是：

 1.为这个主机创建一个新的根目录:(server dir)/foo

 2.在data目录下创建一个新的子目录:(server dir)/data/foo

 3.拷贝default_host_conf.py到这个新的子目录中，并且重命名为conf.py

 4.修改conf.py脚本，更新root_dir data_dir的值

   root_dir = os.path.join(server_dir,"foo")

   data_dir = os.path.join(server_dir, "data","foo")

 5.编辑文本文件hosts，在服务器配置目录，然后添加一个新行，说明主机名和配置文件路径

   foo /usr/Karrigell-3.1.1/data/foo/conf.py


对于服务器管理员，提供了在线建立和删除虚拟主机的脚本


实际上这是最简单的配置：你可以把根目录和data目录放到你系统的任何地方。这种情况下你需要修改配置脚本，上面提到的那种方法。