Modified: phpdoc/ja/trunk/faq/using.xml
===================================================================
--- phpdoc/ja/trunk/faq/using.xml	2009-10-10 03:09:09 UTC (rev 289487)
+++ phpdoc/ja/trunk/faq/using.xml	2009-10-10 05:13:43 UTC (rev 289488)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 289398 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: takagi -->
 <chapter xml:id="faq.using" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>PHP の使いかた</title>
@@ -12,6 +12,28 @@
   </para>

   <qandaset>
+
+   <qandaentry xml:id="faq.using.parameterorder">
+    <question>
+     <para>
+      PHP の関数のパラメータの順番を覚えられません。だって関数によってばらばらなんだもん。
+     </para>
+    </question>
+    <answer>
+     <para>
+      PHP は、さまざまな外部ライブラリの間を取り持つ糊のような存在です。
+      そのため、時にはちょっとごちゃごちゃすることもあります。
+      しかし、経験上、以下のような規則があるようです。
+     </para>
+     <para>
+      <link linkend="book.array">配列関数</link> のパラメータは
+      "<emphasis>needle, haystack</emphasis>" の順だけれども、
+      <link linkend="book.strings">文字列関数</link> はその逆で
+      "<emphasis>haystack, needle</emphasis>" の順となります。
+     </para>
+    </answer>
+   </qandaentry>
+
    <qandaentry xml:id="faq.using.anyform">
     <question>
      <para>
@@ -71,10 +93,13 @@
     </question>
     <answer>
      <para>
-      <function>addslashes</function>がこれを行ってくれます。
-      <function>mysql_escape_string</function>も見てください。
-      <function>stripslashes</function>によって
-      バックスラッシュを除去することもできます。
+      もしデータベースに格納するためにそんなことをしようとしているのなら、
+      データベース自身が持つエスケープの仕組みを使うようにしましょう。
+      MySQL なら <function>mysql_real_escape_string</function>、
+      PostgreSQL なら <function>pg_escape_string</function> などです。
+      汎用的な関数 <function>addslashes</function> や
+      <function>stripslashes</function> もありますが、
+      これはさらに古い時代の PHP コードで使われていたものです。
      </para>

      &note.magicquotes.gpc;
@@ -92,11 +117,12 @@
     </question>
     <answer>
      <para>
-      <function>stripslashes</function>関数によって<type>string</type>から
-      バックスラッシュを取り除くことができます。
-      このような奇妙なバックスラッシュは、ほとんどの場合、PHPの
+      なぜかバックスラッシュがついてしまう、という現象の原因のほとんどは、PHP の
       <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link>
-      ディレクティブがオンになっていることによって付加されています。
+      ディレクティブが On になっていることです。これは古い時代の PHP
+      の機能であり、現在は無効にしておくべきものです。この仕組みに頼ってはいけません。
+      文字列からバックスラッシュを取り除くために、PHP の
+      <function>stripslashes</function> を使うことができます。
      </para>

      &note.magicquotes.gpc;
@@ -320,36 +346,6 @@
     </answer>
    </qandaentry>

-   <qandaentry xml:id="faq.using.netscape">
-    <question>
-     <para>
-      私が書いたPHPスクリプトはIEとLynxでは動作するのですが、Netscapeを
-      使うと出力の一部が失われてしまいます。"ソースの表示"をするとIEには
-      あるがNetscapeにはない内容があります。
-     </para>
-    </question>
-    <answer>
-     <para>
-      NetscapeはHTMLタグの扱いがIEに比べて厳密になっています(テーブル等)。
-      スクリプトが出力したHTMLを<link xlink:href="&url.w3.validator;">
-      validator.w3.org</link>などのHTMLバリデータに掛けてみると良いでしょう。
-      例えば&lt;/table&gt;が無いとこのような現象が発生します。
-     </para>
-     <para>
-      また、IEとLynxは共にHTMLストリーム中のNULL文字(<literal>\0</literal>)を
-      無視しますがNetscapeは無視しません。この問題をチェックする一番の方法
-      は<link linkend="features.commandline">コマンドライン版</link>の
-      PHP(つまりCGIバージョン)をコンパイルして、コマンドラインからその
-      スクリプトを実行することです。*nix上では、その出力を <literal>od
-      -c</literal> にパイプして<literal>\0</literal>があるかどうかを
-      チェックしてください。もしWindowsを使っている場合は、バイナリファ
-      イルを扱えるエディタかそれに類するソフトウェアが必要です。IEや
-      Lynxと異なりNetscapeはNULL文字を見つけるとその行の文字を一切出力
-      しません。
-     </para>
-    </answer>
-   </qandaentry>
-
    <qandaentry xml:id="faq.using.mixml">
     <question>
      <para>
@@ -361,7 +357,7 @@
      <para>
       &lt;?xml を直接PHPコードに埋め込むには、
       PHPディレクティブの<link linkend="ini.short-open-tag">short_tags</link>
-      を0に設定しなければなりません。
+      を <literal>0</literal> に設定しなければなりません。
       このディレクティブは<function>ini_set</function>でセットすることは
       できません。<link linkend="ini.short-open-tag">short_open_tags</link>
       のオン/オフに関わらず、次のようにもできます:
@@ -371,25 +367,6 @@
     </answer>
    </qandaentry>

-   <qandaentry xml:id="faq.using.editor">
-    <question>
-     <para>
-      FrontPageやその他のHTMLエディタを使うと、書いたPHPのコードが勝手
-      にあちこちに移動されてしまいます。どうしたらいいですか？
-     </para>
-    </question>
-    <answer>
-     <para>
-      最も簡単なのはASPタグを使う方法です。こうすればASPの様に&lt;%と
-      %&gt;をコード区切りとして使用することが出来ます。有名なHTMLエディ
-      タは(今のところ)ASPタグを賢く扱ってくれます。ASPスタイルのタグを
-      有効にするには<filename>php.ini</filename>ファイルで<link
-    linkend="ini.asp-tags">asp_tags</link>を設定するか、適切なApacheディレ
-      クティブを使用します。
-     </para>
-    </answer>
-   </qandaentry>
-
    <qandaentry xml:id="faq.using.variables">
     <question>
      <para>

Modified: phpdoc/ja/trunk/install/macos/server.xml
===================================================================
--- phpdoc/ja/trunk/install/macos/server.xml	2009-10-10 03:09:09 UTC (rev 289487)
+++ phpdoc/ja/trunk/install/macos/server.xml	2009-10-10 05:13:43 UTC (rev 289488)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 288791 Maintainer: hirokawa Status: ready -->

  <sect1 xml:id="install.macosx.server" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>Mac OS X サーバ用にコンパイルする</title>
@@ -99,12 +99,12 @@
     </listitem>
     <listitem>
      <simpara>
-      <filename>php.ini-dist</filename> ファイルを PHP4 ソースディレクトリから
+      <filename>php.ini-development</filename> ファイルを PHP4 ソースディレクトリから
       <filename class="directory">bin</filename> ディレクトリにコピーし、
       リネームします。
-      <userinput>cp php.ini-dist /usr/local/bin/php.ini</userinput> 、
+      <userinput>cp php.ini-development /usr/local/bin/php.ini</userinput> 、
       または (local ディレクトリが無い場合)
-      <userinput>cp php.ini-dist /usr/bin/php.ini</userinput> 。
+      <userinput>cp php.ini-development /usr/bin/php.ini</userinput> 。
      </simpara>
     </listitem>
    </orderedlist>

Modified: phpdoc/ja/trunk/install/unix/apache1.xml
===================================================================
--- phpdoc/ja/trunk/install/unix/apache1.xml	2009-10-10 03:09:09 UTC (rev 289487)
+++ phpdoc/ja/trunk/install/unix/apache1.xml	2009-10-10 05:13:43 UTC (rev 289488)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: haruki Status: ready -->
+<!-- EN-Revision: 288791 Maintainer: haruki Status: ready -->
 <!-- Credits: hirokawa, haruki,takagi -->
 <sect1 xml:id="install.unix.apache" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Apache 1.3.x (Unix システム用)</title>
@@ -56,13 +56,13 @@

 13. php.ini ファイルをセットアップ

-      cp php.ini-dist /usr/local/lib/php.ini
+      cp php.ini-development /usr/local/lib/php.ini

     PHP の実行時設定を変更するには、.ini ファイルを編集します。
     このファイルを他の場所に置きたい場合は、手順 10 で、
     オプション --with-config-file-path=/path を使用します。

-    php.ini-dist ではなく、php.ini-recommended を使用する場合は、PHP の
+    php.ini-development ではなく、php.ini-production を使用する場合は、PHP の
     動作が変化しますので、ファイル中に記載されている変更点の一覧を確認する
     ようにしてください。

@@ -144,7 +144,7 @@
     できます。最初のインストールの場合は、この後 "make install" を行います。)

 13. cd ../php-5.x.y
-14. cp php.ini-dist /usr/local/lib/php.ini
+14. cp php.ini-development /usr/local/lib/php.ini

 15. /usr/local/lib/php.ini を編集すると、PHP の実行時設定を変更できます。
     httpd.conf もしくは srm.conf ファイルを編集し、以下を追記します。

Modified: phpdoc/ja/trunk/install/unix/apache2.xml
===================================================================
--- phpdoc/ja/trunk/install/unix/apache2.xml	2009-10-10 03:09:09 UTC (rev 289487)
+++ phpdoc/ja/trunk/install/unix/apache2.xml	2009-10-10 05:13:43 UTC (rev 289488)
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: haruki Status: ready -->
+<!-- EN-Revision: 289213 Maintainer: haruki Status: ready -->
 <!-- Credits: hirokawa, haruki -->
 <sect1 xml:id="install.unix.apache2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>Apache 2.0 (Unixシステム用)</title>
+ <title>Apache 2.x (Unixシステム用)</title>
  <para>
-  このセクションでは、PHPを Unix システム上の Apache 2.0 にインストールする際の
+  このセクションでは、PHPを Unix システム上の Apache 2.x にインストールする際の
   手引きと注意事項について説明します。
  </para>

@@ -13,38 +13,46 @@

  <para>
   <link xlink:href="&url.apache2.docs;">Apache ドキュメンテーション</link>
-  を参照し、Apache 2.0.x の基本的な事項について理解しておくことを
-  強く推奨します。
+  を参照し、Apache 2.x の基本的な事項について理解しておくことを強く推奨します。
+  Apache のインストールオプションについてのより詳しい情報が得られます。
  </para>

  &install.snippet.apache2.compat;

  <para>
-  最新バージョンの <link xlink:href="&url.apache;">Apache 2.0</link> を
-  ダウンロードし、上述のいずれかのバージョンの PHP を用意してください。
-  この手引きでは Apache 2.0 で <literal>PHP</literal> を動作させるための
+  最新バージョンの Apache HTTP Server を
+  <link xlink:href="&url.apache;">Apache ダウンロードサイト</link>
+  からダウンロードし、上述のいずれかのバージョンの PHP を用意してください。
+  この手引きでは Apache 2.x で PHP を動作させるための
   基本的な部分しかカバーしていません。さらに詳しい情報については、<link
   xlink:href="&url.apache2.docs;">Apache ドキュメンテーション</link> を参照してください。
   情報が古く不正確になってしまうため、以下では詳細なバージョン番号は
   記述されていません。'NN' という文字列をご使用のバージョンに適宜置き換えて
   ください。
  </para>
+    <para>
+     現在、Apache 2.x には 2.0 と 2.2 の二種類があります。
+     どちらを選ぶにしてもそれなりの理由があるでしょうが、
+     2.2 が現在の最新版です。もし選択の余地があるのなら
+     2.2 を使うことを推奨します。しかし、この例では 2.0 と 2.2
+     のどちらでも使えるようにしています。
+    </para>
  <example>
   <title>
    インストール手順 (Apache 2 共有モジュール版)
   </title>
   <screen>
 <![CDATA[
-1.  gzip -d httpd-2_0_NN.tar.gz
-2.  tar xvf httpd-2_0_NN.tar
+1.  gzip -d httpd-2_x_NN.tar.gz
+2.  tar xvf httpd-2_x_NN.tar
 3.  gunzip php-NN.tar.gz
 4.  tar -xvf php-NN.tar
-5.  cd httpd-2_0_NN
+5.  cd httpd-2_x_NN
 6.  ./configure --enable-so
 7.  make
 8.  make install

-    以上で Apache 2.0.NN が、モジュールの動的ロードとデフォルトの
+    以上で Apache 2.x.NN が、モジュールの動的ロードとデフォルトの
     MPM（マルチプロセッシングモジュール）である prefork が有効になった
     状態で、/usr/local/apache2 にインストールされます。

@@ -76,13 +84,13 @@

 13. php.ini ファイルを設定する

-      cp php.ini-dist /usr/local/lib/php.ini
+      cp php.ini-development /usr/local/lib/php.ini

     PHP の実行時設定を変更するには、.ini ファイルを編集します。
     このファイルを他の場所に置きたい場合は、手順 10 で、
     オプション --with-config-file-path=/path を使用します。

-    php.ini-dist ではなく、php.ini-recommended を使用する場合は、PHP の
+    php.ini-development ではなく、php.ini-production を使用する場合は、PHP の
     動作が変化しますので、ファイル中に記載されている変更点の一覧を確認する
     ようにしてください。

@@ -91,12 +99,6 @@
     を指している必要があります。上記の make install により既にこの設定は
     追加されている場合もありますが、確認が必要です。

-    PHP 4 の場合:
-
-      LoadModule php4_module modules/libphp4.so
-
-    PHP 5 の場合:
-
       LoadModule php5_module modules/libphp5.so

 15. Apache が特定の拡張子のファイルを PHP としてパースするよう設定します。
@@ -118,12 +120,22 @@
           SetHandler application/x-httpd-php
       </FilesMatch>

-    拡張子 .phps のファイルを PHP ソースファイルとして扱うには、これを追加します。
+    拡張子 .phps のファイルを php ソースフィルタに処理させて
+    構文ハイライトつきのソースコードとして表示させるには、このようにします。

       <FilesMatch "\.phps$">
           SetHandler application/x-httpd-php-source
       </FilesMatch>

+    mod_rewrite を使うと、.phps ファイルに名前を変えたりコピーしたりしなくても
+    任意の .php ファイルを構文ハイライトつきのソースコードとして表示させることができます。
+
+      RewriteEngine On
+      RewriteRule (.*\.php)s$ $1 [H=application/x-httpd-php-source]
+
+    php ソースフィルタは、実運用環境では無効にしておかなければなりません。
+    有効にしてしまうと、ソースコードに埋め込まれた機密情報や重要情報が漏れてしまう危険があります。
+
 16. Apache サーバを、通常の手順通り、起動させます。
       /usr/local/apache2/bin/apachectl start

@@ -140,34 +152,39 @@
     <literal>SAPI</literal> モジュールとして PHP を動作させることができます。もちろん、Apacheと<literal>
     PHP</literal> の双方とも、もっと多くの configure オプションを指定することが出来ます。
     詳しい情報を得るには、ソースツリーディレクトリで <command>./configure
-    --help</command> を実行してください。また、マルチスレッド版の Apache2
-    をビルドする場合は、デフォルトの MPM である <filename>prefork</filename> を
-    <filename>worker</filename> もしくは <filename>perchild</filename> で
-    上書きする必要があります。このためには、上記の手順 6 で<option
-    role="configure">--with-mpm=worker</option> もしくは<option
-    role="configure">--with-mpm=perchild</option> を指定します。マルチスレッド版
-    については、その動作に関して十分注意してください。
-    詳細については Apacheドキュメントの
-    <link xlink:href="&url.apache2.mpm;">マルチプロセッシングモジュール (MPM)</link>
-    を参照してください。
+    --help</command> を実行してください。
  </para>
- <note>
-  <para>
-   コンテントネゴシエーションを使用する場合には、
-   <link linkend="faq.installation.apache.multiviews">
-   Apache の MultiViews オプションに関するFAQ</link> を参照してください。
-  </para>
- </note>
- <note>
-  <para>
-   マルチスレッド版の Apache をビルドする場合は、システムがスレッドを
-   サポートしている必要があります。また、<literal>PHP</literal> は
-   実験的なステータスにある Zend Thread Safety (ZTS) でビルドされます。
-   そのため、使用できない拡張モジュールがあります。デフォルトの<filename>
-   prefork</filename> MPM でのビルドが推奨されます。
-  </para>
- </note>
-</sect1>
+    <para>
+     マルチスレッド版の Apache をビルドするには、Apache のビルド時に標準の
+     <filename>prefork</filename> MPM ではなく <filename>worker</filename> MPM を選択します。
+     そのためには、先ほどの手順 6 のところで ./configure の引数に次のオプションを追加します。
+    </para>
+    <example>
+    <screen>
+     --with-mpm=worker
+    </screen>
+    </example>
+    <para>
+     そうすることで何がどのようになるのかをきちんと認識したうえで、これを行わなければなりません。
+     詳細については Apacheドキュメントの
+     <link xlink:href="&url.apache2.mpm;">マルチプロセッシングモジュール (MPM)</link>
+     を参照してください。
+    </para>
+    <note>
+     <para>
+      <link linkend="faq.installation.apache.multiviews">Apache MultiViews
+      FAQ</link> では、PHP でマルチビューを使う方法について解説しています。
+     </para>
+    </note>
+    <note>
+     <para>
+      マルチスレッド版の Apache をビルドするには、ターゲットシステムがスレッドに対応していなければなりません。
+      その場合は、PHP についても実験的な Zend Thread Safety (ZTS) でビルドしなければなりません。
+      この構成では使用できない拡張モジュールもあります。推奨される方法は、Apache をデフォルトの
+      <filename>prefork</filename> MPM モジュールでビルドすることです。
+     </para>
+    </note>
+   </sect1>

 <!-- Keep this comment at the end of the file
 Local variables: