fastcgi c/c++ API 说明

fastcgi c/c++ API 下载地址：https://github.com/FastCGI-Archives

先上example

#include <iostream>
#include "fcgio.h"
 
using namespace std;
 
int main(void) {
    // Backup the stdio streambufs
    streambuf * cin_streambuf  = cin.rdbuf();
    streambuf * cout_streambuf = cout.rdbuf();
    streambuf * cerr_streambuf = cerr.rdbuf();
 
    FCGX_Request request;
 
    FCGX_Init();
    FCGX_InitRequest(&request, , );
 
    while (FCGX_Accept_r(&request) == ) {
        fcgi_streambuf cin_fcgi_streambuf(request.in);
        fcgi_streambuf cout_fcgi_streambuf(request.out);
        fcgi_streambuf cerr_fcgi_streambuf(request.err);
 
        cin.rdbuf(&cin_fcgi_streambuf);
        cout.rdbuf(&cout_fcgi_streambuf);
        cerr.rdbuf(&cerr_fcgi_streambuf);
 
        cout << "Content-type: text/html\r\n"
             << "\r\n"
             << "<html>\n"
             << "  <head>\n"
             << "    <title>Hello, World!</title>\n"
             << "  </head>\n"
             << "  <body>\n"
             << "    <h1>Hello, World!</h1>\n"
             << "  </body>\n"
             << "</html>\n";
 
        // Note: the fcgi_streambuf destructor will auto flush
    }
 
    // restore stdio streambufs
    cin.rdbuf(cin_streambuf);
    cout.rdbuf(cout_streambuf);
    cerr.rdbuf(cerr_streambuf);
 
    return ;
}

1.首先 initialize the FCGX library with FCGX_Init() 和initialize FCGX_Request with int FCGX_InitRequest(FCGX_Request *request, int sock, int flags);

int FCGX_InitRequest(FCGX_Request *request, int sock, int flags);

参数：

request是FCGX_Request指针

sock is a file descriptor returned by FCGX_OpenSocket() or 0 (default)

flags是当指定sock时设为FCGI_FAIL_ON_INTR，默认0

返回值：成功返回0

2.FCGX_Accept_r阻塞接收循环接收fcgi request，_r版本是FCGX_Accept多线程安全版本

int FCGX_Accept_r(FCGX_Request *request);

参数: request FCGX_Request 指针

返回值：成功返回0

3.FCGX_Request结构体

typedef struct FCGX_Request {
    int requestId;            /* valid if isBeginProcessed */
    int role;
    FCGX_Stream *in;
    FCGX_Stream *out;
    FCGX_Stream *err;
    char **envp;
 
    /* Don't use anything below here */
 
    struct Params *paramsPtr;
    int ipcFd;               /* < 0 means no connection */
    int isBeginProcessed;     /* FCGI_BEGIN_REQUEST seen */
    int keepConnection;       /* don't close ipcFd at end of request */
    int appStatus;
    int nWriters;             /* number of open writers (0..2) */
    int flags;
    int listen_sock;
    int detached;
} FCGX_Request;

在FCGX_Accept之前，为FCGX_Request分别给in，out和err分配streambuf

二、Nginx 配置

events {
  worker_connections ;
}
 
http {
  server {
    listen ;
    server_name localhost;
 
    location / {
      fastcgi_pass   127.0.0.1:;
 
      fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
      fastcgi_param  SERVER_SOFTWARE    nginx;
      fastcgi_param  QUERY_STRING       $query_string;
      fastcgi_param  REQUEST_METHOD     $request_method;
      fastcgi_param  CONTENT_TYPE       $content_type;
      fastcgi_param  CONTENT_LENGTH     $content_length;
      fastcgi_param  SCRIPT_FILENAME    $document_root$fastcgi_script_name;
      fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
      fastcgi_param  REQUEST_URI        $request_uri;
      fastcgi_param  DOCUMENT_URI       $document_uri;
      fastcgi_param  DOCUMENT_ROOT      $document_root;
      fastcgi_param  SERVER_PROTOCOL    $server_protocol;
      fastcgi_param  REMOTE_ADDR        $remote_addr;
      fastcgi_param  REMOTE_PORT        $remote_port;
      fastcgi_param  SERVER_ADDR        $server_addr;
      fastcgi_param  SERVER_PORT        $server_port;
      fastcgi_param  SERVER_NAME        $server_name;
    }
  }
}

Nginx 在80端口监听http服务，把请求发送给在端口8000监听的fastcgi进程

三、运行代码

# run nginx using the provided configuration
sudo nginx -c <path to nginx.conf>
 
# compile hello_world
g++ main_v1.cpp -lfcgi++ -lfcgi -o hello_world
 
# spawn the fcgi app on port  with no fork
spawn-fcgi -p  -n hello_world
或
spawn-fcgi -a 127.0.0.1 -p 8088 -f hello_world

1.先启动nginx 服务

2.编译fastcgi程序，注意加链接库 fcgi++和fcgi

3.运行spwan-fcgi 指定可执行程序