nginx 編譯安裝詳解

nginx 編譯安裝
===================

編譯自：
http://nginx.org/en/docs/install.html

若是須要特別的 nginx 功能，可進行編譯安裝：

源碼包中提供 configure 腳本用於編譯前定義 nginx 各方面的配置。
執行 configure 腳本最後生成 Makefile，make 命令根據 Makefile 進行編譯安裝。

configure 命令支持以下參數：

--prefix=path
    定義 nginx 文件的安裝路徑。
    configure 的其餘選項若是使用相對路徑，那麼以此路徑爲基礎路徑。(except for paths to libraries 
    sources)。nginx.conf 文件中的相對路徑也以此爲基礎路徑。
    默認 --prefix=/usr/local/nginx 
    

--sbin-path=path
    設置 nginx 二進制程序的路徑名，這個名字只在安裝期間使用。
    默認 --sbin-path=prefix/sbin/nginx


--conf-path=path
    設置 nginx.conf 的路徑。
    nginx 可在啓動時手動以 -c file 參數指定其餘配置文件。
    默認 --conf-path=prefix/conf/nginx.conf

--pid-path=path
    設置 nginx.pid 文件的路徑。安裝nginx以後，可在 nginx.conf 文件中使用 pid 指令修改該路徑。
    默認 --pid-path=prefix/logs/nginx.pid

--error-log-path=path 
    設置 nginx 錯誤日誌的路徑。安裝nginx以後，可在 nginx.conf 文件中使用 error_log 指令修改該路徑。
    默認 --error-log-path=prefix/logs/error.log.

--http-log-path=path 
    設置 nginx 訪問日誌的路徑。安裝nginx以後，可在 nginx.conf 文件中使用 access_log 指令修改該路徑。
    默認 --http-log-path=prefix/logs/access.log
    
--user=name 
    設置啓動 worker 進程時所使用的非特權用戶名。安裝nginx以後，可在 nginx.conf 文件中使用 user 指令修改用戶名。
    默認 --user=nobody
    
--group=name 
    設置啓動 worker 進程時所使用的非特權用戶組名。安裝nginx以後，可在 nginx.conf 文件中使用 group 指令修改用戶組名。
    默認 --group=nobody

--with-select_module
--without-select_module 
    是否編譯 select 模塊。使用 select 模塊可以使 nginx 工做於 select() 模式。
    若是 nginx 不支持其餘更合適的模塊，如 kqueue, epoll 或者 /dev/poll，該模塊被自動編譯。
    
--with-poll_module
--without-poll_module 
    是否編譯 poll 模塊。使用 poll 模塊可以使 nginx 工做於 poll() 模式。
    若是 nginx 不支持其餘更合適的模塊，如 kqueue, epoll 或者 /dev/poll，該模塊被自動編譯。
    
--without-http_gzip_module 
    不編譯 gzip 壓縮模塊。壓縮模塊用於壓縮 HTTP 響應報文。該模塊的編譯和運行依賴 zlib 庫。
    
--without-http_rewrite_module 
    不編譯 rewrite 模塊。rewrite 模塊用於重定向 HTTP 請求，也能夠改寫 HTTP 請求的 URI。
    該模塊的編譯和運行依賴 PCRE 庫。
    
--without-http_proxy_module
    不編譯 proxy 模塊。
    
--with-http_ssl_module 
    編譯 ssl 模塊。ssl 模塊使 nginx 支持 HTTPs 協議。該模塊默認不編譯。
    該模塊的編譯和運行依賴 OpenSSL 庫。

--with-pcre=path
    設置 PCRE 庫的源碼路徑。首先須要下載和解壓 PCRE 庫：http://www.pcre.org。
    要求 PCRE 的版本範圍爲 4.4 — 8.38。
    設置以後，其他的就交給 ./configure 和 make 命令。
    nginx 使用 PCRE 庫用於支持正則表達式。正則表達式在 location 指令和 rewrite 模塊中會用到。
    
    
--with-pcre-jit
    編譯 PCRE 庫時，加入 「just-in-time compilation」 支持 (1.1.12, the pcre_jit directive)
    
--with-zlib=path
    設置 zlib 庫的源碼路徑。首先須要下載和解壓 zlib 庫：http://zlib.net
    要求 zlib 庫的版本範圍爲 1.1.3 — 1.2.8
    設置以後，其他的就交給 ./configure 和 make 命令。
    gzip 壓縮模塊依賴 zlib 庫。

--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"。

    
Example of parameters usage (all of this needs to be typed in one line):

./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.38
    --with-zlib=../zlib-1.2.8

配置完成後，使用 make 命令編譯安裝 nginx。