nginx.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f0261e36dc250410f352fe33ad4c4e699cb18b02 Maintainer: mumumu Status: ready -->

<sect1 xml:id="install.unix.nginx" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Nginx 1.4.x (Unix システム用)</title>

 <para>
  このドキュメントは、Nginx 1.4.x HTTPサーバー 向けに PHP を
  PHP-FPM とともにインストールし、設定する方法を示します。
 </para>

 <para>
  このガイドは、あなたが Nginx をソースコードからビルドしたことを想定しています。
  よって、すべてのバイナリと設定は 
  <literal>/usr/local/nginx</literal> にあると想定しています。
  仮にこれに当てはまらず、Nginx を他の手段で取得した場合は、
  <link xlink:href="&url.nginx;">Nginx Wiki</link> を参照し、
  このマニュアルをあなたのセットアップに読み替えてください。
 </para>

 <para>
  このガイドは、Nginx サーバーが PHP アプリケーションを実行できるように設定し、
  それを port 80 で公開するための基本的な設定を示します。
  あなたのセットアップを最適化したい場合、Nginx と PHP-FPM のドキュメント
  を調べることを推奨します。セットアップの最適化は、このガイドの範囲外です。
 </para>

 <para>
  このドキュメント全体を通して、バージョン番号は
  ドキュメント全体が将来でも正しく保たれるようにするため、
  'x' で置き換えられている点に注意してください。
  'x' については、必要に応じて対応するバージョン番号に置き換えるようにしてください。
 </para>

 <orderedlist>
  <listitem>
   <para>
    あなたのシステム向けに Nginx を取得し、インストールするために、
    Nginx Wiki の <link xlink:href="&url.nginx.wiki.install;">install</link>
    を参照することを推奨します。
   </para>
  </listitem>

  <listitem>
   <para>
    PHP のソースコードを取得し、展開します。
   </para>

   <informalexample xml:id="install.unix.nginx.extract.php">
    <screen>
<![CDATA[
tar zxf php-x.x.x
]]>
    </screen>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    PHP を configure し、ビルドします。
    ここで PHP を様々なオプションを使ってカスタマイズできます。
    たとえば、どの拡張モジュールを有効にするか、のようなものです。
    利用できるオプションの一覧については、 ./configure --help を
    参照ください。
    私達の例では、PHP-FPM を MySQLi のサポートを有効にして
    シンプルに configure することにします。
   </para>

   <informalexample xml:id="install.unix.nginx.build.php">
    <screen>
<![CDATA[
cd ../php-x.x.x
./configure --enable-fpm --with-mysqli
make
sudo make install
]]>
    </screen>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    設定ファイルを取得し、正しい場所に移動します。
   </para>

   <informalexample xml:id="install.unix.nginx.configure.php">
    <screen>
<![CDATA[
cp php.ini-development /usr/local/php/php.ini
cp /usr/local/etc/php-fpm.d/www.conf.default /usr/local/etc/php-fpm.d/www.conf
cp sapi/fpm/php-fpm /usr/local/bin
]]>
    </screen>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    ファイルが存在しなかったときは、Nginx が PHP-FPM バックエンドに、
    リクエストを渡さないようにし、任意のスクリプトの挿入を防げるようにすることが重要です。
   </para>
   <para>
    php.ini ファイルで、
    <link linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link> 
    ディレクティブを <literal>0</literal> に設定することで、
    この設定を行うことができます。
   </para>
   <para>
    php.ini をエディタで読み込みます:
   </para>

   <informalexample xml:id="install.unix.nginx.configure.ini">
    <screen>
<![CDATA[
vim /usr/local/php/php.ini
]]>
    </screen>
   </informalexample>

   <para>
    <literal>cgi.fix_pathinfo=</literal> の行を探し、以下のように修正します:
   </para>

   <informalexample xml:id="install.unix.nginx.configure.pathinfo">
    <screen>
<![CDATA[
cgi.fix_pathinfo=0
]]>
    </screen>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    サービスを開始する前に、php-fpm が www-data ユーザーと www-data グループで
    必ず実行されるように、php-fpm.conf も修正しなければいけません:
   </para>

   <informalexample xml:id="install.unix.nginx.modify.phpfpm">
    <screen>
<![CDATA[
vim /usr/local/etc/php-fpm.d/www.conf
]]>
    </screen>
   </informalexample>

   <para>
    以下の部分を探し、修正します:
   </para>

   <informalexample xml:id="install.unix.nginx.modify.phpfpm.usergroup">
    <screen>
<![CDATA[
; Unix user/group of processes
; Note: The user is mandatory. If the group is not set, the default user's group
;       will be used.
user = www-data
group = www-data
]]>
    </screen>
   </informalexample>

   <para>
    ここまで来れば、php-fpm サービスを開始できます:
   </para>

   <informalexample xml:id="install.unix.nginx.start.phpfpm">
    <screen>
<![CDATA[
/usr/local/bin/php-fpm
]]>
    </screen>
   </informalexample>

   <para>
    このガイドでは php-fpm をこれ以上設定しませんが、
    php-fpm のさらなる設定に興味がある場合、ドキュメントを参照ください。
   </para>
  </listitem>

  <listitem>
   <para>
    Nginx が PHP アプリケーションの実行をサポートするように設定しなければなりません。
   </para>

   <informalexample xml:id="install.unix.nginx.configure.nginx">
    <programlisting>
<![CDATA[
vim /usr/local/nginx/conf/nginx.conf
]]>
    </programlisting>
   </informalexample>

   <para>
    Nginx が、.php ファイルをサービスすることを認識させるため、
    デフォルトの location ブロックを修正します:
   </para>

   <informalexample xml:id="install.unix.nginx.configure.nginx.location">
    <programlisting role="nginx-conf">
<![CDATA[
location / {
    root   html;
    index  index.php index.html index.htm;
}
]]>
    </programlisting>
   </informalexample>

   <para>
    次のステップは、 .php ファイルへのリクエストが
    PHP-FPM バックエンドに渡されるようにすることです。
    コメントアウトされているデフォルトの PHP location ブロックを
    以下のように修正します:
   </para>

   <informalexample xml:id="install.unix.nginx.configure.nginx.php">
    <programlisting role="nginx-conf">
<![CDATA[
location ~* \.php$ {
    fastcgi_index   index.php;
    fastcgi_pass    127.0.0.1:9000;
    include         fastcgi_params;
    fastcgi_param   SCRIPT_FILENAME    $document_root$fastcgi_script_name;
    fastcgi_param   SCRIPT_NAME        $fastcgi_script_name;
}
]]>
    </programlisting>
   </informalexample>

   <para>
    Nginx を再起動します。
   </para>

   <informalexample xml:id="install.unix.nginx.restart.nginx">
    <screen>
<![CDATA[
sudo /usr/local/nginx/sbin/nginx -s stop
sudo /usr/local/nginx/sbin/nginx
]]>
    </screen>
   </informalexample>
  </listitem>

  <listitem>
   <para>
    テスト用のファイルを作成します。
   </para>

   <informalexample xml:id="install.unix.nginx.test.nginx.php">
    <screen>
<![CDATA[
rm /usr/local/nginx/html/index.html
echo "<?php phpinfo(); ?>" >> /usr/local/nginx/html/index.php
]]>
    </screen>
   </informalexample>

   <para>
    http://localhost にアクセスすれば、 phpinfo() が表示されるはずです。
   </para>
  </listitem>
 </orderedlist>

 <para>
  上のステップに従うことで、
  <literal>FPM</literal> <literal>SAPI</literal> モジュールとして
  PHP をサポートした Nginx Web サーバーを実行できるでしょう。
  もちろん、さらに沢山の設定オプションが Nginx と PHP では利用可能です。
  さらに多くの情報を得るには、対応するソースツリーで、
  <command>./configure --help</command> とタイプしてみてください。
 </para>

</sect1>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->