Simplifiying the "A simple tutorial" page

php/doc-en@876557a

Author: mumumu

chapters/tutorial.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 1fd637525fd3bbaec04f6fff80eeb33fce880b10 Maintainer: hirokawa Status: ready -->
+<!-- EN-Revision: 876557ae38f6ca5035618f7cea48ca627118b437 Maintainer: hirokawa Status: ready -->
 <!-- CREDITS: shimooka -->
  <chapter xml:id="tutorial" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <title>簡易チュートリアル</title>
@@ -17,61 +17,17 @@
    通常の HTML ページを作成するのと同様の方法で編集することができます。
   </para>
 
-  <sect1 xml:id="tutorial.requirements">
-   <title>必要なものは?</title>
-   <para>
-    本チュートリアルでは、使用するサーバーで PHP が使用可能であり、
-    <filename class="extension">.php</filename> で終わる全てのファイルが PHP
-    で処理されることを仮定します。多くのサーバーでは、PHP
-    ファイルに関してこれがデフォルトの拡張子ですが、
-    確実なのはサーバーの管理者にきいてみることです。サーバーが PHP
-    をサポートする場合、何もする必要はありません。
-    <filename class="extension">.php</filename> ファイルを
-    作成して Web ディレクトリに置くだけで、
-    サーバーがこれを自動的にパースしてくれます。
-    何もコンパイルする必要はなく、他のツールをインストールする必要もありません。
-    PHP のファイルは、あなたが行なう全ての処理を実装した特殊なタグを通常の
-    HTML ファイルに追加したものと考えると良いでしょう。
-   </para>
-   <para>
-    ここでは、貴重なネットワーク帯域を節約するために、
-    ローカルに開発を行うことにしましょう。この場合、
-    <link xlink:href="&url.apache;">Apache</link> のような Web サーバーと、
-    当然、<link xlink:href="&url.php.downloads;">PHP</link>
-    をインストールすることになります。また、多くの場合には、
-    <link xlink:href="&url.mysql.docs;">MySQL</link>
-    のようなデータベースもインストールすることになるでしょう。
-   </para>
-   <para>
-    これらは個別にインストールすることもできますし、
-    より簡単な方法でインストールすることも可能です。
-    このマニュアルには、
-    <link linkend="install">PHP のインストール手順</link>
-    (Web サーバーが設定済みであると仮定しています) があります。
-    PHP 自体をインストールする際に問題が発生した場合、
-    <link xlink:href="&url.php.mailing-lists;">インストールに関する
-     メーリングリスト</link>で質問することをお薦めします。
-    より簡単にインストールを行いたい場合には、
-    使用するオペレーティングシステム用の
-    <link xlink:href="&url.installkits;">設定済みのパッケージ</link>
-    を利用することもできます。これにより、
-    数回のマウスクリックで自動的にこれらをインストールすることができます。
-    MacOSX、Linux や Windows を含む、あらゆるオペレーティングシステムにおいて
-    Web サーバーで PHP を使用できるように設定することは簡単です。
-    Linux の場合、RPM の場所を知るために
-    <link xlink:href="&url.rpmfind;">rpmfind</link> と
-    <link xlink:href="&url.rpmfind.pbone;">PBone</link> が有用でしょう。
-    Debian 用パッケージをみつけるには、<link
-     xlink:href="&url.apt-get;">apt-get</link> にアクセスするとよいでしょう。
-   </para>
-  </sect1>
-
   <sect1 xml:id="tutorial.firstpage">
    <info><title>PHP を使用する初めてのページ</title></info>
+   <simpara>
+    このチュートリアルでは、PHP はインストール済みであることを想定しています。
+    インストール方法については、
+    <link xlink:href="&url.php.downloads;">ダウンロードページ</link>
+    を参照ください。
+   </simpara>
    <para>
     以下の内容で <filename>hello.php</filename>
-    という名前のファイルを作成し、Web サーバーのルートディレクトリ
-    (<varname>DOCUMENT_ROOT</varname>) に置いてください:
+    という名前のファイルを作成してください:
    </para>
    <para>
     <example>
@@ -86,14 +42,24 @@ echo "Hello World!";
 ]]>
      </programlisting>
      <simpara>
-      ブラウザを使用して、<literal>/hello.php</literal> で終わる Web アクセス用 URL を指定し、
+      ターミナルを使い、このファイルがあるディレクトリに移動し、
+      以下のコマンドで開発用のサーバーを起動します:
+     </simpara>
+     <programlisting role="shell">
+<![CDATA[
+php -S localhost:8000
+]]>
+     </programlisting>
+     <simpara>
+      ブラウザを使用して、<literal>/hello.php</literal>
+      で終わる Web アクセス用 URL を指定し、
       このファイルにアクセスしてください。
-      ローカルに開発を行っている場合、この URL は
-      <literal>http://localhost/hello.php</literal> または
-      <literal>http://127.0.0.1/hello.php</literal> のようになります。
-      しかし、これは Web サーバーの設定に依存します。
+      先程のコマンドを実行済みの場合、この URL は
+      <literal>http://localhost:8000/hello.php</literal>
+      のようになります。
       全てが正しく設定されている場合、
-      このファイルは PHP によりパースされ、"Hello World" がブラウザで表示されます。
+      このファイルは PHP によりパースされ、
+      "Hello World" がブラウザで表示されます。
      </simpara>
      <simpara>
       PHP は通常のHTMLの Webページにも埋め込むことができます。
@@ -143,19 +109,7 @@ echo "Hello World!";
     このファイルは、多くの面白いことを可能にする特別なタグを利用できる、
     通常の HTML ファイルと考えることができます。
    </para>
-   <para>
-    この例を試しても何も出力されない場合、または、
-    ダウンロード用のプロンプトが表示されるか、
-    テキストとしてファイル全体が表示された場合、
-    利用しているサーバーで PHP が利用できない可能性があります。本マニュアルの
-    <link linkend="install">インストール</link> の章により
-    PHP を利用できるようにするよう管理者にきいてみてください。
-    ローカルに開発を行っている場合も、
-    インストールの章を読んで設定が全て正しく行われていることを確認してください。
-    解決しない問題がある場合は、多くの
-    <link xlink:href="&url.php.support;">PHP サポート</link>
-    の選択肢のどれかを利用してみてください。
-   </para>
+
    <para>
     この例の目的は、特殊な PHP タグ形式を示すことです。
     この例では、<literal>&lt;?php</literal> が PHP
@@ -218,7 +172,11 @@ echo "Hello World!";
      <title>PHP からシステムに関する情報を取得する</title>
      <programlisting role="php">
 <![CDATA[
-<?php phpinfo(); ?>
+<?php
+
+phpinfo();
+
+?>
 ]]>
      </programlisting>
     </example>
@@ -255,7 +213,9 @@ echo "Hello World!";
     <programlisting role="php">
 <![CDATA[
 <?php
+
 echo $_SERVER['HTTP_USER_AGENT'];
+
 ?>
 ]]>
     </programlisting>
@@ -298,9 +258,11 @@ Mozilla/5.0 (Linux) Firefox/112.0
      <programlisting role="php">
 <![CDATA[
 <?php
+
 if (str_contains($_SERVER['HTTP_USER_AGENT'], 'Firefox')) {
     echo 'あなたはFirefoxを使用しています';
 }
+
 ?>
 ]]>
      </programlisting>