Mod scgi » History » Revision 12

Revision 11 (Shtirlic, 2012-08-11 10:42) → Revision 12/17 (gstrauss, 2016-10-19 16:52)

h1. SCGI Interface 


 *Module: mod_scgi* 

 h2. Description 

 Brief description of [[Docs_ConfigurationOptions#mod_scgi-SCGI|mod_scgi directives]] 

 table{margin-left: 2em}. 
 |_.option |_. description | 
 | scgi.debug | a value between 0 and 65535 to set the debug-level in the The SCGI module | 
 | scgi.server | tell is heavily based on the module where FastCGI when it comes to send SCGI requests to | 
 | scgi.protocol | configuration.  

 Only the internal protocol between lighttpd server and backend server ("scgi" (default) or "uwsgi") | client has been replaced.  

 Please check the documentation of the FastCGI module for more information. 

 h2. History 

 Added in 1.4.42 | lighttpd 1.3.14 as it was really simple to do. 

 table{margin-left: 4em}. 
 |_.scgi.server-option |_. description | 
 | host | is ip of the h2. C/C++ SCGI process | 
 | port | is tcp-port on the "host" used by the SCGI process | 
 | named socket | path 

 Up to lightty 1.4.19 there is a bug in that the unix-domain pre-opened socket | 
 | bin-path | path to the local SCGI binary which should be started if no local SCGI handle is running | 
 | bin-environment | set environment of SCGI binary | 
 | bin-copy-environment | copy environment from server for SCGI binary | 
 | listen-backlog | listen backlog queue size (for backend daemons started by mod_scgi) | 
 | docroot | docroot not on the remote host | 
 | x-sendfile | controls if X-Sendfile header descriptor 0 (as it is allowed | 
 | x-sendfile-docroot | limits the directory trees permitted for use with X-Sendfile response header | 
 | broken-scriptfilename | breaks SCRIPT_FILENAME in a way that PHP FastCGI FCGI_LISTENSOCK_FILENO) but any later file descriptor.  

 Since 1.4.20 you can extract PATH_INFO from it | 
 | idle-timeout | number of seconds before take over your testfastcgi program and replace FCGX_Accept() by a unused process gets terminated | 
 | max-procs | upper limit of processes to start | 
 | min-procs | sets standard Unix accept(LISTENSOCK_FILENO, &addr, &addrlen) - then pthread_create/fork for your handler.  

 The SCGI parameter block at the minium processes to start | 
 | min-procs-not-working |    | 
 | max-load-per-proc | maximum number of waiting processes on average per process before a new process the socket stream is spawned | 
 | check-local | enable/disable check for requested file in document root | 
 | disable-time | time easy to wait before a disabled backend read and to decode - no third-party library is checked again | 
 | strip-request-uri | strip part of request-uri | 

 Details for scgi.server parameters can be found in [[Docs_ModFastCGI|mod_fascgi]] documentation, since required anymore.  

 Just write() to the SCGI module is heavily based on accept'ed socket handle to return the FastCGI module, result page to the lightty webserver and fastcgi.server parameters are very similar. close() the accept'ed handle to signal that the request has finished.