spawn fcgi(spawn fcgi 源码分析)

本文解决两个问题:

1、如何在一个Nginx的网页上面遇到.cgi请求的时候,启用外部的fcgi程序

2、如何让Nginx服务器支持调用多个fcgi程序。


1、原理性概述

Fastcgi程序可以使用很多语言来编写,PHP,Python,C/C++等等,本文采用C语言来编写。Nginx不支持对外部程序的直接调用或者解析,所有的外部程序(包括PHP)都是需要通过FastCGI接口来调用的。而为了调用CGI程序,还需要一个叫做spawn-fcgi的程序,可以简单地理解为,要想通过Nginx启动FCGI程序,必须得先通过启动spawn-fast,由spawn-fast去传递Nginx启动的请求,可以把spawn-cgi理解为一个中间搭桥的。

2、获取fcgi和spawn-fcgi的源码库(配置编译都是在Linux环境下)

fcgi

(1)要编写fastcgi程序,需要使用到fastcgi的头文件。要运行fastcgi程序需要依赖库文件。通过fastcgi源码去得到头文件和库

(2)进入解压后的源码目录, 在解压后的目录中创建文件夹 _install 因为我的习惯是把配置编译生成出来的东西都放到指定文件夹下面,这样要查找东西很方便,特别是在解压配置编译一个比较大的源码的时候

(3)然后进入include目录,找到fcgio.h文件

打开该文件,加入一行代码 #include <cstdio> ,

#include <iostream>

#include "fcgiapp.h"

#include <cstdio> //添加这一行

#ifndef DLLAPI

#ifdef _WIN32

#define DLLAPI __declspec(dllimport)

这是因为gcc编译器更新的比较快,比较新,而fastcgi版本比较旧,可能存在一些不兼容的问题,在make的时候会报错。

(4)然后配置,通过参数--prefix来指定一会make install的文件都放到指定目录,prefix后面跟的是绝对路径,大家根据自己的实际情况来填写路径,只要最后指到新建的_install目录就正确。配置命令如下:

./configure --prefix=/home/fastcgi/fcgi/fcgi-2.4.0/_install

配置完成以后就编译

依次输入命令:

make

make install

然后就可以在_install目录中看到生成的文件了。

把_install/lib下面的libfcgi.so.0库拷贝到/usr/lib/目录下面,就算大功告成了。

spawn-fcgi

(1)

解压,进入源码目录,方法同上,新建_install目录。

在配置之前先运行./autogen.sh

(2)配置

./configure --prefix=/home/fastcgi/fcgi/spawn-fcgi-1.6.3/_install

(3)然后依次输入

make

make install

(4)进入到_install目录

把bin目录下生成的程序拷贝到nginx服务器的安装目录下的sbin目录里面去,例如我的安装目录是

/server/nginx/sbin,如果nginx是默认安装,一般会是/usr/local/nginx/sbin/这个目录。

至此,fastcgi和spawn-fcgi就算准备好了。

3、编写fcgi程序

这个程序最好放到刚刚解压fastcgi源码的那个目录下面去,就是放到这里:

lfcgi.c就是编写的C程序。

有两点稍微说明一下:

(1)、在while(FCGI_Accept() >= 0)循环的外面可以放一些变量定义等等,实际的操作语句放到while循环里面,fcgi的工作方式是,网页一旦请求,那么就触发fcgi程序,每请求一次,while就循环一次。

(2)、"Conten-type:text/html\r\n"这个代码一定要加上。

接下来编译:

gcc -lfcgi fcgi.c -o hellofcgi

生成fcgi程序。

将该程序拷贝到nginx的安装目录下的某个文件夹,可以自己新建一个cgibin,完整目录是/server/nginx/cgibin,把程序移到这个文件夹中。记得检查一下hellofcgi程序权限。

4、配置相关文件

打开nginx的配置文件,目录位置是/server/nginx/conf/ 有一个名为nginx.conf的文件,打开它,在server节点下面添加如下代码:(#注释的部分不用添加),这种配置称为A,下面还有一种对比的配置。

把配置文件中的其他部分也贴出来,方便大家查找,就把上面的代码加到下面代码后面就行了

有些小伙伴可能发现自己打开了nginx.conf配置文件,但是却找不到server节点,这有可能是nginx把配置文件拆成几个部分了,检查一下nginx配置文件最下面有没有如下代码,

意思是说,还有vhosts目录下的conf文件也被包含进来,那么这时候就进到所示目录下,打开conf文件,就能找到server节点了。

另外一种配置方式,添加下面代码: 称为配置方式B

location ~ \.cgi$ {

fastcgi_pass 127.0.0.1:8088;

fastcgi_index index.cgi;

fastcgi_param SCRIPT_FILENAME fcgi$fastcgi_script_name;

include fastcgi_params;

}

方式A和方式B的对比:

在A中,网页上来的请求,必须是hellofcgi.cgi,Nginx有这个请求,那么spawn就会查找与hellofcgi配对的模块,那么一查找就能找到nginx/cgibin/目录下的hellofcgi程序。这就为多条fcgi程序奠定下了基础,网页上可以来的也可以是hifcgi.cgi请求,那么就在配置文件当中再去添加一项,换一个端口就行了,比如8089端口,然后location后面的名字就是/hifcgi.cgi,那么网页上来的是hifcgi.cgi请求的时候,就会去配对到hifcgi模块。

配置方式B,意思为无论网页上来的是什么cgi请求,我都传到8088这个端口绑定的cgi模块上面去,比如我们8088端口绑定的hellofcgi(下面会讲如何使用spawn-fcgi做绑定),那么不论网页上是什么cgi请求,不论是hellofcgi.cgi、1.cgi、2.cgi等等,都统统交给hellofcgi模块来处理,这样的话就相当于Nginx只能绑定一个外部的fcgi程序。

所以综上,想要Nginx支持多个fcgi程序,就使用配置方式A。当然,有几个程序就要添加几个端口。

5、使用spawn-fcgi绑定端口

进入到/nginx/sbin/目录下面,启用spawn-fcgi,代码如下:(根据自己的实际情况填写路径)

./spawn-fcgi -a 127.0.0.1 -p 8088 -f /server/nginx/cgibin/hellofcgi

其中,127.0.0.1是本地主机地址(这里的端口和IP地址要和Nginx的配置文件里的一样),如果你是有公网IP的,就绑定公网IP,端口8088,绑定之前使用netstat -tunlp查看一下端口使用情况,不要占用其他程序的端口。

如果要使用多个fcgi程序,那么就要绑定不同的端口,绑定之前确定在nginx的配置文件当中添加了相关的代码(就只有端口和location后面的名字不一样)。多个程序的时候每个程序的名字很重要,比如说有hellofcgi1程序和hellofcgi2程序,那么在nginx配置文件当中添加上相应代码。并把这两个程序放到/nginx/cgibin目录下,绑定上相应的端口,网页的请求如果是http://localhost/hellofcgi1.cgi(如果绑定的是本地ip地址,浏览器里面输入localhost就相当于127.0.0.1的地址),那么就会去调用hellofcgi1程序,如果网页请求是http://localhost/hellofcgi2.cgi,那么就会调用hellofcgi2程序。

6、重启Nginx

上面的步骤做好以后,就需要重启Nginx服务器了,然后在浏览器当中去输入http://localhost/hellofcgi.cgi就能看到有所显示了~

7、结语

到这里就全部介绍完了,当然只是稍微领进门,后面如何深入diy还需要各位小伙伴自己发挥。另外有一点提醒一下,在编写fcgi程序的时候,所有对于C语言本身的操作,路径都是相对于根目录而言的;所有对于网页的操作,路径都是对于网页站点的目录而言的。

比如说:

A: readdir(dir)

B : printf( "<img src=\"/sd/%s\" width=\"240\" height=\"200\" />",“hello.jpg”); //在网页上显示一幅图片

A和B的路径如果说一样的话,那么A中dir的路径应该是/server/contents/sd

而B中直接就是/sd,AB最终指向的都是同一个目录,但是由于A是C语言代码,无视web服务器(这样说好像也不太准确,但就是那个意思),所以说对它而言的路径就是根目录,而B当中,是对网页进行操作,实际上是HTML语言,这里的printf实际上做了另外的宏定义了。而我的Nginx站点目录是/server/contents,所以对于B而言/server/contents就成了根目录。

需要C/C++ Linux服务器开发学习资料私信“资料”(资料包括C/C++,Linux,golang技术,Nginx,ZeroMQ,MySQL,Redis,fastdfs,MongoDB,ZK,流媒体,CDN,P2P,K8S,Docker,TCP/IP,协程,DPDK,ffmpeg等),免费分享