コーディング規約¶

// 基本レベル
    // レベル1
        // レベル2
    // レベル1
// 基本レベル

$booleanVariable = true;
$stringVariable = '大鹿';
if ($booleanVariable) {
    echo '真偽値は true です';
    if ($stringVariable === '大鹿') {
        echo '大鹿に遭遇しました';
    }
}

$matches = array_intersect_key($this->_listeners,
                array_flip(preg_grep($matchPattern,
                    array_keys($this->_listeners), 0)));

$matches = array_intersect_key(
    $this->_listeners,
    array_flip(
        preg_grep($matchPattern, array_keys($this->_listeners), 0)
    )
);

if ((expr_1) || (expr_2)) {
    // action_1;
} elseif (!(expr_3) && (expr_4)) {
    // action_2;
} else {
    // default_action;
}

// 間違い＝中括弧が無い、ステートメントの場所が悪い
if (expr) statement;

// 間違い＝中括弧が無い
if (expr)
    statement;

// よろしい
if (expr) {
    statement;
}

// 間違い＝インラインの代入
if ($variable = Class::function()) {
    statement;
}

// よろしい
$variable = Class::function();
if ($variable) {
    statement;
}

if ($value === null) {
    // ...
}

// 非推奨
if (null === $this->foo()) {
    // ...
}

// 推奨
if ($this->foo() === null) {
    // ...
}

$var = foo($bar, $bar2, $bar3);

public function someFunction($arg1, $arg2 = '')
{
    if (expr) {
        statement;
    }

    return $var;
}

public function connection($dns, $persistent = false)
{
    if (is_array($dns)) {
        $dnsInfo = $dns;
    } else {
        $dnsInfo = BD::parseDNS($dns);
    }

    if (!($dnsInfo) || !($dnsInfo['phpType'])) {
        return $this->addError();
    }

    return true;
}

public function run(array $data)
{
    ...
    if (!$success) {
        return false;
    }

    ...
}

public function check(array $data)
{
    ...
    if (!$success) {
        throw new RuntimeException(/* ... */);
    }

    ...
}

$email->from('[email protected]')
    ->to('[email protected]')
    ->subject('A great message')
    ->send();

/**
 * タグの例。
 *
 * @author このタグは解析されますが、この @version は無視されます
 * @version 1.0 このタグも解析されます
 */

/**
 * インライン phpDoc タグの例。
 *
 * この関数は世界征服のために foo() を使って身を粉にして働きます。
 *
 * @return void
 */
function bar()
{
}

/**
 * Foo function.
 *
 * @return void
 */
function foo()
{
}

// 間違い = 括弧あり
require_once('ClassFileName.php');
require_once ($class);

// よろしい = 括弧なし
require_once 'ClassFileName.php';
require_once $class;

function manipulate($var)
{
    // 推奨しません。 $var は引数を通じてすでにスコープ内で定義されています。
    if (empty($var)) {
        // ...
    }

    // boolean 型への強制変換を使用。
    if (!$var) {
        // ...
    }
    if ($var) {
        // ...
    }
}

class Thing
{
    private $property; // 定義済み。つまりnullです。

    public function readProperty()
    {
        // issetはnullに対してfalseを返すことを体感的に理解
        // していないエンジニアが多いため、これは推奨しません。
        if (!isset($this->property)) {
            // ...
        }
        // 見た目どおりで分かりやすいため、推奨します。
        if ($this->property === null) {

        }
    }
}

function doWork(array $array)
{
    // empty チェックを避けるためにデフォルト値をマージ
    $array += [
        'key' => null,
    ];

    // 推奨しません。キーはすでにセットされています。
    if (isset($array['key'])) {
        // ...
    }

    // 推奨します。
    if ($array['key'] !== null) {
        // ...
    }
}