简介

  • 本文章主要介绍下，如何通过Nginx + fastCGI来部署动态网页。

CGI介绍

  • 在介绍fastCGI之前先介绍下CGI是什么。
  • CGI : Common Gateway Interface，公共网关接口。在物理层面上是一段程序，运行在服务器上，提供同客户端HTML页面的接口。
  • Nginx+CGI处理步骤
  • 用户发送HTTP请求到Web服务器
  • Web服务器fork一个CGI子进程，将用户请求交给CGI程序
  • CGI程序把处理结果传送给Web服务器，CGI子进程被销毁
  • Web服务器把结果返回到用户
    请添加图片描述
  • CGI缺点
    • CGI每处理一个请求，就要fork一个子进程，处理完请求，再销毁子进程。频繁的创建和销毁进程，就会大大降低Web服务器的效率。
  • fastCGI
    • fastCGI是对CGI的优化，fastCGI并不会每处理一个请求就创建一个进程， 这样就避免了频繁创建和销毁CGI进程，可以大大提高服务器的效率。
    • 下面就重点介绍下fastCGI

fastCGI

  • FastCGI是一个可伸缩的、高速的在HTTP服务器和动态脚本语言间通信的接口，主要优点是把动态语言和HTTP服务器分离开来。
  • 主要是将CGI进程保持在内存中进行管理调度，以获得较高的性能。
  • fastCGI的工作原理
    • Web服务器启动时载入fastCGI进程管理器
    • fastCGI进程管理器自身初始化，启动多个CGI子进程并等待来自Web服务器的连接
    • 当客户端请求到达Web服务器时，fastCGI进程管理器选择并连接到一个CGI进程来处理请求
    • fastCGI子进程完成处理后将结果返回给Web服务器
  • 问题
    • Nginx下fastCGI与服务器是分离的，就是Nginx无法直接调用fastCGI，需要用spawn-fcgi来管理

spawn-fcgi

  • spawn-fcgi是Nginx和fastCGI之间的桥梁，负责Nginx和fastCGI之间的数据通信
    请添加图片描述

安装

  • fastCGI
    • ./configure
    • make
    • make install
  • 如果make时报错，在libfcgi/fcgio.cpp中添加头文件 #include <stdio.h>
  • spawn-fcgi
    • ./configure
    • make
    • make install
  • 关于Nginx的安装另一篇文章中有介绍 : Nginx部署静态网页

环境配置

  • Nginx配置
    • 主要是将Nginx处理不了的指令交给fastCGI操作
    • 打开Nginx配置文件 /usr/local/nginx/conf/nginx.conf，在server字段里加一个location字段 
      •   # 处理指令
  location /fastCgiTest{
  	# 配置fastcgi模块，这里的端口是fastCGI进程的端口
  	fastcgi_pass 192.168.206.128:10010;
  	# 包含配置文件
  	include fastcgi.conf;
  }
  • Nginx默认展示登录网页(用该程序替换Nginx默认index.html) 
    •   <!DOCTYPE html>
  <html lang="en">
  <head>
  	<meta charset="UTF-8">
  	<title>FastCGI测试网站</title>
  </head>
  <body>
  	<h1 align="center">FastCGI测试网站</h1>
  	<div class="container">
  		<form method="post" action="http://192.168.206.128/fastCgiTest">
  		<p align="center"><label>姓名：<input type="text" name="username" placeholder="admin" autofocus="autofocus"></label></p>
  		<p align="center"><label>密码：<input type="password" name="password" placeholder="000" required="required"></label></p>
  		<p align="center">
  	 		<button class="mybtn">登录</button>
  	 	</p>
  		</form>
  	</div>
  </body>
  </html>

spawn-fcgi的使用

  • 命令 : spawn-fcgi -a IP -p PORT -f fastcgi程序
    • IP : Nginx服务器ip地址，就是上面配置的192.168.206.128
    • PORT : 服务器将数据发送到的端口，就是上面我们配置的10010端口
    • fastcgi程序 : spawn-fcgi fork fastcgi进程，fastcgi程序需要我们自己实现并编译。

编写fastcgi程序

  • 这是参考fastcgi中的一个demo写的一个，主要实现登录功能，如果输入正确的用户名和密码，展示登录成功界面，如果输入错误的用户名和密码，继续展示登录界面，并提示重新登录。
  •  #include "fcgi_config.h"
 #include <stdlib.h>

 #ifdef HAVE_UNISTD_H
 #include <unistd.h>
 #endif

 #ifdef _WIN32
 #include <process.h>
 #else
 extern char **environ;
 #endif

 #include <string.h>
 #include "fcgi_stdio.h"

 //检查登录账号和密码
 int checkLogin(char* recvBuf, const char* userName, const char* password);

 int main ()
 {
 	char **initialEnv = environ;
	 	int count = 0;

 	while (FCGI_Accept() >= 0) {
 		//请求数据长度
     	char *contentLength = getenv("CONTENT_LENGTH");
 		//请求方法(GET/POST)
 		char *requestmechod = getenv("REQUEST_METHOD");

 		//响应头(printf相当于发送数据)
 		printf("MyFlag: IsFastCGI\r\n");  //可以加自定义响应头
 		printf("Content-type: text/html\r\n");
 		printf("\r\n");

 		int length = 0;
 		//POST请求
 		if(strcmp(requestmechod, "POST") == 0){
 			length = strtol(contentLength, NULL, 10);
 			//post请求没有数据，不处理
 			if(length == 0){
 				continue;
 			}
 		
 			//读取post请求数据
 			char ch;
 			char recvBuf[1024 * 10] = {0};
 			for (int i = 0; i < length; i++) {
            	 	if ((ch = getchar()) < 0) {
                 	printf("read post data failed\n");
                 	continue;
 				}
 				recvBuf[i] = ch;
         	}
 		
 			if(checkLogin(recvBuf, "admin", "000")){
 				printf("<h1>Login success!</h1>\r\n");
 			}else{
 				printf("<!DOCTYPE html>\r\n");
 				printf("<html lang=\"en\">\r\n");
 				printf("<head>\r\n");
 				printf("<meta charset=\"UTF-8\">\r\n");
 				printf("<title>FastCGI测试网站</title>\r\n");
 				printf("</head>\r\n");
 				printf("<body>\r\n");
 				printf("<h1 align=\"center\">FastCGI测试网站</h1>\r\n");
 				printf("<div class=\"container\">\r\n");
 				printf("<form method=\"post\" action=\"http://192.168.206.128/fastCgiTest\">\r\n");
 				printf("<p align=\"center\"><label>姓名：<input type=\"text\" name=\"username\" placeholder=\"admin\" autofocus=\"autofocus\"></label></p>\r\n");
 				printf("<p align=\"center\"><label>密码：<input type=\"password\" name=\"password\" placeholder=\"000\" required=\"required\"></label></p>\r\n");
 				printf("<p align=\"center\">\r\n");
 				printf("<button class=\"mybtn\">登录</button>\r\n");
 				printf("</p>\r\n");
 				printf("</form>\r\n");
 				printf("</div>\r\n");
 				printf("<dialog open>\r\n");
 				printf("<p>用户名或密码错误，请重新登录</p>\r\n");
 				printf("<form method=\"dialog\">\r\n");
 				printf("<button align=\"center\">确定</button>\r\n");
 				printf("</form>\r\n");
 				printf("</dialog>\r\n");
 				printf("</html>\r\n");
 			}
 		}

 	} /* while */

 	return 0;
 }

 int checkLogin(char* recvBuf, const char* userName, const char* password){	
 	char* p = recvBuf;
 	char* pUserName = strtok(p, "&");
 	char* pPassWord = strtok(NULL, "&");

 	char* pUserNameKey = strtok(pUserName, "=");
 	char* pUserNameValue = strtok(NULL, "=");


 	char* pPassWordKey = strtok(pPassWord, "=");
 	char* pPassWordValue = strtok(NULL, "=");


 	if(strcmp(pUserNameValue, userName) == 0 && strcmp(pPassWordValue, password) == 0){
 		return 1;
 	}
 	return 0;
 }
  • 编译
    • gcc echo.c -lfcgi
  • 启动fastcgi
    • spawn-fcgi -a 192.168.206.128 -p 10010 -f ./a.out
    • 如果有以下报错，说明启动失败了。先直接启动下a.out看是什么报错
    • spawn-fcgi: child exited with: 127
    • 直接启动a.out，可以看到以下报错
    • ./a.out: error while loading shared libraries: libfcgi.so.0: cannot open shared object file: No such file or directory
    • 说明找不到库文件libfcgi.so，这个文件在这个目录下 /usr/local/lib
    • 可以把这个目录加到 /etc/ld.so.conf文件中，执行sudo ldconfig
    • 再重新启动fastcgi程序。注意a.out前面一定要加路径。
    • 有以下打印说明启动成功了
    • spawn-fcgi: child spawned successfully: PID: 26378

环境变量

  • FastCGI程序中有一些环境变量，我们可以通过getenv函数获取对应的值
  • REQUEST_METHOD：请求方法(GET/POST)
  • CONTENT_TYPE：数据类型
  • REQUEST_URI：URI
  • SERVER_PROTOCOL：HTTP协议
  • REMOTE_ADDR：客户端IP
  • REMOTE_PORT：客户端端口
  • SERVER_NAME：服务器IP
  • SERVER_PORT：服务器端口

测试

  • 首先我们在浏览器中访问Nginx，默认端口为80。然后会展示我们写的登录网页，在登录网页中输入用户名和密码后，点击提交，会发送POST请求到Nginx配置文件中配置的/fastCgiTest指令上。Nginx就会根据ip和端口将指令转发到fastCGI程序，fastCGI程序处理POST请求数据，如果用户名和密码正确，显示登录成功，如果用户名和密码错误，继续展示登录界面，并提示用户重新登录。
  • 先访问Nginx，展示默认网页
    在这里插入图片描述
  • 输入正确的用户名和密码，fastCGI程序处理后展示登录成功界面
    在这里插入图片描述
  • 输入错误的用户名和密码，fastCGI程序处理后，重新展示登录界面，并提示重新登录
    在这里插入图片描述
# nginx # 服务器 # 运维
Logo
开放原子开发者工作坊

开放原子开发者工作坊旨在鼓励更多人参与开源活动，与志同道合的开发者们相互交流开发经验、分享开发心得、获取前沿技术趋势。工作坊有多种形式的开发者活动，如meetup、训练营等，主打技术交流，干货满满，真诚地邀请各位开发者共同参与！

更多推荐

第二届开放原子大赛首批创新成果集结武汉，诚邀广大开发者共鉴开源技术盛宴

第二届开放原子大赛首批创新成果集结武汉，诚邀广大开发者共鉴开源技术盛宴

avatar 开放原子开发者工作坊

诚邀报名 | 开源基础设施能力建设分论坛：打造开源生态的“心脏”

诚邀报名 | 开源基础设施能力建设分论坛：打造开源生态的“心脏”

avatar 开放原子开发者工作坊

诚邀报名 | 编程语言分论坛：AI时代的技术革新与开源实践

诚邀报名 | 编程语言分论坛：AI时代的技术革新与开源实践

avatar 开放原子开发者工作坊