[英 => 中] 从源文件构建 nginx

从源文件构建 nginx

原文地址: http://nginx.org/en/docs/configure.html

咱们使用 configure 命令来设置构建 nginx 须要的配置。它定义了系统的各个方面，包括容许 nginx 用于链接处理的方法。最后，它会生成一个名为 Makefile 文件。这个 configure 命令支持如下参数:

原文是列表形式，这里我为了方便阅读使用表格形式

参数	说明
--prefix=path	定义一个保存服务器文件的目录。这个目录也将用于全部经过 configure 设置的 (除了类库资源路径) 和 nginx.conf 配置文件中的相对路径。默认状况下它被设置为 /usr/local/nginx 目录
--sbin-path=path	设置 nginx 可执行文件的名称。这个名称只用于安装期间。默认状况下这个文件被命名为 prefix/sbin/nginx 。
--conf-path=path	设置 nginx.conf 配置文件的名称。若是须要，nginx 能够随时使用一个不一样的配置文件来启动，经过在命令行中指定参数 -c file 。默认状况下这个文件被命名为 prefix/conf/nginx.conf 。
--pid-path=path	设置一个 nginx.pid 文件的名称，它将存储主进程的进程 ID 。安装后，这个文件名能够随时更改经过使用 nginx.conf 配置文件中的 pid 指令。默认状况下这个文件被命名为 prefix/logs/nginx.pid 。
--error-log-path=path	设置主要错误，警告，以及诊断文件的名称，这个文件名称能够随时更改，经过在 nginx.conf 配置文件中使用 error_log 指令。默认状况下这个文件被命名为 prefix/logs/access.log 。
--http-log-path=path	设置 HTTP 服务器的主要请求日志文件的名称。安装后，这个文件名能够随时更改，经过在 nginx.conf 配置文件中使用 access_log 指令。默认状况下这个文件被命名为 prefix/logs/access.log 。
--user=name	设置一个无特权用户名做为工做进程将使用的凭据。安装后，这个名称能够随时更改，经过在 nginx.conf 配置文件中使用 user 指令。默认的用户名是 nobody 。
--group=name	设置一个组名做为工做进程将使用的凭据。安装后，这个名称能够随时更改，经过在 nginx.conf 配置文件中使用 user 指令。默认状况下，组名被设置为无特权用户名。
--with-select_module --without-select_module	启用或者禁用构建容许服务器使用 select() 方法的模块。若是平台没有出现支持更合适的方法，好比 kqueue，epoll，或者 /dev/poll，那么这个模块会自动构建。
--with-poll_module --without-poll_module	启用或者禁用构建容许服务器使用 poll 方法的模块。若是平台没有出现支持更合适的方法，好比 kqueue，epoll，或者 /dev/poll，那么这个模块会自动构建。
--without-http_gzip_module	禁用构建 HTTP 服务器的 compresses responses 模块。zlib 类库须要构建并运行这个模块。
--without-http_rewrite_module	禁用构建容许 HTTP 服务器 redirect requests and change URI of requests 的模块。PCRE 类库须要构建并运行这个模块。
--without-http_proxy_module	禁用构建 HTTP 服务器 proxying module 。
--with-http_ssl_module	启用构建添加 HTTPS protocol support 到 HTTP 服务器的模块。默认状况下，这个模块不会构建。OpenSSL 类库须要构建并运行这个模块。
--with-pcre=path	设置 PCRE 类库的资源路径。这个类库分配 (版本 4.4 - 8.40) 须要从 PCRE 站点下载并提取。其他的经过 nginx 的 ./configure 和 make 完成。这个类库是为 location 指令中对正则表达式的支持以及 ngx_http_rewrite_module 模块中对正则表达式的支持所必须的。
--with-pcre-jit	构建 PCRE 类库并带 "just-in-time compilation" 的支持 (1.1.12，pcre_jit 指令) 。
--with-zlib=path	设置 zlib 类库的资源路径。这个类库分配 (版本 1.1.3 - 1.2.11) 须要从 zlib 站点下载并提取。其他的经过 nginx 的 ./configure 和 make 完成。这个类库是 ngx_http_gzip_module 模块所必需的。
--with-cc-opt=parameters	设置额外添加到 CFLAGS 变量的参数。当在 FreeBSD 下使用系统 PCRE，应该制定 --with-cc-opt="-I /usr/local/include" 。若是须要增长经过 select() 支持的文件数量，也能够在这里制定这样的命令: --with-cc-opt="-D FD_SETSIZE=2048" 。
--with-ld-opt=parameters	设置额外的链接期间的参数。当在 FreeBSD 下使用系统 PCRE 类库，应该指定 --with-ld-opt="-L /usr/local/lib" 。

参数适用示例 (全部参数须要输入在一行中)

./configure
    --sbin-path=/usr/local/nginx/nginx
    --conf-path=/usr/local/nginx/nginx.conf
    --pid-path=/usr/local/nginx/nginx.pid
    --with-http_ssl_module
    --with-pcre=../pcre-8.40
    --with-zlib=../zlib-1.2.11

配置后，使用 make 编译并安装 nginx。