karrigell安装初步

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目录放到你系统的任何地方。这种情况下你需要修改配置脚本，上面提到的那种方法。