PHP のコードの区切りには、標準 PHP タグを常に使用しなければなりません。
<?php
?>
短いタグは決して使用してはいけません。 PHP コードのみからなるファイルでは、終了タグ ("?>") は決して含めてはいけません (項B.2.1. 「全般」 を参照ください)。
文字列がリテラルである (変数の展開などが含まれない) 場合は、アポストロフィあるいは「シングルクォート」 で文字列を囲まなければなりません。
$a = '文字列の例';
リテラル文字列自体にアポストロフィが含まれている場合は、 引用符あるいは「ダブルクォート」で文字列を囲んでもかまいません。 特に SQL 文などでこのような場合がよくあるでしょう。
$sql = "SELECT `id`, `name` from `people` WHERE `name`='Fred' OR `name`='Susan'";
アポストロフィをエスケープするよりも、上の構文のほうが読みやすくなるのでお勧めです。
変数の展開を行うには、次のような方法を使用します。
$greeting = "こんにちは $name さん。ようこそ!";
$greeting = "こんにちは {$name} さん。ようこそ!";
一貫性を保つため、以下の形式は許可されません。
$greeting = "こんにちは ${name} さん。ようこそ!";
文字列の連結には "." 演算子を使用しなければなりません。コードを読みやすくするため、 "." 演算子の前後には常にスペースを入れなければなりません。
$company = 'Zend' . ' ' . 'Technologies';
文字列を "." 演算子で連結する際には、コードを読みやすくするために ひとつの文を複数行に分けることもできます。そのような場合は、 2 行目以降の行頭にスペースを入れ、各行の "." 演算子が最初の行の "=" 演算子と同じ位置にくるようにしなければなりません。
$sql = "SELECT `id`, `name` FROM `people` "
. "WHERE `name` = 'Susan' "
. "ORDER BY `name` ASC ";
添字として負の数を使用してはいけません。
数値添字の配列の添字は、0 以上の任意の数から始めることができます。 しかし、常に 0 から始めるようにすることを推奨します。
array を使用して数値添字の配列を宣言する場合は、
コードを読みやすくするため、
要素を区切るカンマの後にスペースを入れなければなりません。
$sampleArray = array(1, 2, 3, 'Zend', 'Studio');
"array" を使用して、複数行にまたがる配列を宣言することも可能です。 その場合は、2 行目以降の行頭にスペースを入れ、 各行の開始位置が以下のようになるようにしなければなりません。
$sampleArray = array(1, 2, 3, 'Zend', 'Studio',
$a, $b, $c,
56.44, $d, 500);
クラス宣言は、以下の Zend Framework 命名規約に従わなければなりません。
開始波括弧は常にクラス名の下に書かなければなりません。
PHPDocumentor の標準形式のドキュメントブロックがなければなりません。
クラス内のコードは、すべて空白 4 文字で字下げします。
ひとつの PHP ファイルにはクラス定義をひとつだけ含めるようにします。
クラスファイルの中にクラス以外のコードを追加することもできますが、 お勧めしません。このような場合には、クラス定義とその他のコードの間に 空行を 2 行挿入しなければなりません。
これらの条件を満たすクラス宣言の例です。
/**
* これがドキュメントブロックです
*/
class SampleClass
{
// クラスのすべての内容は、
// 空白 4 文字の字下げを使用します。
}
関数は、以下の Zend Framework 関数命名規約に従わなければなりません。
クラス内でメソッドを宣言する際には、常に
private、protected あるいは
public のいずれかの修飾子を用いてアクセス範囲を指定しなければなりません。
クラスと同様、波括弧は関数名の次の行に書かなければなりません。 関数名と引数定義用の開始括弧の間にはスペースを入れてはいけません。
グローバルスコープの関数は、できるだけ使わないようにしましょう。
クラス内の関数宣言の例として適切なものを次に示します。
/**
* これがドキュメントブロックです
*/
class Foo
{
/**
* これがドキュメントブロックです
*/
public function bar()
{
// 関数のすべての内容は、
// 空白 4 文字の字下げを使用します。
}
}
注意: 値の参照渡しは、メソッドの宣言時にパラメータを渡す部分においてのみ可能です。
/**
* これがドキュメントブロックです
*/
class Foo
{
/**
* これがドキュメントブロックです
*/
public function bar(&$baz)
{}
}
実行時の参照渡しは禁止されています。
返り値は括弧で囲んではいけません。これは可読性を下げますし、 将来そのメソッドが参照を返すようになった場合にコードが壊れてしまいます。
/**
* これがドキュメントブロックです
*/
class Foo
{
/**
* 間違いです
*/
public function bar()
{
return($this->bar);
}
/**
* 正しい形式です
*/
public function bar()
{
return $this->bar;
}
}
関数の引数を指定する際は、引数を区切るカンマの後に空白をひとつ入れます。 例えば 3 つの引数を受け取る関数をコールする場合の例は、 以下のようになります。
threeArguments(1, 2, 3);
コール時に引数を参照渡しすることは禁じます。 関数への引数を参照渡しにする方法は、 関数宣言についての節を参照ください。
引数として配列を受け取る関数については、関数コールの中に "array" 構文を含め、それを複数行に分けることもできます。 そのような場合の記述法は、以下のようになります。
threeArguments(array(1, 2, 3), 2, 3);
threeArguments(array(1, 2, 3, 'Zend', 'Studio',
$a, $b, $c,
56.44, $d, 500), 2, 3);
if および elseif 系の制御構造では、
条件を指定する括弧の前に空白をひとつ入れなければなりません。
また、条件指定の括弧を閉じた後にも空白をひとつ入れなければなりません。
括弧で囲まれた条件文の中では、演算子の前後にも空白をいれなければなりません。 また、条件の論理的な区切りを明確にするため、 条件文の中でも積極的に括弧を使用することを推奨します。
開始波括弧は、条件文と同じ行に記述します。 終了波括弧は、常に改行してそれのみで記述します。 波括弧の中では、空白 4 文字の字下げを使用します。
if ($a != 2) {
$a = 2;
}
"elseif" あるいは "else" を含む "if" 文の場合の決まりは、通常の "if" と同じです。 次の例は、"if" 文に "else" や "elseif" が含まれる場合のものです。
if ($a != 2) {
$a = 2;
} else {
$a = 7;
}
if ($a != 2) {
$a = 2;
} elseif ($a == 3) {
$a = 4;
} else {
$a = 7;
}
場合によっては、これらの文で波括弧が必要ない場合もあります。 しかし、このコーディング規約では、このような例外を認めません。 "if"、"elseif" あるいは "else" 文では、常に波括弧を使用しなければなりません。
"elseif" を使用することは可能ですが、推奨されません。代わりに "else if" を使用してください。
"switch" を使用した制御文では、 条件を指定する括弧の前に空白をひとつ入れなければなりません。 また、条件指定の括弧を閉じた後にも空白をひとつ入れなければなりません。
"switch" 文の中身は、空白 4 文字の字下げを使用します。 各 "case" 文の中身は、さらに 4 文字ぶん字下げします。
switch ($numPeople) {
case 1:
break;
case 2:
break;
default:
break;
}
switch 文の default は、
決して省略してはいけません。
注意: 各 case の最後に
break や return を記述せず、意図的に
次の case に処理を流すという書き方をする場合もあるでしょう。
これらの場合を単なる記述漏れと区別するために、case 文で
break あるいは return を指定しなかった場合は
"// break intentionally omitted" (訳注:「意図的に break を省略しました」)
というコメントを含めるようにします。
ドキュメントブロック ("docblocks") は、phpDocumentor と互換性のある書式でなければなりません。 phpDocumentor の書式については、このドキュメントの対象範囲外です。 詳細な情報は http://phpdoc.org/ を参照ください。
Zend Framework のために書かれたコード、あるいはフレームワーク上で操作するコードは、 各ファイルの最初に「ファイルレベル」の docblock、 そして各クラスの直前に「クラスレベル」の docblock を含めなければなりません。以下に docblock の例を示します。
PHP コードを含むすべてのファイルは、最低限これらの phpDocumentor タグを含むドキュメントブロックを、 ファイルの先頭に記述しなければなりません。
/**
* ファイルについての短い説明
*
* ファイルについての長い説明 (もしあれば)...
*
* LICENSE: ライセンスに関する情報
*
* @copyright 2008 Zend Technologies
* @license http://framework.zend.com/license BSD License
* @version $Id:$
* @link http://framework.zend.com/package/PackageName
* @since File available since Release 1.5.0
*/
各クラスには、最低限これらの phpDocumentor タグを含む docblock が必要です。
/**
* クラスについての短い説明
*
* クラスについての長い説明 (もしあれば)...
*
* @copyright 2008 Zend Technologies
* @license http://framework.zend.com/license BSD License
* @version Release: @package_version@
* @link http://framework.zend.com/package/PackageName
* @since Class available since Release 1.5.0
* @deprecated Class deprecated in Release 2.0.0
*/