<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/install.unix.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'install.unix.lighttpd-14.php',
    1 => 'Lighttpd 1.4 (Unix システム用)',
    2 => 'Lighttpd 1.4 (Unix システム用)',
  ),
  'up' => 
  array (
    0 => 'install.unix.php',
    1 => 'Unix システムへのインストール',
  ),
  'prev' => 
  array (
    0 => 'install.unix.nginx.php',
    1 => 'Nginx 1.4.x (Unix システム用)',
  ),
  'next' => 
  array (
    0 => 'install.unix.litespeed.php',
    1 => 'LiteSpeed/OpenLiteSpeed Webサーバー(Unixシステム用)',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'install/unix/lighttpd-14.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="install.unix.lighttpd-14" class="sect1">
 <h2 class="title">Lighttpd 1.4 (Unix システム用)</h2>

 <p class="para">
  ここでは、Unix システム上の Lighttpd 1.4
  で PHP を使用する際の注意点とヒントをまとめます。
 </p>

 <p class="para">
  まず <a href="http://trac.lighttpd.net/trac/" class="link external">&raquo;&nbsp;Lighttpd trac</a>
  で Lighttpd のインストール方法をよく読んでからこれ以降に進みましょう。
 </p>
 
 <p class="para">
  PHP と Lighttpd を組み合わせる際におすすめの SAPI は FastCGI です。
  FastCGI は、php-cgi では自動的に有効になります。
 </p>
 
 <div class="sect2" id="install.unix.lighttpd-14.lighttpd-spawn">
  <h3 class="title">Lighttpd に php プロセスを起動させる</h3>

  <p class="para">
   Lighttpd から php に接続して FastCGI
   プロセスを立ち上げさせるように設定するには、
   <var class="filename">lighttpd.conf</var> を編集します。
   ローカルシステムの FastCGI
   プロセスに接続するにはソケットの使用をおすすめします。
  </p>

  <div class="example" id="example-1">
   <p><strong>例1 lighttpd.conf の抜粋</strong></p>
   <div class="example-contents screen">
<div class="cdata"><pre>
server.modules += ( &quot;mod_fastcgi&quot; )

fastcgi.server = ( &quot;.php&quot; =&gt;
  ((
    &quot;socket&quot; =&gt; &quot;/tmp/php.socket&quot;,
    &quot;bin-path&quot; =&gt; &quot;/usr/local/bin/php-cgi&quot;,
    &quot;bin-environment&quot; =&gt; (
      &quot;PHP_FCGI_CHILDREN&quot; =&gt; &quot;16&quot;,
      &quot;PHP_FCGI_MAX_REQUESTS&quot; =&gt; &quot;10000&quot;
    ),
    &quot;min-procs&quot; =&gt; 1,
    &quot;max-procs&quot; =&gt; 1,
    &quot;idle-timeout&quot; =&gt; 20
  ))
)
</pre></div>

   </div>
  </div>

  <p class="para">
   <var class="filename">bin-path</var> ディレクティブにより、lighttpd
   が FastCGI プロセスを動的に起動できるようになります。
   PHP は、環境変数 <var class="envar">PHP_FCGI_CHILDREN</var> の内容に応じて子プロセスを起動します。
   <code class="literal">bin-environment</code> ディレクティブは、起動するプロセスの環境を設定します。
   リクエストの数が <var class="envar">PHP_FCGI_MAX_REQUESTS</var> の値に達すると、
   PHP は子プロセスを kill します。ディレクティブ
   <code class="literal">min-procs</code> および <code class="literal">max-procs</code> は、PHP での使用は避けるべきです。
   PHP は自身の子プロセスを自前で管理しますし、
   APC のような opcode キャッシュは PHP が管理する子プロセスしか共有しません。
   <code class="literal">min-procs</code> を <code class="literal">1</code> より大きい値に設定すると、
   PHP レスポンダの数が <var class="envar">PHP_FCGI_CHILDREN</var> にその値をかけたものとなります
   (2 min-procs * 16 子プロセスで 32 のレスポンダとなります)。
  </p>
 </div>

 <div class="sect2" id="install.unix.lighttpd-14.spawn-fcgi">
  <h3 class="title">spawn-fcgi での起動</h3>  

  <p class="para">
   Lighttpd には spawn-fcgi というプログラムが含まれており、
   FastCGI プロセスの起動を簡単に行えるようになっています。
  </p>
 </div>

 <div class="sect2" id="install.unix.lighttpd-14.spawn-php">
  <h3 class="title">php-cgi の起動</h3>

  <p class="para">
   spawn-fcgi なしでプロセスを起動することもできますが、多少難易度が上がります。
   環境変数 <var class="envar">PHP_FCGI_CHILDREN</var> で、PHP がリクエストの処理用に起動する子の数を設定します。
   <var class="envar">PHP_FCGI_MAX_REQUESTS</var> は、各子プロセスの生存期間 (リクエスト数)
   を設定します。php レスポンダを起動するシンプルな bash スクリプトの例を以下に示します。
  </p>
     
  <div class="example" id="example-2">
   <p><strong>例2 FastCGI レスポンダの起動</strong></p>
   <div class="example-contents screen">
<div class="cdata"><pre>
#!/bin/sh

# php-cgi バイナリの場所
PHP=/usr/local/bin/php-cgi

# PID ファイルの場所
PHP_PID=/tmp/php.pid

# アドレスへのバインド
#FCGI_BIND_ADDRESS=10.0.1.1:10000
# ドメインソケットへのバインド
FCGI_BIND_ADDRESS=/tmp/php.sock

PHP_FCGI_CHILDREN=16
PHP_FCGI_MAX_REQUESTS=10000

env -i PHP_FCGI_CHILDREN=$PHP_FCGI_CHILDREN \
       PHP_FCGI_MAX_REQUESTS=$PHP_FCGI_MAX_REQUESTS \
       $PHP -b $FCGI_BIND_ADDRESS &amp;

echo $! &gt; &quot;$PHP_PID&quot;

</pre></div>
   </div>
  </div>
 </div>

 <div class="sect2" id="install.unix.lighttpd-14.remote-fcgi">
  <h3 class="title">リモートの FCGI インスタンスへの接続</h3>

  <p class="para">
   FastCGI インスタンスを複数のリモートマシンで起動して、
   アプリケーションの規模を拡大することができます。
  </p>
   
  <div class="example" id="example-3">
   <p><strong>例3 リモートの php-fastcgi インスタンスへの接続</strong></p>
   <div class="example-contents screen">
<div class="cdata"><pre>
fastcgi.server = ( &quot;.php&quot; =&gt;
   (( &quot;host&quot; =&gt; &quot;10.0.0.2&quot;, &quot;port&quot; =&gt; 1030 ),
    ( &quot;host&quot; =&gt; &quot;10.0.0.3&quot;, &quot;port&quot; =&gt; 1030 ))
)
</pre></div>
   </div>
  </div>
 </div>
</div><?php manual_footer($setup); ?>