<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" >
<head><meta content="text/html;charset=&quot;utf-8&quot;" http-equiv="Content-type"/><link href="faldoc.css" rel="stylesheet" type="text/css"/><title> - FastCGI stand-alone front-end</title></head><body class="faldoc"><ul class="navi_top"><li class="top"><a href="index.html">Top: Table of contents</a></li>
<li class="up"><a href="WOPI.html">Up: Web Oriented Programming Interface</a></li>
<li class="prev"><a href="WOPI_front_end_falhttpd.html">Previous: Micro Falcon-based web server</a></li>
<li class="next"><a href="WOPI_front_end_mod_apache2.html">Next: Apache 2 web server module.</a></li>
<li class="clear"></li>
</ul><div id="page_body"><h1><span class="toc_number">5.5</span>FastCGI stand-alone front-end</h1><p> </p>
<p>The WOPI FastCGI front-end, called <b>ffalcgi</b> is a stand-alone program (a binary executable for the target platform) which loads a Falcon script corresponding to its name. </p>
<p>The program is loaded by the web server (that must support the FastCGI library interface), and data is passed to it through the FastCGI library. As soon as the CGI program is ready, it searches for a falcon script bearing its same name (but having extension .fal, .ftd or .fam), loading and then executing it. </p>
<p>Except for the usage of the <a href="http://www.fastcgi.com" target="_blank">FastCGI</a> library, this front end works as the <a href="WOPI_front_end_cgi.html">CGI stand-alone front-end</a> interface. Using FastCGI, the program is loaded once and stays resident in the web server application process hierarchy; this reduces script load time and allows this front-end to use advanced performance optimization techniques, as module caching. </p>
<p class='note'><b>Note:</b> Be sure to read the <a href="WOPI_falcgi_iso.html">Isomorphism of CGI based sites.</a> documentation about specificities of the CGI model. </p>
<h2><a name="ffalcgi_conf">Configuration</a></h2>
<p>The CGI front-end reads the following attributes from the main module: <ul><li><b>wopi_tempDir</b>: Location where to store the temporary files. Defaults to /tmp on POSIX systems, and to C:TEMP on MS Windows systems. </li><li><b>wopi_maxMemUpload</b>: Maximum size for upload to be retained on memory instead being stored on disk. </li><li><b>wopi_sessionTO</b>: Session timeout (maximum live time for session cookies and data, in seconds). </li><li><b>wopi_pdataDir</b>: Location where persistent data files are stored (the process should have write access rights here). </li></ul></p>
<p>Other than that, you have to activate the ability to execute CGI programs from within the web server you're currently using. Check the documentation of the web server for further information. </p>
</div><ul class="navi_bottom"><li class="top"><a href="index.html">Top: Table of contents</a></li>
<li class="up"><a href="WOPI.html">Up: Web Oriented Programming Interface</a></li>
<li class="prev"><a href="WOPI_front_end_falhttpd.html">Previous: Micro Falcon-based web server</a></li>
<li class="next"><a href="WOPI_front_end_mod_apache2.html">Next: Apache 2 web server module.</a></li>
<li class="clear"></li>
</ul><div class="signature">Made with <a href="faldoc 3.0">http://www.falconpl.org</a></div></body></html>
