第８章　本書の規約

この書籍では、規約をいくつか使用しています。

コードは２つの空白でインデント

通常、私は４つの空白をインデントで使用していますが、この書籍は様々な電子書籍フォーマットとして利用されるため、小さいスクリーン向きに、横幅を狭くしておくのは重要です。

1 for ($i = 0; $i < 10; $i++)
2 {
3   echo "I can count to ", $i, "\n";
4 }

これはヒントです これは特に便利な情報にハイライトを当てる場合に使用します。

これは警告です これは何か、注意喚起を促す場合に使用しています。

これは情報ブロックです これは重要な情報を繰り返す場合に使用します。

何かを行う場合です この記号があったら、コーディング、もしくは他の行動を実際に行なってください。 指示が書かれています。

?>はタグが開かれている場合に使用しています。

実際のコーディングでは、最後の?>をいつも省略しています。この書籍を書いているエディターでそうしてしまうと、全てがおかしくなってしまうのです。そのため、この本の中ではPHPブロックをPHPタグで開いた場合、毎回確実に閉じています。例えば：

1 <?php
2 class SomethingOrOther {
3     private $dummy;
4 }
5 ?>

PHPの開始タグと終了タグ

コードのサンプルの中で、時々必要がないPHPの開始タグ(<?php)が使用されています。（例えばファイルの一部分を示す場合です。）時々、終了タグ(‘?>’)も不必要ですが、ついています。

1 <?php
2   function somethingOrOther()
3   {
4     $this->callSetup();
5   }
6 ?>

本当のPHPコードでは、私は いつでも ファイルの最後の終了タグを省略しています。タグが必要かどうかは皆さんの判断に委ねています。注意していただきたいのは、サンプルコード中の開始タグと終了タグを記述されたまま、受け取らないでください。

どんなOSを使用しているか？

私はこのマニュアル、コード、その他をDebian、UbuntuベースのLinux Mint 16上で作成しています。これは基本的にはUbuntu 13.10と同じものです。