PHP 編碼規範（十一）：簡單語句、復合語句與返回語句格式化細則

簡單語句：每行一條

<?php
// 正確
$argv++;
$argc--;

// 錯誤：同行多語句
$argv++; $argc--;  // ❌

復合語句 (大括號塊) 格式

• 左大括號 { 位於**首行行尾**，前方一空格
• 右大括號 } **獨佔一行**，與復合語句首行關鍵字左對齊
• 塊內語句**縮進一級** (4 空格)
• 所有 控制結構 (if、else、for、foreach、while、switch、try、catch) **必須使用大括號**，即使只有一條語句

<?php
if ($condition) {
    doSomething();
    doAnother();
}

foreach ($items as $item) {
    process($item);
}

// 即使單行也要加括號
if ($flag) {
    return true;
}

返回語句格式

• 不使用括號 包裹返回值，除非為了明確優先級或可讀性
• return; 空返回不加任何內容
• 三元運算返回可保留括號以明確範圍

<?php
return;
return $user->getName();
return $this->calculateTotal($items);
return ($size !== null ? $size : $defaultSize); // 括號明確三元範圍
return [
    'status' => 'ok',
    'data' => $data,
];

控制結構大括號強制性理由

1. 防止後期添加語句時忘記補齊大括號引入 Bug
2. 統一視覺結構，降低認知負荷
3. 靜態分析工具 (PHPStan/Psalm) 可檢測缺失大括號

Switch 語句大括號

<?php
switch ($status) {
    case self::PENDING:
        $label = '待處理';
        break;
    case self::APPROVED:
        $label = '已通過';
        break;
    default:
        $label = '未知';
        break;
}