diff options
Diffstat (limited to 'src/web/server/h2o/libh2o/doc/configure/fastcgi_directives.html')
-rw-r--r-- | src/web/server/h2o/libh2o/doc/configure/fastcgi_directives.html | 232 |
1 files changed, 0 insertions, 232 deletions
diff --git a/src/web/server/h2o/libh2o/doc/configure/fastcgi_directives.html b/src/web/server/h2o/libh2o/doc/configure/fastcgi_directives.html deleted file mode 100644 index a2e895ace..000000000 --- a/src/web/server/h2o/libh2o/doc/configure/fastcgi_directives.html +++ /dev/null @@ -1,232 +0,0 @@ -<!DOCTYPE html> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> -<meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=no" /> -<base href="../" /> - -<!-- oktavia --> -<link rel="stylesheet" href="assets/searchstyle.css" type="text/css" /> -<script src="search/jquery-1.9.1.min.js"></script> -<script src="search/oktavia-jquery-ui.js"></script> -<script src="search/oktavia-english-search.js"></script> -<!-- /oktavia --> - -<link rel="stylesheet" href="assets/style.css" type="text/css" /> - -<title>FastCGI Directives - Configure - H2O - the optimized HTTP/2 server</title> -</head> -<body> -<div id="body"> -<div id="top"> - -<h1> -<a href="index.html">H2O</a> -</h1> -<p class="description">the optimized HTTP/1.x, HTTP/2 server</p> - -<!-- oktavia --> -<form id="searchform"> -<input class="search" type="search" name="search" id="search" results="5" value="" placeholder="Search" /> -<div id="searchresult_box"> -<div id="close_search_box">×</div> -<div id="searchresult_summary"></div> -<div id="searchresult"></div> -<div id="searchresult_nav"></div> -<span class="pr">Powered by <a href="https://github.com/shibukawa/oktavia">Oktavia</a></span> -</div> -</form> -<!-- /oktavia --> - -</div> - -<table id="menu"> -<tr> -<td><a href="index.html">Top</a></td> -<td><a href="install.html">Install</a></td> -<td class="selected">Configure</td> -<td><a href="faq.html">FAQ</a></td> -<td><a href="http://blog.kazuhooku.com/search/label/H2O" target="_blank">Blog</a></td> -<td><a href="http://github.com/h2o/h2o/" target="_blank">Source</a></td> -</tr> -</table> - -<div id="main"> - -<h2> -<a href="configure.html">Configure</a> > -FastCGI Directives -</h2> - - -<p> -This document describes the configuration directives of the FastCGI handler. -</p> -<p> -The configuration directives of the FastCGI handler can be categorized into two groups. -<code>Fastcgi.connect</code> and <code>fastcgi.spawn</code> define the address (or the process) to which the requests should be sent. -Other directives customize how the connections to the FastCGI processes should be maintained. -</p> - -<div id="fastcgi.connect" class="directive-head"> -<h3><a href="configure/fastcgi_directives.html#fastcgi.connect"><code>"fastcgi.connect"</code></a></h3> -</div> - -<dl class="directive-desc"> -<dt>Description:</dt> -<dd> -<p> -The directive specifies the address at where the FastCGI daemon is running. -</p> - -<p> -If the argument is a mapping, following properties are recognized. -<dl> -<dt><code>host</code> -<dd>name (or IP address) of the server running the FastCGI daemon (ignored if <code>type</code> is <code>unix</code>) -<dt><code>port</code> -<dd>TCP port number or path to the unix socket -<dt><code>type</code> -<dd>either <code>tcp</code> (default) or <code>unix</code> -</dl> -</p> -<p> -If the argument is a scalar, the value is considered as a TCP port number and the host is assumed to be <code>127.0.0.1</code>. -</p> -<div class="example"> -<div class="caption">Example. Map <code>/app</code> to FastCGI daemon listening to <code>/tmp/fcgi.sock</code></div> -<pre><code>hosts: - "example.com:80": - paths: - "/app": - fastcgi.connect: - port: /tmp/fcgi.sock - type: unix -</code></pre> -</div> - - -</dd> -<dt><a href="configure/syntax_and_structure.html#config_levels">Level</a>:</dt> -<dd>path, extension</dd> -</dl> - -<div id="fastcgi.spawn" class="directive-head"> -<h3><a href="configure/fastcgi_directives.html#fastcgi.spawn"><code>"fastcgi.spawn"</code></a></h3> -</div> - -<dl class="directive-desc"> -<dt>Description:</dt> -<dd> -<p> -The directive specifies the command to start the FastCGI process manager. -</p> - -<p> -In contrast to <code>fastcgi.connect</code> that connects to a FastCGI server running externally, this directive launches a FastCGI process manager under the control of H2O, and terminates it when H2O quits. -The argument is a <code>/bin/sh -c</code> expression to be executed when H2O boots up. -The HTTP server records the process id of the expression, and sends <code>SIGTERM</code> to the id when it exits. -</p> -<div class="example"> -<div class="caption">Example. Map <code>.php</code> files to 10 worker processes of <code>/usr/local/bin/php-cgi</code></div> -<pre><code>file.custom-handler: - extension: .php - fastcgi.spawn: "PHP_FCGI_CHILDREN=10 exec /usr/local/bin/php-cgi" -</code></pre> -</div> - -<p> -As of version 1.4.0, the spawned process is run under the privileges of user specified by the <a href="configure/base_directives.html#user"><code>user</code></a> directive (in version 1.3.x, the FastCGI process was spawned under the privileges that spawned the H2O standalone server). -It is possible to specify a different user for running the FastCGI process, by providing a mapping that contains an attribute named <code>user</code> together with an attribute named <code>command</code>. -</p> -<div class="example"> -<div class="caption">Example. Running FastCGI processes under user <code>fastcgi</code></div> -<pre><code>file.custom-handler: - extension: .php - fastcgi.spawn: - command: "PHP_FCGI_CHILDREN=10 exec /usr/local/bin/php-cgi" - user: fastcgi -</code></pre> -</div> - - -</dd> -<dt><a href="configure/syntax_and_structure.html#config_levels">Level</a>:</dt> -<dd>path, extension</dd> -</dl> - -<div id="fastcgi.timeout.io" class="directive-head"> -<h3><a href="configure/fastcgi_directives.html#fastcgi.timeout.io"><code>"fastcgi.timeout.io"</code></a></h3> -</div> - -<dl class="directive-desc"> -<dt>Description:</dt> -<dd> -<p> -Sets the I/O timeout of connections to the FastCGI process in milliseconds. -</p> - -</dd> -<dt><a href="configure/syntax_and_structure.html#config_levels">Level</a>:</dt> -<dd>global, host, path, extension</dd> -<dt>Default:</dt> -<dd><code><pre>fastcgi.timeout.io: 30000</pre></code> -</dl> - - -<div id="fastcgi.timeout.keepalive" class="directive-head"> -<h3><a href="configure/fastcgi_directives.html#fastcgi.timeout.keepalive"><code>"fastcgi.timeout.keepalive"</code></a></h3> -</div> - -<dl class="directive-desc"> -<dt>Description:</dt> -<dd> -<p> -Sets the keepl-alive timeout for idle connections in milliseconds. -</p> - -<p> -FastCGI connections will not be persistent if the value is set to zero (default). -</p> - -</dd> -<dt><a href="configure/syntax_and_structure.html#config_levels">Level</a>:</dt> -<dd>global, host, path, extension</dd> -<dt>Default:</dt> -<dd><code><pre>fastcgi.timeout.keepalive: 0</pre></code> -</dl> - -<div id="fastcgi.send-delegated-uri" class="directive-head"> -<h3><a href="configure/fastcgi_directives.html#fastcgi.send-delegated-uri"><code>"fastcgi.send-delegated-uri"</code></a></h3> -</div> - -<dl class="directive-desc"> -<dt>Description:</dt> -<dd> -<p> -Send the modified <code>HTTP_HOST</code> and <code>REQUEST_URI</code> being rewritten in case of internal redirect. -</p> - -<p> -In H2O, it is possible to perform internal redirects (a.k.a. delegations or URL rewrites) using <a href="configure/redirect_directives.html">the <code>redirect</code> directive</a> or <a href="configure/reproxy_directives.html">by returning <code>X-Reproxy-URL</code> headers</a> from web applications. -The directive specifies whether to send the original values to the FastCGI process (default), or if the rewritten values should be sent. -</p> - -</dd> -<dt><a href="configure/syntax_and_structure.html#config_levels">Level</a>:</dt> -<dd>global, host, path, extension</dd> -<dt>Default:</dt> -<dd><code><pre>fastcgi.send-delegated-uri: OFF</pre></code> -</dl> - - - - -</div> -<div id="footer"> -<p> -Copyright © 2015 <a href="http://dena.com/intl/">DeNA Co., Ltd.</a> et al. -</p> -</div> -</body> -</html> |