tl.buildout_apache 0.3

构建配方： tl.buildout_apache:httpd

以下描述的选项均非必需：它们要么有合理的默认值，要么由配方计算得出。您可以覆盖任何一项。

配置选项

url:

获取源分发的位置。

md5sum:

源分发的MD5校验和。

extra-options:

附加的配置选项，附加到 ./configure 命令行。

extra-vars:

为 ./configure、make 和 make install 调用提供的额外环境变量。

导出选项

httpd-path:

到 httpd 可执行文件的绝对文件系统路径。

envvars-path:

到 envvars 脚本的绝对文件系统路径。

apxs-path:

到 apxs 可执行文件的绝对文件系统路径。

module-dir:

到共享模块目录的绝对文件系统路径。

htdocs:

与Apache服务器一起分发的文档目录的绝对文件系统路径，包含欢迎页面。

cgi-bin:

与Apache服务器一起分发的文档 cgi-bin 的绝对文件系统路径，包含测试和演示脚本。

mod_python 配方：tl.buildout_apache:modpython

以下描述的选项均非必需：它们要么有合理的默认值，要么由配方计算得出。您可以覆盖任何一项。

配置选项

url:

获取源分发的位置。

md5sum:

源分发的MD5校验和。

extra-options:

附加的配置选项，附加到 ./configure 命令行。

extra-vars:

为 ./configure、make 和 make install 调用提供的额外环境变量。

httpd:

httpd 安装构建区域的名字，默认为“httpd”。它必须导出“apxs-path”选项。

python:

Python 安装构建区域的名字，默认为“buildout”部分使用的 Python 区域。它必须导出“executable”选项。

virtualenv:

是否从提供的 Python 安装创建虚拟 Python 环境。默认为“true”。配方需要写入其 Python 的 site packages，所以除非 python 选项描述了一个可写（可能是虚拟）Python 安装，这个部分应该共享，否则不要关闭此选项。

导出选项

modpython:

到 mod_python.so 共享模块的绝对文件系统路径。

executable:

用于安装 eggs 的 Python 可执行文件。

服务器根配方：tl.buildout_apache:root

使用此配方配置的 Apache 服务器进程将运行“prefork”多进程模块。

以下描述的选项均非必需：它们要么有合理的默认值，要么由配方计算得出。您可以覆盖任何一项。

Apache 根的配置可能跨越多个构建区域，以便进行语义分组、重用等。这些区域被称为配置部分，通常是无需构建配方的配置部分。配置部分是递归工作的。

仅适用于根部分的配置选项

httpd:

httpd 安装构建区域的名字，默认为“httpd”。它必须导出以下选项

• httpd-path

• 环境变量路径

• 模块目录

如果存在其他选项，则用于为根部分的自身选项提供默认值

• htdocs

• cgi-bin

ulimit:

命令用于增加每个子进程允许的最大文件描述符数。

sysconf-dir:

系统配置目录的绝对文件系统路径，例如 /etc。它用于查找MIME配置文件。

lynx-path:

lynx可执行文件的绝对文件系统路径。

user:

以用户身份运行服务器（如果以root身份启动）的用户名。

group:

以用户身份运行服务器（如果以root身份启动）的组名。

listen:

要监听的接口和端口，例如 127.0.0.1:80。

python:

定义mod_python安装的buildout部分的名称。如果没有给出，则不使用mod_python。如果存在，则命名的部分必须导出以下选项

• modpython

• executable

virtual-hosts:

用于配置基于名称的虚拟主机的名称=地址对。名称选择描述主机的配置部分，地址是一个可选端口的IP地址，例如 127.0.0.1:80。

适用于根部分和虚拟主机的配置选项

servername:

要宣布的服务器名称，例如 localhost:80。对于虚拟主机是必需的。

serveradmin:

服务器管理员的电子邮件地址。

htdocs:

文档根的绝对文件系统路径，默认为httpd部分的htdocs选项的值。

cgi-bin:

CGI库目录的绝对文件系统路径，默认为https部分的cgi-bin选项的值。

log-dir:

要创建的日志目录的文件系统路径，可以是绝对路径或相对于服务器根的相对路径。

index:

请参阅zc.recipe.egg文档。

适用于配置部分的配置选项，包括根和虚拟主机部分

modules:

要加载的共享模块名称，例如“dir”或“rewrite”。默认包括authz_host。要指定模块的共享对象路径，添加一个形式为“foo=path/to/foo.so”的条目。路径是绝对路径或相对于httpd安装的相对路径。

extra-env:

要导出到httpd环境的额外变量。每行形式为“<name>=<value>”，例如“PATH=/opt/foo:$PATH”。

extra-config:

任意多行服务器配置。

eggs:

要添加到mod_python代码可用的Python模块搜索路径的egg规范。

find-links:

请参阅zc.recipe.egg文档。

extra-paths:

要包含在Python模块搜索路径中的非egg路径。

config-parts:

具有进一步配置的buildout部分的名称。以下是从配置部分导出的选项

• config-parts (递归包含)

• modules

• extra-env

• extra-config

• eggs

• find-links

• extra-paths