使用Mac的开发者大多数的时候通过 brew 命令安装各类软件,比如 PHP、Python、Nodejs,Nginx 也不例外。
默认情况下Nginx安装在/usr/local/Cellar/nginx
,通过brew link nginx
加软连接到/usr/local/bin/nginx
,虽然这样完全满足开发且符合 Mac 软件的管理,但是却不方便移植(比如想给不懂开发的用户一键部署部署的应用包,做私有化部署的同学应该对此不陌生)。
从源码编译NGINX程序比安装预编译的安装包要灵活很多,可以添加特定的模块(来自NGINX官方或者第三方的,比如给 Fastdfs 提供 HTTP 访问文件能力的 fastdfs-nginx 模块),当然自己编译源码拉取的可以是已修复 bug 和新增特性的最新分支。
wget https://ftp.pcre.org/pub/pcre/pcre-8.43.tar.bz2 tar zxf pcre-8.43.tar.bz2
wget http://zlib.net/zlib-1.2.11.tar.gz tar zxf zlib-1.2.11.tar.gz
wget http://www.openssl.org/source/openssl-1.1.1c.tar.gz tar zxf openssl-1.1.1c.tar.gz
wget https://nginx.org/download/nginx-1.17.4.tar.gz tar zxf nginx-1.17.4.tar.gz cd nginx-1.17.4
NGINX编译配置选项由./configure
设置各种参数,包括源文件和配置文件路径、编译选项、链接处理方法以及模块列表。通过./configure
可以创建 Makefile
编译代码和安装 Nginx。
./configure \ --user=nginx \ --group=nginx \ --prefix=./nginx \ --sbin-path=nginx \ --conf-path=nginx.conf \ --pid-path=nginx.pid \ --with-http_ssl_module \ --with-pcre=../pcre-8.43 \ --with-zlib=../zlib-1.2.11 \ --with-openssl=../openssl-1.1.1c
--prefix=path
- 定义一个将保留服务器文件的目录。同样的目录也将用于由 configure 设置的所有相对路径(除了库源的路径)和nginx.conf 配置文件中。它默认设置为/usr/local/nginx
目录。
--sbin-path=path
- 设置 nginx 可执行文件的名称。该名称仅在安装期间使用。默认情况下,该文件被命名为${prefix}/sbin/nginx
。
--conf-path=path
- 设置 nginx.conf 配置文件的名称。如果需要,通过在命令行参数 -c
文件中指定 nginx的配置文件,nginx 始终可以使用不同的配置文件启动。默认情况下,该文件名为${prefix}/conf/nginx.conf
。
--pid-path=path
- 设置将存储主进程的进程ID的 nginx.pid 文件的名称。安装完成后,可以使用 pid 指令始终在 nginx.conf 配置文件中更改文件名。默认情况下,该文件名为 ${prefix}/logs/nginx.pid
。
--error-log-path=path
- 设置主要错误,警告和诊断文件的名称。安装完成后,可以使用error_log指令始终在 nginx.conf 配置文件中更改文件名。默认情况下,该文件名为${prefix}/logs/error.log
。
--http-log-path=path
- 设置HTTP服务器的主要请求日志文件的名称。安装完成后,可以使用 access_log 指令始终在 nginx.conf 配置文件中更改文件名。默认情况下,该文件被命名为${prefix}/logs/access.log
。
--build=name
- 设置一个可选的 nginx 构建名称。
--user=name
- 设置其凭据将被工作进程使用的非特权用户的名称。 安装完成后,可以使用 user
指令始终在 nginx.conf 配置文件中更改该名称。默认的用户名是 nobody
。
--group=name
- 设置工作进程将使用其凭据的组的名称。安装完成后,可以使用 user
指令始终在 nginx.conf 配置文件中更改该名称。 默认情况下,组名称设置为非特权用户的名称。
--with-select_module --without-select_module
- 启用或禁用构建允许 Nginx 使用select()
方法工作的模块。如果平台可能不支持更合适的方法(例如kqueue
,epoll
或/dev/poll
),则会自动构建此模块。
--with-poll_module --without-poll_module
- 启用或禁用构建允许 Nginx 使用该poll()
方法工作的模块。如果平台似乎不支持更合适的方法(例如kqueue
,epoll
或/dev/poll
),则会自动构建此模块。
--without-http_gzip_module
- 禁用构建压缩HTTP服务器响应的模块。需要zlib库来构建和运行此模块。
--without-http_rewrite_module
- 禁止构建允许HTTP服务器重定向请求并更改请求URI的模块。PCRE库需要构建和运行该模块。
--without-http_proxy_module
- 禁用构建HTTP服务器代理模块。
--with-http_ssl_module
- 可以构建一个将HTTPS协议支持添加到HTTP服务器的模块。该模块不是默认生成的。OpenSSL库是构建和运行该模块所必需的。
--with-pcre=path
- 设置PCRE库源的路径。发行版(版本4.4 - 8.41)需要从PCRE网站下载并提取。该库是location
指令和ngx_http_rewrite_module
模块支持正则表达式所必需的。
--with-pcre-jit
- 用“即时编译”支持(1.1.12,pcre_jit指令)构建PCRE库。
--with-zlib=path
- 设置zlib库源的路径。库分发(版本1.1.3 - 1.2.11)需要从zlib站点下载并解压缩。该库是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"应该指定。
make && make install
最后看到有test相关的数据输出则表示编译成功:
test -d './nginx' || mkdir -p './nginx' test -d './nginx' \ || mkdir -p './nginx' test ! -f './nginx/nginx' \ || mv './nginx/nginx' \ './nginx/nginx.old' cp objs/nginx './nginx/nginx' test -d './nginx' \ || mkdir -p './nginx' cp conf/koi-win './nginx' cp conf/koi-utf './nginx' cp conf/win-utf './nginx' test -f './nginx/mime.types' \ || cp conf/mime.types './nginx' cp conf/mime.types './nginx/mime.types.default' test -f './nginx/fastcgi_params' \ || cp conf/fastcgi_params './nginx' cp conf/fastcgi_params \ './nginx/fastcgi_params.default' test -f './nginx/fastcgi.conf' \ || cp conf/fastcgi.conf './nginx' cp conf/fastcgi.conf './nginx/fastcgi.conf.default' test -f './nginx/uwsgi_params' \ || cp conf/uwsgi_params './nginx' cp conf/uwsgi_params \ './nginx/uwsgi_params.default' test -f './nginx/scgi_params' \ || cp conf/scgi_params './nginx' cp conf/scgi_params \ './nginx/scgi_params.default' test -f './nginx/nginx.conf' \ || cp conf/nginx.conf './nginx/nginx.conf' cp conf/nginx.conf './nginx/nginx.conf.default' test -d './nginx' \ || mkdir -p './nginx' test -d './nginx/logs' \ || mkdir -p './nginx/logs' test -d './nginx/html' \ || cp -R html './nginx' test -d './nginx/logs' \ || mkdir -p './nginx/logs'
> make[1]: *** [/usr/local/Cellar/pcre/8.43/lib//Makefile] Error 127
Nginx 高版本的需要使用 pcre 原文件路径,通过--with-pcre=PATH
指定 pcre 的源路径即可。
--prefix
指定的是整个编译后输出文件的位置的前缀如果其他配置项不指定或者其他配置项是相对路径,在编译路径会加上prefix
的配置路径。
本文首发《虚怀若谷–做一个有情怀的程序员》,原文链接:https://www.zhoujunwen.com/2019/building-openjdk-8-on-mac-osx-catalina-10-15